顧客マスターキー (CMK) のバージョンを作成します。

制限事項

  • 有効状態の非対称CMKに対してのみバージョンを作成できます。 CreateKey操作を呼び出して非対称CMKを作成し、DescribeKey操作を呼び出してCMKのステータスを照会できます。 ステータスはKeyStateパラメーターで指定します。
  • 同じCMKのバージョンを作成するための最小間隔は7日です。 DescribeKey操作を呼び出して、CMKの最後のバージョンが作成された時刻を照会できます。 時刻はLastRotationDateパラメーターで指定します。
  • CMKが秘密鍵ストアにある場合、CMKのバージョンを作成することはできません。
  • 同じリージョンでCMKに最大50のバージョンを作成できます。

このトピックで提供されているパラメーター設定を使用して、IDが0b30658a-ed1a-4922-b8f7-a673ca9c **** のCMKのバージョンを作成できます。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 CreateKeyVersion

実行する操作です。 値をCreateKeyVersionに設定します。

KeyId String 必須 0b30658a-ed1a-4922-b8f7-a673ca9c ****

CMKのID。 IDはグローバルに一意である必要があります。

注 CMKにバインドされているエイリアスに値を設定することもできます。 詳細については、「エイリアスの概要」をご参照ください。

レスポンスパラメーター

パラメーター データ型 例 説明
KeyVersion Struct

バージョンのメタデータ。

CreationDate String 2019-08-02T10:38:27Z

バージョンが作成された日時。 時刻は UTC 表示です。

KeyId String 0b30658a-ed1a-4922-b8f7-a673ca9c ****

CMKのID。 IDはグローバルに一意である必要があります。

KeyVersionId String c0a3d5dc-0b47-4199-a050-b289349a ****

バージョンのID。

RequestId String b96f250a-4b75-498c-91be-22c6928f85be

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=CreateKeyVersion
&KeyId=0b30658a-ed1a-4922-b8f7-a673ca9c ****
&<共通リクエストパラメーター>

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

XML 形式 

<KMS>
    <KeyVersion>
        <KeyId>0b30658a-ed1a-4922-b8f7-a673ca9c ****</KeyId>
        <KeyVersionId>c0a3d5dc-0b47-4199-a050-b289349a ****</KeyVersionId>
        <CreationDate>2019-08-02T10:38:27Z</CreationDate>
    </KeyVersion>
    <RequestId>b96f250a-4b75-498c-91be-22c6928f85be</RequestId>
</KMS>

JSON 形式 

{
        "KeyVersion": {
                "KeyId": "0b30658a-ed1a-4922-b8f7-a673ca9c ****" 、
                "KeyVersionId": "c0a3d5dc-0b47-4199-a050-b289349a ****" 、
                "CreationDate": "2019-08-02T10:38:27Z"
        },
        "RequestId": "b96f250a-4b75-498c-91be-22c6928f85be"
}

エラーコード

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