翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CreateBackupVault
バックアップを保存する論理コンテナを作成します。CreateBackupVault リクエストは、名前、1 つ以上のリソースタグ (省略可能)、暗号化キー、およびリクエスト ID を含みます。
注記
パスポート番号などの機密データは、バックアップボールトの名前に含めないでください。
リクエストの構文
PUT /backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"EncryptionKeyArn": "string"
}URI リクエストパラメータ
リクエストは、次のURIパラメータを使用します。
- backupVaultName
-
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の AWS リージョンに一意の名前で識別されます。それらは文字、数字、およびハイフン (-) で構成されます。
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$必須: はい
リクエストボディ
リクエストは、次のJSON形式のデータを受け入れます。
- BackupVaultTags
-
バックアップボールトに割り当てるタグ。
型: 文字列間のマッピング
必須：いいえ
- CreatorRequestId
-
リクエストを識別するための一意の文字列で、失敗したリクエストを再試行する際に、オペレーションを2回実行するリスクを回避することができます。このパラメータはオプションです。
使用する場合、このパラメータには 1～50 文字の英数字または「-_」を含める必要があります 。
型: 文字列
必須: いいえ
- EncryptionKeyArn
-
たとえば、
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890abなどのバックアップを保護するために使用されるサーバー側の暗号化キーです。型: 文字列
必須: いいえ
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number
}レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって JSON 形式で返されます。
- BackupVaultArn
-
バックアップボールトを一意に識別する Amazon リソースネーム (ARN）。例:
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault。型: 文字列
- BackupVaultName
-
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の リージョンに一意の名前で識別されます。それらは、小文字の英文字、数字、およびハイフン (-) で構成されます。
型: 文字列
パターン:
^[a-zA-Z0-9\-\_]{2,50}$ - CreationDate
-
Unix 形式と協定世界時 () でバックアップボールトが作成された日時UTC。
CreationDateの値は、ミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。型: タイムスタンプ
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AlreadyExistsException
-
必要なリソースは既に存在します。
HTTP ステータスコード: 400
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード: 400
- LimitExceededException
-
たとえば、リクエストで許可されるアイテムの最大数などのリクエストの制限を超えました。
HTTP ステータスコード: 400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード: 400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード: 500
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
