本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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"
}
]
}
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs,请参阅以下内容: