カスタマーマスターキー (CMK) のバージョンを作成します。
操作説明
バージョンを作成できるのは、有効状態の非対称 CMK のみです。CreateKey 操作を呼び出して非対称 CMK を作成し、DescribeKey 操作を呼び出して CMK のステータスをクエリできます。ステータスは KeyState パラメーターで指定されます。
同じ CMK のバージョンを作成する最小間隔は 7 日間です。DescribeKey 操作を呼び出して、CMK の最後のバージョンが作成された時刻をクエリできます。時刻は LastRotationDate パラメーターで指定されます。
CMK が専用キーストアにある場合、その CMK のバージョンは作成できません。
同じリージョン内の CMK に対して、最大 50 個のバージョンを作成できます。
このトピックで提供されているパラメーター設定を使用して、ID が 0b30658a-ed1a-4922-b8f7-a673ca9c**** の CMK のバージョンを作成できます。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| KeyId |
string |
必須 |
CMK の ID。ID はグローバルに一意である必要があります。 説明
CMK にバインドされているエイリアスに値を設定することもできます。詳細については、「エイリアスの概要」をご参照ください。 |
0b30658a-ed1a-4922-b8f7-a673ca9c**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエストの ID。 |
b96f250a-4b75-498c-91be-22c6928f85be |
| KeyVersion |
object |
バージョンのメタデータ。 |
|
| KeyId |
string |
CMK の ID。ID はグローバルに一意である必要があります。 |
0b30658a-ed1a-4922-b8f7-a673ca9c**** |
| KeyVersionId |
string |
バージョンの ID。 |
c0a3d5dc-0b47-4199-a050-b289349a**** |
| CreationDate |
string |
バージョンが作成された日時。時刻は UTC で表示されます。 |
2019-08-02T10:38:27Z |
例
成功レスポンス
JSONJSON
{
"RequestId": "b96f250a-4b75-498c-91be-22c6928f85be",
"KeyVersion": {
"KeyId": "0b30658a-ed1a-4922-b8f7-a673ca9c****",
"KeyVersionId": "c0a3d5dc-0b47-4199-a050-b289349a****",
"CreationDate": "2019-08-02T10:38:27Z"
}
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | Rejected.UnsupportedOperation | Unsupported operation. | |
| 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.Unavailable | The request was rejected because the key state is Unavailable. | |
| 409 | Rejected.PendingDeletion | The request was rejected because the key state is PendingDeletion. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。