功能介绍
根据租户ID和资源类型,获取租户下资源的标签。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/{resource_type}/tags
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
resource_type |
是 |
String |
资源类型,值为:endpoint_service或endpoint。 |
请求参数
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
tags |
包含标签,最多包含10个key,每个key下面的value最多10个, 每个key对应的value可以为空数组但结构体不能缺失。 Key不能重复,同一个key中values不能重复。结果返回包含所有标签的资源列表, key之间是与的关系,key-value结构中value是或的关系。无tag过滤条件时返回全量数据。 |
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
键。 最大长度127个unicode字符。key不能为空。(搜索时不对此参数做字符集校), key不能为空或者空字符串,不能为空格,校验和使用之前先trim前后半角空格。 最小长度:1 最大长度:36 |
values |
Array of strings |
值列表。 每个值最大长度255个unicode字符,校验和使用之前先trim前后半角空格。 value可为空数组但不可缺省。如果values为空列表,则表示any_value(查询任意value)。 value之间为或的关系。(搜索时不对此参数做字符集校验,只做长度校验)。 |
状态码: 400
状态码: 401
状态码: 403
状态码: 404
状态码: 405
状态码: 406
状态码: 407
状态码: 408
状态码: 409
状态码: 500
状态码: 501
状态码: 502
状态码: 503
状态码: 504
请求示例
-
查询 终端节点 服务的资源标签
GET https://{endpoint}/v1/{project_id}/endpoint_service/tags
-
查询终端节点的资源标签
GET https://{endpoint}/v1/{project_id}/endpoint/tags
响应示例
状态码: 200
标签列表。
{ "tags" : [ { "key" : "key1", "values" : [ "*value1", "value2" ] } ] }
状态码
状态码 |
描述 |
---|---|
200 |
标签列表。 |
400 |
服务器未能处理请求 |
401 |
被请求的页面需要用户名和密码 |
403 |
对被请求页面的访问被禁止 |
404 |
服务器无法找到被请求的页面 |
405 |
请求中指定的方法不被允许 |
406 |
服务器生成的响应无法被客户端所接受 |
407 |
用户必须首先使用代理服务器进行验证,这样请求才会被处理 |
408 |
请求超出了服务器的等待时间 |
409 |
由于冲突,请求无法被完成 |
500 |
请求未完成。服务异常 |
501 |
请求未完成。服务器不支持所请求的功能 |
502 |
请求未完成。服务器从上游服务器收到一个无效的响应 |
503 |
请求未完成。系统暂时异常 |
504 |
网关超时 |
错误码
请参见错误码。