调用DescribeTags来查询已有标签。

说明 标签功能已全面升级,该文档即将下线,相关文档请参见ListTagResources。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeTags

系统规定参数。取值:DescribeTags。

FileSystemId String 0addcw****

文件系统ID。

PageSize Integer 1

每个分页包含的标签数,默认值:10。

PageNumber Integer 1

列表的分页页码,从1开始计数。

Tag.N.Key String keyN

当前第N组标签键(TagKey)。需要查询的标签,包括标签键(TagKey)和标签值(TagValue),单次最多支持传入10组值。标签键(TagKey)不能为空,标签值(TagValue)可以为空。

Tag.N.Value String valueN

当前第N组标签值(TagValue)。需要查询的标签,包括标签键(TagKey)和标签值(TagValue),单次最多支持传入10组值。标签键(TagKey)不能为空,标签值(TagValue)可以为空。

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

列表的分页页码。

PageSize Integer 1

每个分页包含的文件系统个数。

RequestId String 035B3A3A-E514-4B41-B906-5D906CFBD65F

请求ID。

Tags Array of Tag

满足所有筛选条件的标签。

Tag
FileSystemIds List 109c04****

绑定的文件系统ID。

Key String key1

标签键。

Value String value1

标签值。

TotalCount Integer 1

文件系统总数。

示例

请求示例

GET https://nas.cn-hangzhou.aliyuncs.com/?Action=DescribeTags
&FileSystemId=109c04****
&<公共请求参数>

正常返回示例

XML格式

<Tags>
    <Tag>
        <Key>key1</Key>
        <Value>value1</Value>
        <FileSystemIds>
            <FileSystemId>109c04****</FileSystemId>
        </FileSystemIds>
    </Tag>
</Tags>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<TotalCount>1</TotalCount>
<RequestId>035B3A3A-E514-4B41-B906-5D906CFBD65F</RequestId>

JSON格式

{
  "Tags":{
    "Tag":[
      {
        "Key":"key1",
        "Value":"value1",
        "FileSystemIds":{
          "FileSystemId": [
            "109c04****"
          ]
        }
      }
    ]
  },
  "PageNumber":1,
  "PageSize":10,
  "TotalCount":1,
  "RequestId":"035B3A3A-E514-4B41-B906-5D906CFBD65F"
}

错误码

访问错误中心查看更多错误码。