ListTagsForResource - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

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

如果请求者的 Amazon Web Services 账户中不存在指定的 AccessPointId 值,则返回此内容。

HTTP 状态代码:404

BadRequest

如果请求格式错误或包含错误(例如参数值无效或缺少必填参数),则返回此内容。

HTTP 状态代码:400

FileSystemNotFound

如果请求者的 Amazon Web Services 账户中不存在指定的 FileSystemId 值,则返回此内容。

HTTP 状态代码:404

InternalServerError

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

HTTP 状态代码:500

另请参阅

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