Deleting Resource Tags in Batches

Function

This API is used to batch delete tags from a specified instance.

URI

POST /v5/{project_id}/{resource_type}/{resource_id}/tags/delete

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region. For details, see Obtaining a Project ID.
resource_type	Yes	String	Resource type. migration: real-time migration. sync: real-time synchronization. cloudDataGuard: real-time disaster recovery. subscription: data subscription. backupMigration: backup migration. replay: traffic replay. Enumerated values: migration sync cloudDataGuard subscription backupMigration replay
resource_id	Yes	String	Resource ID, that is, the DRS task ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	MIME type of the request body. Use the default value application/json. For APIs used to upload objects or images, the value varies depending on the flow type. The default value is application/json.
X-Auth-Token	Yes	String	User token obtained from IAM. It is a response to the API for obtaining a user token. After a request is processed, the value of X-Subject-Token in the header is the token value.
X-Language	No	String	Request language type. Default value: en-us Enumerated values: en-us zh-cn

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
tags	Yes	Array of objects	Tag list. For details, see Table 4.

**Table 4** Data structure description of field **tags**
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. It must consist of 1 to 128 Unicode characters, including letters, digits, spaces, and special characters _.:=+-@. However, it cannot start or end with a space, or start with _sys_. Minimum length: 1 Maximum length: 128
value	No	String	Tag value. This parameter is optional for deleting a tag. Each tag value can contain a maximum of 255 Unicode characters. The value can contain letters of any language, digits, spaces, and special characters _.:=+-@ Maximum length: 255

Response Parameters

None

Example Request

Deleting tags in batches from a synchronization task

 https://{endpoint}/v5/5237e10fe9aa4ad5b16b6a5245248314/sync/2f4af282-d13e-4b10-a1eb-609b47fjb201/tags/delete

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