ListTagsForResource - Amazon Elastic File System
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在接下来获取接入点描述的下一页请求中。

类型: String

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

模式:.+

Tags

指定 EFS 资源的标签数组。

类型: 数组Tagobjects

Errors

AccessPointNotFound

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

HTTP 状态代码:404

BadRequest

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

HTTP 状态代码:400

FileSystemNotFound

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

HTTP 状态代码:404

InternalServerError

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

HTTP 状态代码:500

另请参阅

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