tag列表
所有文档

          云服务器 BCC

          tag列表

          描述

          • 本接口用于列出所有符合条件的标签键值对
          • 标签的键和标签的值可以作为筛选条件
          • 本接口返回所有符合条件的结果,不分页

          请求

          请求结构

          GET /v{version}/tag?tagKey={tagkey}&tagValue={tagValue} HTTP/1.1
          Host: tag.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          tagKey String Query参数 待查询的标签键,该项不出现或为空表示查询所有标签键
          tagValue String Query参数 待查询的标签值,该项不出现表示查询所有标签值,为空表示待查询的标签值为空字符串

          返回

          返回头域

          除公共头域,无其它特殊头域。

          返回参数

          参数名称 类型 描述
          tags List<Tag> 符合条件的标签键值对列表,若无符合条件的标签,则返回空数组

          错误码

          无特殊返回错误码

          示例

          请求示例

          GET /v1/tag?tagKey=key1 HTTP/1.1
          Host: tag.baidubce.com
          Authorization: bce-auth-v1/5004fa6158924aa3a752f6897782af8d/2018-04-09T00:00:00Z/1800/host/807f9b9a5bc5c0f38fd184582f1b4028a736687864df86440c443282ddb4ca9e

          返回示例

          cache-control: no-cache
          content-length: 0
          content-type: text/plain; charset=utf-8
          date: Mon, 09 Apr 2018 00:00:00 GMT
          server: BWS
          x-bce-request-id: ec40cddb-b5d0-45ae-9325-2822ece684cf
          
          {
              "tags": [
                  {
                      "tagKey": "key1",
                      "tagValue": "value1"
                  }
              ]
          }
          上一篇
          查看标签下绑定的资源
          下一篇
          附录1