本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 格式返回的以下数据。
错误
- AccessPointNotFound
-
返回指定的
AccessPointId
请求者中不存在该值Amazon Web Services 账户.HTTP 状态代码:404
- BadRequest
-
如果请求格式不正确或包含错误,例如无效的参数值或缺少必需参数,则返回。
HTTP 状态代码:400
- FileSystemNotFound
-
返回指定的
FileSystemId
请求者中不存在该值Amazon Web Services 账户.HTTP 状态代码:404
- InternalServerError
-
如果服务器端发生错误,则返回。
HTTP 状态代码:500
另请参阅
有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: