本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListTagsForResource
列出与资源关联的所有标签。
请求语法
POST /tags-list HTTP/1.1
Content-type: application/json
{
"maxResults": number
,
"nextToken": "string
",
"resourceARN": "string
"
}
URI 请求参数
该请求不使用任何 URI 参数。
请求体
请求接受采用 JSON 格式的以下数据。
- maxResults
-
一次性返回的最大结果数。默认值为 25。
有效范围:最小值为 1。最大值为 250。
类型:整数
有效范围:最小值为 0。最大值为 200。
必需:否
- nextToken
-
指定下一页结果的字符串。
类型:字符串
长度约束:最小长度为 0。最大长度为 17880。
模式:
.*
必需:否
- resourceARN
-
资源的 ARN。
类型:字符串
长度约束:最小长度为 20。最大长度为 2048。
模式:
arn:((aws)|(aws-cn)|(aws-us-gov)):iottwinmaker:[a-z0-9-]+:[0-9]{12}:[\/a-zA-Z0-9_\-\.:]+
必需:是
响应语法
HTTP/1.1 200
Content-type: application/json
{
"nextToken": "string",
"tags": {
"string" : "string"
}
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- nextToken
-
指定下一页结果的字符串。
类型:字符串
长度约束:最小长度为 0。最大长度为 17880。
模式:
.*
-
可用于管理资源的元数据。
类型:字符串到字符串映射
映射条目:最低 0 项。最多 50 项。
密钥长度限制:最小长度为 1。长度上限为 128。
键模式:
([\p{L}\p{Z}\p{N}_.:/=+\-@]*)
值长度限制:最小长度为 1。最大长度为 256。
价值模式:
.*
错误
有关所有操作的常见错误信息,请参阅常见错误。
- AccessDeniedException
-
访问被拒绝。
HTTP 状态代码:403
- ResourceNotFoundException
-
未找到资源。
HTTP 状态代码:404
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: