Batch Adding Tags to a Resource
Function
This API is used to batch add tags for a general purpose file system. You can add up to 20 tags to a resource.
URI
- POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/create
- Parameter description
Parameter
Mandatory
Type
Description
project_id
Yes
String
The project ID. For details, see Obtaining a Project ID.
resource_id
Yes
String
The resource ID, which is the name of a general purpose file system.
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-type |
Yes |
String |
The MIME type of the request body. Example: application/json |
X-Auth-Token |
No |
String |
The user token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
tags |
No |
List<resource_tag> |
The tag list. For details, see Table 3. This parameter is mandatory for common tenants. Use either tags or sys_tags if you have the op_service permissions. |
sys_tags |
No |
List<resource_tag> |
The system tag list. This parameter is available only to the op_service permissions. Use either tags or sys_tags if you have the op_service permissions. Only one resource_tag structure is used in TMS calls currently. The key is fixed at _sys_enterprise_project_id. The value can be UUID or 0. 0 indicates the default enterprise project. System tags can only be added. For details, see Table 3. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
key |
Yes |
String |
The tag key. A tag key can contain a maximum of 128 characters. It can contain letters, digits, and spaces representable in UTF-8 and special characters (_.:=+-@). It cannot start or end with a space and cannot be left empty. Tag keys starting with _sys_ are system tags, and you cannot start a tag key with _sys_. |
value |
No |
String |
The tag value. A tag value can contain a maximum of 255 characters. It can contain letters, digits, and spaces representable in UTF-8 and special characters (_.:=+-@) and can be left empty. It cannot start or end with a space. |
Response Parameters
None
Example Request
Batch adding tags to a general purpose file system whose name is bucketName with the project ID c80a2157ba1d46c0825265947342077c:
POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/bucketName/tags/create
Request body example:
{ "tags":[ { "key":"key1", "value":"value1" }, { "key":"key2", "value":"value2" } ] }
Example Response
None
Status Codes
- Normal
Status Code |
Description |
---|---|
204 |
Resource tags added. |
- Abnormal
Status Code |
Description |
---|---|
400 |
Invalid tag parameter. |
401 |
Certification failed. |
403 |
Authentication failed. |
404 |
Resource not found. |
500 |
System error. |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot