本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateTieringConfiguration
建立分層組態。
分層組態可根據備份文件庫中備份物件的存留期，自動將備份資料移至成本較低的儲存層。
除了套用至所有保存庫的任何全域組態之外，每個保存庫只能有一個保存庫特定的分層組態。
請求語法
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
-
這是可識別請求的唯一字串，並允許重試失敗的請求，而不會有執行操作兩次的風險。此為選用參數。如果使用，此參數必須包含 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 秒。類型：Timestamp
- TieringConfigurationArn
-
可唯一識別所建立分層組態的 Amazon Resource Name (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 的詳細資訊，請參閱下列內容：
