Batch Adding Tags to a File System

Function

This API is used to batch add tags for a specified file system.

A maximum of 20 tags can be added to a file system.

Tag keys added to the same file system must be unique.

This API is idempotent. If the file system already has the key you want to add, the tag will be updated.

URI

POST /v1/{project_id}/sfs-turbo/{share_id}/tags/action

Table 1 Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
share_id	Yes	String	File system ID

Request Parameters

Table 2 Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Account token
Content-Type	Yes	String	MIME type

Table 3 Request body parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Operation identifier. The value is create. Use create if you want to batch add tags to a file system.
tags	No	Array of ResourceTag objects	Tag list. This field is mandatory for users. For users with the op_service permission, choose either this field or sys_tags.
sys_tags	No	Array of ResourceTag objects	System tag list. This field is available only to users with the op_service permission. Choose either this field or tags. Only one resource_tag structure key, _sys_enterprise_project_id, is used in TMS calls.

Table 4 ResourceTag
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. The key must be 1 to 128 characters long, cannot start or end with spaces, and cannot be an empty string. It can contain only UTF-8 letters, digits, spaces, and the following characters: _.:=+-@.
value	Yes	String	Tag value. The value must be 0 to 255 characters long and can be an empty string. It can contain only UTF-8 letters, digits, spaces, and the following characters: _.:=+-@.

Response Parameters

None

Example Requests

Batch adding tags for a file system, with tag key of the first tag set to key1, tag value of the first tag value1, tag key of the second tag key2, and tag value of the second tag value1

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value1"
  } ]
}

Example Responses

None

Status Codes

Status Code	Description
204	File system tags added.

Error Codes

See Error Codes.

Parent topic: Tag Management

Предыдущая статья

Deleting a Tag of a File System

Следующая статья

Querying Tags of All File Systems of a Tenant

Была ли эта статья полезна?

Поддержка Юридические документы