翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CreateTieringConfiguration
階層化設定を作成します。
階層設定を使用すると、バックアップボールト内のバックアップオブジェクトの経過時間に基づいて、バックアップデータを低コストのストレージ階層に自動的に移動できます。
各ボールトは、すべてのボールトに適用されるグローバル設定に加えて、ボールト固有の階層設定を 1 つだけ持つことができます。
リクエストの構文
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 リクエストパラメータ
リクエストでは URI パラメータを使用しません。
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- CreatorRequestId
-
これはリクエストを識別し、失敗したリクエストを 2 回実行するリスクなしに再試行できるようにする一意の文字列です。このパラメータはオプションです。使用する場合、このパラメータには 1～50 文字の英数字または「-_」を含める必要があります 。
タイプ: 文字列
必須: いいえ
- TieringConfiguration
-
階層設定には、作成する一意の
TieringConfigurationName文字列が含まれ、BackupVaultNameと が含まれている必要がありますResourceSelection。オプションでCreatorRequestId文字列を含めることができます。TieringConfigurationNameは、階層化設定の名前である一意の文字列です。これは作成後に変更できず、英数字とアンダースコアのみで構成されている必要があります。型: TieringConfigurationInputForCreate オブジェクト
必須: はい
- TieringConfigurationTags
-
階層設定に割り当てるタグ。
タイプ: 文字列間のマッピング
必須: いいえ
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"TieringConfigurationArn": "string",
"TieringConfigurationName": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- CreationTime
-
階層化設定が作成された日時。Unix 形式および協定世界時 (UTC)。
CreationTimeの値は、ミリ秒単位の精度です。例えば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前 12:11:30.087 を表します。タイプ: タイムスタンプ
- TieringConfigurationArn
-
作成された階層設定を一意に識別する Amazon リソースネーム (ARN)。
タイプ: 文字列
- TieringConfigurationName
-
この一意の文字列は、階層化設定の名前です。
作成後にこの名前を変更することはできません。名前には英数字とアンダースコアのみを使用できます。最大長は 200 です。
タイプ: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- 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
その他の参照資料
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
