本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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。类型：时间戳
- 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
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
