暗号文を復号します。
操作説明
注意事項
-
この API オペレーションの呼び出しに必要な RAM (Resource Access Management) ユーザーまたは RAM ロールへのアクセスポリシーの付与の詳細については、「アクセスの制御」を参照してください。
-
この API オペレーションは、共有ゲートウェイまたは専用ゲートウェイを通じて呼び出すことができます。詳細については、「Alibaba Cloud SDK」を参照してください。
共有ゲートウェイ: インターネットまたは VPC エンドポイント経由で KMS にアクセスします。インターネットアクセスを有効にする必要があります。詳細については、「インターネット経由での KMS インスタンスのアクセスキー」を参照してください。
専用ゲートウェイ: KMS プライベートエンドポイント (
<YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com) 経由で KMS にアクセスします。
QPS 制限
共有ゲートウェイ: この API オペレーションのユーザーあたりの QPS 制限は、1 秒あたり 1,000 リクエストです。制限を超えると、API の呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。適切なレートで API を呼び出してください。
専用ゲートウェイ: この API オペレーションのユーザーあたりの QPS 制限は、KMS インスタンスのコンピューティングパフォーマンス仕様によって異なります。詳細については、「パフォーマンスデータ」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
kms:Decrypt |
get |
*Key。
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| CiphertextBlob |
string |
必須 |
復号する暗号文。 |
DZhOWVmZDktM2QxNi00ODk0LWJkNGYtMWZjNDNmM2YyYWJmaaSl+TztSIMe43nbTH/Z1Wr4XfLftKhAciUmDQXuMRl4WTvKhxjMThjK**** |
| EncryptionContext |
object |
任意 |
キーと値のペアの JSON 文字列。 説明
暗号化するために GenerateDataKey 、 Encrypt 、または GenerateDataKeyWithoutPlaintext API オペレーションの呼び出し時に EncryptionContext を指定した場合、復号時にも同じパラメーターを指定する必要があります。詳細については、「EncryptionContext の説明」を参照してください。 |
{"Example":"Example"} |
| DryRun |
string |
任意 |
ドライランモードを有効にするかどうかを指定します。 有効な値:
ドライランモードは、API の呼び出しをテストし、リソースに対する必須の権限があるかどうかを確認し、リクエストパラメーターが正しく設定されているかどうかをチェックするために使用されます。ドライランモードが有効な場合、KMS は常に失敗を返し、失敗の原因を提供します。原因には以下が含まれます。
|
false |
| Recipient |
string |
任意 |
信頼された環境の認証情報。
AttestationDocument のコンテンツ構造:
|
{ "AttestationDocument":"base64-encoded-attestion-document", "KeyEncryptionAlgorithm":"RSAES_OAEP_SHA_256" } |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| KeyVersionId |
string |
マスターキーの下で暗号文を復号するために使用されるキーバージョンの識別子。 |
2ab1a983-7072-4bbc-a582-584b5bd8**** |
| KeyId |
string |
暗号文を復号するために使用されるマスターキーの ID。 |
202b9877-5a25-46e3-a763-e20791b5**** |
| RequestId |
string |
リクエストの ID。Alibaba Cloud によってリクエスト用に生成される一意識別子であり、トラブルシューティングに使用できます。 |
207596a2-36d3-4840-b1bd-f87044699bd7 |
| Plaintext |
string |
復号されたプレーンテキスト。 |
tRYXuCwgja12xxO1N/gZERDDCLw9doZEQiPDk/Bv**** |
| CiphertextForRecipient |
string |
Recipient が渡された場合、プレーンテキストデータキーは Recipient の extendUserData 内の pubkey を使用して暗号化され、Base64 でエンコーディングされます。 重要 このパラメーターは、専用ゲートウェイを通じて API オペレーションを呼び出す場合にのみ効果があります。 |
NIahY6pgjK4ZMP2R0EmsmBqntrv0AI2rcDyU7Su6uOT9Le7EOvlCpjHJfr9z3M0vkfulQoyuETmKSpYDfixE3auE4MwxloT6D9Gfsk6hm5FV2iAxL//Ms2kLv6K4z6yGi7lKm2yjX4***== |
例
成功レスポンス
JSONJSON
{
"KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
"KeyId": "202b9877-5a25-46e3-a763-e20791b5****",
"RequestId": "207596a2-36d3-4840-b1bd-f87044699bd7",
"Plaintext": "tRYXuCwgja12xxO1N/gZERDDCLw9doZEQiPDk/Bv****",
"CiphertextForRecipient": "NIahY6pgjK4ZMP2R0EmsmBqntrv0AI2rcDyU7Su6uOT9Le7EOvlCpjHJfr9z3M0vkfulQoyuETmKSpYDfixE3auE4MwxloT6D9Gfsk6hm5FV2iAxL//Ms2kLv6K4z6yGi7lKm2yjX4***==\n"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | UnsupportedOperation | This action is not supported. | |
| 404 | Forbidden.AliasNotFound | The specified Alias is not found. | |
| 404 | Forbidden.KeyNotFound | The specified Key is not found. | |
| 409 | Rejected.Disabled | The request was rejected because the key state is Disabled. | |
| 409 | Rejected.PendingDeletion | The request was rejected because the key state is PendingDeletion. | |
| 409 | Rejected.Unavailable | The request was rejected because the key state is Unavailable. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。