- API Reference
- API Description
- Tag Management
- Querying Tags of a Backup Policy
Querying Tags of a Backup Policy¶
Function¶
This API is used to query tags of a specific resource.
TMS uses this API to query all tags of a specific resource.
URI¶
URI format
GET https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags
Request header
Table 1 Request header¶ Parameter
Mandatory
Type
Description
Content-type
Yes
MIME type of the body in the request
application/json
X-Auth-Token
Yes
User token
-
Parameter description
Table 2 Parameter description¶ Parameter
Mandatory
Type
Description
project_id
Yes
String
Project ID
resource_id
Yes
String
Resource ID
Request¶
Parameter description
None
Example request
GET https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags
Response¶
Parameter description
Table 3 Parameter description¶ Parameter
Type
Description
tags
List<resource_tag>
Tag list
Keys in the tag list must be unique.
Parameter description of field resource_tag
Table 4 Parameter description of field resource_tag¶ Parameter
Type
Description
key
String
Tag key
It consists of up to 36 characters.
It cannot be an empty string.
It can contain only letters, digits, hyphens (-), and underscores (_).
value
List<String>
Tag value
It consists of up to 43 characters.
It can be an empty string.
It can contain only letters, digits, hyphens (-), and underscores (_).
Example response
{ "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
Status Codes¶
Normal
Status Code
Description
200
OK
Abnormal
Status Code
Description
400
Invalid parameters.
401
Authentication failed.
403
You do not have permission to perform this operation.
404
The requested resource was not found.
500
A system exception occurs.
Error Codes¶
For details, see Error Codes.