查标签接口。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /tags HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| resourceType |
string |
是 |
资源类型 |
Service |
| resourceId |
array |
否 |
资源 ID 列表 |
|
|
string |
否 |
资源 ID |
test |
|
| tag |
array |
否 |
标签。查询的过滤条件。 最多可以指定 20 个标签。 |
|
| Tag |
否 |
标签。查询的过滤条件。 最多可以指定 20 个标签。 |
||
| nextToken |
string |
否 |
下一个查询开始 Token |
xxxxxxxxxx |
| maxResults |
integer |
否 |
最大返回结果数，最大值 200 |
20 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
请求 ID |
0CEC5375-C554-562B-A65F-*** |
| maxResults |
integer |
最大返回结果数，最大值 200 |
20 |
| nextToken |
string |
下一个查询开始 Token |
xxxxxxxxxx |
| tagResources |
array<object> |
标签列表 |
|
|
object |
标签列表 |
||
| tagKey |
string |
标签键 |
env |
| tagValue |
string |
标签值 |
test |
| resourceId |
string |
资源 ID |
test |
| resourceType |
string |
资源类型 |
Service |
示例
正常返回示例
JSON格式
{
"requestId": "0CEC5375-C554-562B-A65F-***",
"maxResults": 20,
"nextToken": "xxxxxxxxxx",
"tagResources": [
{
"tagKey": "env",
"tagValue": "test",
"resourceId": "test",
"resourceType": "Service"
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter.ResourceType | The ResourceType parameter is invalid. | |
| 400 | MissingParameter.ResourceIdsOrTags | You must specify ResourceId.N or Tags. | |
| 400 | MissingParameter.ResourceType | You must specify ResourceType. | |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | |
| 400 | NumberExceed.ResourceIds | The maximum number of ResourceIds is exceeded. | |
| 400 | NumberExceed.Tags | The maximum number of Tags is exceeded. | |
| 400 | Duplicate.TagKey | The Tag.N.Key contains duplicate keys. | |
| 400 | InvalidParameter.NextToken | The NextToken parameter is invalid. | |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | NoPermission | The operator is not permission for this operate |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。