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

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

DescribeTags

注意

已弃用-该DescribeTags操作已过时且未维护。要查看与 EFS 资源关联的标签,请使用ListTagsForResource API 操作。

返回与文件系统关联的标签。未指定一次DescribeTags调用的响应中返回的标签顺序以及多调迭代的响应中返回的标签顺序(使用分页时)。

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

请求语法

GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

FileSystemId

要检索其标签集检索其标签集的ID。

长度约束:最大长度为 128。

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

必需:是

Marker

(可选)从先前DescribeTags操作返回的不透明分页标记(字符串)。如果存在,则指定从上次呼叫中断的地方继续播放列表。

长度限制:最小长度为 1。最大长度为 128。

模式:.+

MaxItems

(可选)要响应中返回的文件系统标签的最大数量。目前,此数字自动设置为 100,其他值将被忽略。如果您的标签超过 100 个,则响应将按每页 100 个分页显示。

有效范围:最小值为 1。

请求正文

该请求没有请求体。

响应语法

HTTP/1.1 200 Content-type: application/json { "Marker": "string", "NextMarker": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

响应元素

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

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

Marker

如果请求包含Marker,则响应将在此字段中返回该值。

类型:字符串

长度限制:最小长度为 1。最大长度为 128。

模式:.+

NextMarker

如果存在值,则还有更多标签要返回。在后续请求中,您可以在下一个请求中提供值NextMarker作为Marker参数的值,以检索下一组标签。

类型:字符串

长度限制:最小长度为 1。最大长度为 128。

模式:.+

Tags

Tag对象数组的形式返回与文件系统关联的标签。

类型:Tag 对象数组

错误

BadRequest

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

HTTP 状态代码:400

FileSystemNotFound

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

HTTP 状态代码:404

InternalServerError

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

HTTP 状态代码:500

示例

检索与文件系统关联的标签

以下请求检索与指定文件系统关联的标签(键值对)。

示例请求

GET /2015-02-01/tags/fs-01234567/ HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215404Z Authorization: <...>

示例响应

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 288 { "Tags":[ { "Key":"Name", "Value":"my first file system" }, { "Key":"Fleet", "Value":"Development" }, { "Key":"Developer", "Value":"Alice" } ] }

另请参阅

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