本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
TagResource
将一组键值对分配给由 Amazon 资源名称(ARN)标识的恢复点、备份计划或备份保管库。
包括 Aurora、Amazon DocumentDB 在内的资源类型的恢复点支持此 API。Amazon EBS、Amazon FSx、Neptune 和 Amazon RDS。
请求语法
POST /tags/resourceArn
HTTP/1.1
Content-type: application/json
{
"Tags": {
"string
" : "string
"
}
}
URI 请求参数
请求使用以下 URI 参数。
- resourceArn
-
唯一标识资源的 ARN。ARN 的格式取决于标记资源的类型。
不包含
backup
的 ARN 与标记不兼容。具有无效 ARN 的TagResource
和UntagResource
将导致错误。可接受的 ARN 内容可以包括arn:aws:backup:us-east
。无效的 ARN 内容可能类似于arn:aws:ec2:us-east
。必需:是
请求体
请求接受采用 JSON 格式的以下数据。
- Tags
-
用于帮助组织您的资源的键值对。您可以将自己的元数据分配给所创建的资源。为了清楚起见,这里提供了分配标签的结构:
[{"Key":"string","Value":"string"}]
。类型:字符串到字符串映射
必需:是
响应语法
HTTP/1.1 200
响应元素
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
有关所有操作返回的常见错误的信息,请参阅常见错误。
- InvalidParameterValueException
-
表示参数的值有问题。例如,该值超出了范围。
HTTP 状态代码:400
- LimitExceededException
-
已超过请求中的限制;例如,请求中允许的最大项目数。
HTTP 状态代码:400
- MissingParameterValueException
-
表示缺少必需的参数。
HTTP 状态代码:400
- ResourceNotFoundException
-
该操作所需的资源不存在。
HTTP 状态代码:400
- ServiceUnavailableException
-
由于服务器发生临时故障而导致请求失败。
HTTP 状态代码:500
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: