翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CreateLogicallyAirGappedBackupVault
このリクエストにより、バックアップをコピーできる論理コンテナが作成されます。
このリクエストには、名前、リージョン、最大保持日数、最小保持日数が含まれます。また、オプションでタグと作成者リクエスト ID を含めることができます。
注記
パスポート番号などの機密データは、バックアップボールトの名前に含めないでください。
リクエストの構文
PUT /logically-air-gapped-backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"MaxRetentionDays": number,
"MinRetentionDays": number
}URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- backupVaultName
-
これは作成中のボールトの名前です。
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- BackupVaultTags
-
これらは新しく作成されるボールトに含まれるタグです。
型: 文字列間のマッピング
必須: いいえ
- CreatorRequestId
-
これは作成リクエストの ID です。
このパラメータはオプションです。使用する場合、このパラメータには 1～50 文字の英数字または「-_」を含める必要があります 。
タイプ: 文字列
必須: いいえ
- MaxRetentionDays
-
これは、ボールトが復旧ポイントを保持する最大保持期間を指定する設定です。このパラメータを指定しない場合、 AWS Backup はボールト内の復旧ポイントに最大保持期間を強制しません (無期限ストレージを許可)。
指定した場合、ボールトへのバックアップジョブもしくはコピージョブには、保存期間が最大保存期間と同等もしくは以下のライフサイクル・ポリシーを持つ必要があります。ジョブの保持期間がその最大保持期間よりも長い場合、ボールトはバックアップジョブもしくはコピージョブに失敗するため、ライフサイクル設定を変更するか、別のボールトを使用する必要があります。
タイプ: Long
必須: はい
- MinRetentionDays
-
この設定は、ボールトが復旧ポイントを保持する最小保持期間を指定します。このパラメータを指定しない場合、最小保持期間が強制されません。
指定した場合、ボールトへのバックアップジョブまたはコピージョブには、最小保存期間以上の保存期間を持つライフサイクルポリシーが必要です。ジョブの保持期間がその最小保持期間より短い場合、ボールトはバックアップジョブまたはコピージョブに失敗するため、ライフサイクル設定を変更するか、別のボールトを使用する必要があります。
タイプ: Long
必須: はい
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- BackupVaultArn
-
これは、作成中のボールトの ARN (Amazon リソースネーム) です。
型: 文字列
- BackupVaultName
-
バックアップを保存する論理コンテナの名前。論理的にエアギャップのあるバックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先のリージョンに一意の名前で識別されます。それらは、小文字の英文字、数字、およびハイフン (-) で構成されます。
型: 文字列
パターン：
^[a-zA-Z0-9\-\_]{2,50}$ - CreationDate
-
ボールドが作成された日時。
この値は、Unix 形式、協定世界時 (UTC) 、ミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。
型: タイムスタンプ
- VaultState
-
これはボールトの現在の状態を示します。
型: 文字列
有効な値：
CREATING | AVAILABLE | FAILED
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AlreadyExistsException
-
必要なリソースは既に存在します。
HTTP ステータスコード：400
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード：400
- InvalidRequestException
-
リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。
HTTP ステータスコード：400
- LimitExceededException
-
たとえば、リクエストで許可されるアイテムの最大数などのリクエストの制限を超えました。
HTTP ステータスコード：400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード：400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード：500
その他の参照資料
言語固有の AWS SDK でこの API を使用する方法の詳細については、以下を参照してください。
