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

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

DescribeTags

注意

已弃用-DeleteTags 操作已弃用而不是维护。请使用ListTagsForResource从 EFS 资源中删除标签的 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,响应将在此字段中返回该值。

类型: String

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

模式:.+

NextMarker

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

类型: String

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

模式:.+

Tags

返回与文件系统关联的标签,作为数组Tag对象。

类型: 数组Tagobjects

Errors

BadRequest

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

HTTP 状态代码:400

FileSystemNotFound

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

HTTP 状态代码:404

InternalServerError

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

HTTP 状态代码:500

Examples

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

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

示例请求

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 的更多信息,请参阅以下内容: