- Print
- PDF
Decrypt
- Print
- PDF
Available in Classic and VPC
Decrypt the ciphertext encrypted with a key. It can only be requested as an AES256 or RSA2048 key type.
The data encrypted with the master key and returned consists of KMS prefix + ciphertext
. The KMS prefix is composed of ncpkms:version information
, and it must be specified exactly with the ciphertext because it will be decrypted with the key version specified in the decryption request. If the KMS prefix is incorrect, it will not be decrypted correctly, so be sure to manage the encryption in the form it is returned, with no arbitrary removals or manipulations.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
POST |
|
Request headers
For information about the headers common to all Key Management Service APIs, see Key Management Service request headers.
Request path parameters
You can use the following path parameters with your request:
Field | Type | Required | Description |
---|---|---|---|
keyTag | String | Required | Key tag
|
Request body
You can include the following data in the body of your request:
Field | Type | Required | Description |
---|---|---|---|
ciphertext | String or Array<String> | Required | String data created by encrypting a plaintext |
context | String | Conditional | Base64-encoded string data
|
Request example
The request example is as follows:
- Request API Gateway request signature v1 and
ciphertext
as String type
- Request API Gateway request signature v and
ciphertext
as Array<String> type
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
code | String | - | Success or Failure |
msg | String | - | Description of the response code (code )SUCCESS ) |
data | Object | - | Response result |
data.plaintext | String or Array<String> | - | Decrypted string data
|
Response status codes
For response status codes common to all Key Management Service APIs, see Key Management Service response status codes.
Response example
The response example is as follows:
- Request
ciphertext
as String type
- Request
ciphertext
as Array<String> type