ImportKeyMaterial - - Alibaba Cloud ドキュメントセンター

ImportKeyMaterial操作を呼び出して、キーマテリアルをインポートします。

CreateKeyを呼び出します。CMKの作成時に、そのキーマテリアルソースを外部として選択できます。OriginをEXTERNALに設定します。このAPIは、キーマテリアルをCMKにインポートするために使用されます。

CMK Originを表示するには、DescribeKeyをご参照ください。
キーマテリアルをインポートする前に、GetParametersForImportを呼び出す必要があります。

説明

Aliyun_AES_256キーマテリアルは256ビットでなければなりません。キータイプはAliyun_SM4である必要があります。CMKとキーマテリアルは128ビットである必要があります。
キーマテリアルの有効期限を設定することも、有効期限が切れないように設定することもできます。
キーマテリアルを再インポートし、指定したCMKの有効期限をいつでもリセットできますが、同じキーマテリアルをインポートする必要があります。
インポートされたキーマテリアルが期限切れまたは削除された後、同じキーマテリアルが再びインポートされるまで、指定されたCMKは使用できません。
キーマテリアルは複数のcmksにインポートできますが、あるCMKで暗号化されたデータまたはデータキーは別のCMKでは復号できません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	データ型	必須／任意	例	説明
アクション	String	必須	ImportKeyMaterial	実行したい操作。値をImportKeyMaterialに設定します。
EncryptedKeyMaterial	String	必須	bCPZx7I6v6KXsqEpr2OXKxuj2CCRtKdwp75Bw + BGncYqBdfjFBYRtOE6HRlT0oeiRDWzwnw9OA54OL36smDJrq4Lo9x0CyYDiuKnRkcKtMtlzW0din7Pd7IlZWWRdVueiw2qpzl7PkUWQGTdsdbzpfJJQ + qj/cRIrk/E83UGyeyytSpgnb + lu0xEYcPajRyWNsbi98N3pqqQzHXNNHO2NJqHlnQgglqTiBEjkGeKFhfKmTc3vjulIdVa3EaVIN6lwWfgx + UUYSrvbA77WDYKlDsZ4SbK2/T7za9Tp1qU7Ynqba7OKGVVj7PMbiaO80AxWZnjUMYCgEp5w7V + seOXqw==	GetParametersForImportを使用します。Returned public key and the base64-encoded key material.
ImportToken	String	必須	Base64String	GetParametersForImportを呼び出します。
KeyId	String	必須	1234abcd-12ab-34cd-56ef-12345678 ****	インポートするCMKのID。
KeyMaterialExpireUnix	Long	必須	0	キーマテリアルの有効期限が切れる時刻。このパラメーターが指定されていない場合、またはこのパラメーターを0に設定した場合、キーマテリアルは期限切れになりません。説明値は、APIが呼び出された時刻より前にすることはできません (サーバー時刻に基づいて) 。

レスポンスパラメーター

プラメーター	データ型	レスポンスの例	説明
RequestId	String	ec1017 cf-ead4-f3ca-babc-c3b34f3dbecb	リクエストの ID です。

例

リクエストの例

https:// [エンドポイント]/? アクション=ImportKeyMaterial
&EncryptedKeyMaterial=bCPZx7I6v6KXsqEpr2OXKxuj2CCRtKdwp75Bw + BGncYqBdfjFBYRtOE6HRlT0oeiRDWzwnw9OA54OL36smDJrq4Lo9x0CyYDiuKnRkcKtMtlzW0din7Pd7IlZWWRdVueiw2qpzl7PkUWQGTdsdbzpfJJQ + qj/cRIrk/E83UGyeyytSpgnb + lu0xEYcPajRyWNsbi98N3pqqQzHXNNHO2NJqHlnQgglqTiBEjkGeKFhfKmTc3vjulIdVa3EaVIN6lwWfgx + UUYSrvbA77WDYKlDsZ4SbK2/T7za9Tp1qU7Ynqba7OKGVVj7PMbiaO80AxWZnjUMYCgEp5w7V + seOXqw==
&ImportToken=Base64String
&KeyId=1234abcd-12ab-34cd-56ef-12345678 ****
&KeyMaterialExpireUnix=0
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<KMS>
    <RequestId>ec1017cf-ead4-f3ca-babc-c3b34f3dbecb</RequestId>
</KMS>

JSON 形式

{
        "RequestId":"ec1017cf-ead4-f3ca-babc-c3b34f3dbecb"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。