Help Center/ Scalable File Service/ API Reference/ General Purpose File System APIs/ Tags/ Batch Deleting Tags from a Resource
Updated on 2025-11-14 GMT+08:00
View PDF
Share

Batch Deleting Tags from a Resource

Function

This API is used to batch delete tags from a specified resource. System tags cannot be deleted. If any tag to be deleted is not found, a successful result is returned.

Authorization

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. For the specific permissions required, see Permissions Policies and Supported Actions.

URI

  • POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/delete
  • 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

Table 1 Request header 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.
Table 2 Request body parameters

Parameter

Mandatory

Type

Description

tags

Yes

List<resource_tag>

The tag list. For details, see Table 3.

Response Parameters

None

Example Request

Batch deleting tags from 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/delete

Request body example:

{
    "tags":[
        {
            "key":"key1"
        },
        {
            "key":"key2",
            "value":"value2"
        }
    ]
}

Example Response

None

Status Codes

  • Normal

Status Code

Description

204

Resource tags are deleted.
  • Abnormal

Status Code

Description

400

Invalid tag parameter.

401

Certification failed.

403

Authentication failed.

404

Resource not found.

500

System error.
Parent topic: Tags