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

# CreateTieringConfiguration
<a name="API_CreateTieringConfiguration"></a>

階層化設定を作成します。

階層設定を使用すると、バックアップボールト内のバックアップオブジェクトの経過時間に基づいて、バックアップデータを低コストのストレージ階層に自動的に移動できます。

各ボールトは、すべてのボールトに適用されるグローバル設定に加えて、ボールト固有の階層設定を 1 つだけ持つことができます。

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

```
PUT /tiering-configurations HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ],
      "TieringConfigurationName": "string"
   },
   "TieringConfigurationTags": { 
      "string" : "string" 
   }
}
```

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

リクエストでは URI パラメータを使用しません。

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

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

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

 ** [TieringConfiguration](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfiguration"></a>
階層設定には、作成する一意の`TieringConfigurationName`文字列が含まれ、 `BackupVaultName`と が含まれている必要があります`ResourceSelection`。オプションで`CreatorRequestId`文字列を含めることができます。  
`TieringConfigurationName` は、階層設定の名前である一意の文字列です。これは作成後に変更できず、英数字とアンダースコアのみで構成されている必要があります。  
型: [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md) オブジェクト  
必須: はい

 ** [TieringConfigurationTags](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfigurationTags"></a>
階層設定に割り当てるタグ。  
タイプ: 文字列間のマッピング  
必須: いいえ

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

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

{
   "CreationTime": number,
   "TieringConfigurationArn": "string",
   "TieringConfigurationName": "string"
}
```

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

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

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

 ** [CreationTime](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-CreationTime"></a>
階層化設定が作成された日時。Unix 形式および協定世界時 (UTC)。`CreationTime` の値は、ミリ秒単位の精度です。例えば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前 12:11:30.087 を表します。  
タイプ: タイムスタンプ

 ** [TieringConfigurationArn](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationArn"></a>
作成された階層設定を一意に識別する Amazon リソースネーム (ARN)。  
タイプ: 文字列

 ** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationName"></a>
この一意の文字列は、階層化設定の名前です。  
作成後にこの名前を変更することはできません。名前には英数字とアンダースコアのみを使用できます。最大長は 200 です。  
タイプ: 文字列

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

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

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

HTTP ステータスコード: 400

 ** ConflictException **   
 AWS Backup は、前のアクションの実行が完了するまで、リクエストしたアクションを実行できません。後でもう一度お試しください。    
 ** Context **   
  
 ** 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_CreateTieringConfiguration_SeeAlso"></a>

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