翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CreateBackupVault
<a name="API_CreateBackupVault"></a>

バックアップを保存する論理コンテナを作成します。`CreateBackupVault` リクエストは、名前、1 つ以上のリソースタグ (省略可能)、暗号化キー、およびリクエスト ID を含みます。

**注記**  
パスポート番号などの機密データは、バックアップボールトの名前に含めないでください。

## リクエストの構文
<a name="API_CreateBackupVault_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json

{
   "BackupVaultTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string",
   "EncryptionKeyArn": "string"
}
```

## URI リクエストパラメータ
<a name="API_CreateBackupVault_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [backupVaultName](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-uri-BackupVaultName"></a>
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の AWS リージョンに一意の名前で識別されます。それらは文字、数字、およびハイフン (-) で構成されます。  
パターン: `^[a-zA-Z0-9\-\_]{2,50}$`   
必須: はい

## リクエストボディ
<a name="API_CreateBackupVault_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [BackupVaultTags](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-BackupVaultTags"></a>
バックアップボールトに割り当てるタグ。  
タイプ: 文字列間のマッピング  
必須: いいえ

 ** [CreatorRequestId](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-CreatorRequestId"></a>
リクエストを識別するための一意の文字列で、失敗したリクエストを再試行する際に、オペレーションを2回実行するリスクを回避することができます。このパラメータはオプションです。  
使用する場合、このパラメータには 1～50 文字の英数字または「-\$1」を含める必要があります 。  
タイプ: 文字列  
必須: いいえ

 ** [EncryptionKeyArn](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-EncryptionKeyArn"></a>
たとえば、`arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` などのバックアップを保護するために使用されるサーバー側の暗号化キーです。  
型: 文字列  
必須: いいえ

## レスポンスの構文
<a name="API_CreateBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CreationDate": number
}
```

## レスポンス要素
<a name="API_CreateBackupVault_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [BackupVaultArn](#API_CreateBackupVault_ResponseSyntax) **   <a name="Backup-CreateBackupVault-response-BackupVaultArn"></a>
`arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`などのバックアップボールトを一意に識別する Amazon リソースネーム (ARN)。  
タイプ: 文字列

 ** [BackupVaultName](#API_CreateBackupVault_ResponseSyntax) **   <a name="Backup-CreateBackupVault-response-BackupVaultName"></a>
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の リージョンに一意の名前で識別されます。それらは、小文字の英文字、数字、およびハイフン (-) で構成されます。  
タイプ: 文字列  
パターン: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [CreationDate](#API_CreateBackupVault_ResponseSyntax) **   <a name="Backup-CreateBackupVault-response-CreationDate"></a>
Unix 時刻形式および協定世界時 (UTC）でバックアップボールトが作成された日付と時刻。`CreationDate`の値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。  
タイプ: タイムスタンプ

## エラー
<a name="API_CreateBackupVault_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** AlreadyExistsException **   
必要なリソースは既に存在します。    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** InvalidParameterValueException **   
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** LimitExceededException **   
たとえば、リクエストで許可されるアイテムの最大数などのリクエストの制限を超えました。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** MissingParameterValueException **   
必須パラメータがないことを示します。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** ServiceUnavailableException **   
サーバーの一時的障害のため、リクエストは失敗しました。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 500

## その他の参照資料
<a name="API_CreateBackupVault_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupVault)