ListTags - Amazon Backup
请求语法URI 请求参数请求体响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

ListTags

返回分配给目标恢复点、备份计划或备份保管库的键值对列表。

ListTags 仅适用于支持 Amazon Backup 完全管理其备份的资源类型。这些资源类型列在 “按资源划分的功能可用性” 表的 “完全 Amazon Backup 管理” 部分。

请求语法

GET /tags/resourceArn/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

MaxResults

要返回的最大项目数量。

有效范围：最小值为 1。最大值为 1000。

NextToken

所返回项目的部分列表的后续下一个项目。例如，如果请求返回 MaxResults 数量的项目，则 NextToken 允许您从下一个令牌指向的位置开始返回列表中的更多项目。

resourceArn

唯一标识资源的 Amazon 资源名称 (ARN)。ARN 的格式取决于资源的类型。ListTags 的有效目标是恢复点、备份计划和备份保管库。

必需：是

请求体

该请求没有请求正文。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": { 
      "string" : "string" 
   }
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

NextToken

所返回项目的部分列表的后续下一个项目。例如，如果请求返回 MaxResults 数量的项目，则 NextToken 允许您从下一个令牌指向的位置开始返回列表中的更多项目。

类型：字符串

Tags

要帮助组织您的资源，您可以将自己的元数据分配给所创建的资源。每个标签都是一个键-值对。

类型：字符串到字符串映射

错误

有关所有操作返回的常见错误的信息，请参阅常见错误。

InvalidParameterValueException

表示参数的值有问题。例如，该值超出了范围。

HTTP 状态代码：400

MissingParameterValueException

表示缺少必需的参数。

HTTP 状态代码：400

ResourceNotFoundException

该操作所需的资源不存在。

HTTP 状态代码：400

ServiceUnavailableException

由于服务器发生临时故障而导致请求失败。

HTTP 状态代码：500

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：