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

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

ListTagsForResource

列出顶级 EFS 资源的所有标签。您必须提供要检索其标签的资源的 ID。

此操作需要 elasticfilesystem:DescribeAccessPoints 操作的权限。

请求语法

GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

MaxResults

（可选）指定要在响应中返回的标签对象的最大数量。默认值是 100。

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

NextToken

（可选）您可以使用NextToken在接下来的请求中，如果响应有效负载已分页，请求获取接入点描述的下一页。

约束：最小长度为 1。长度上限为 128。

模式：.+

ResourceId

指定要为其检索标签的 EFS 资源。您可以使用此 API 终端节点检索 EFS 文件系统和接入点的标签。

约束：长度上限为 128。

模式：^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$

：必填项：是

请求正文

该请求没有请求体。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

响应元素

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

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

NextToken

NextToken如果响应有效负载已分页，则存在。您可以使用NextToken在接下来获取接入点描述的下一页请求中。

类型: 字符串

约束：最小长度为 1。长度上限为 128。

模式：.+

Tags

是指定 EFS 资源的标签的数组。

类型: 数组Tag对象

错误

AccessPointNotFound

返回指定的AccessPointId请求者中不存在该值Amazon Web Services 账户.

HTTP 状态代码：404

BadRequest

如果请求格式不正确或包含错误，例如无效的参数值或缺少必需参数，则返回。

HTTP 状态代码：400

FileSystemNotFound

返回指定的FileSystemId请求者中不存在该值Amazon Web Services 账户.

HTTP 状态代码：404

InternalServerError

如果服务器端发生错误，则返回。

HTTP 状态代码：500

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息，请参阅以下内容：