Batch Creating or Deleting EIP Tags

Function

This API is used to add multiple tags to or delete multiple tags from an EIP at a time.

This API is idempotent.

If there are duplicate keys in the request body when you add tags, an error is reported.

During tag creation, duplicate keys are not allowed. If a key already exists in the database, its value will be overwritten by the new duplicate key.

During tag deletion, if some tags do not exist, the operation is considered to be successful by default. The character set of the tags will not be checked. When you delete tags, the tag structure cannot be missing, and the key cannot be left blank or be an empty string.

URI

POST /v2.0/{project_id}/publicips/{publicip_id}/tags/action

Table 1 describes the parameters.

Request Message

• Request parameter

  Table 2 Request parameter

  Parameter	Type	Mandatory	Description
  tags	Array of tag objects	Yes	Specifies the tag object list. For details, see Table 3.
  action	String	Yes	Specifies the operation. Possible values are as follows: create delete

  Table 3 tag objects

  Attribute	Type	Mandatory	Description
  key	String	Yes	Specifies the tag key. Cannot be left blank. Can contain a maximum of 36 characters. Can contain only the following character types: Uppercase letters Lowercase letters Digits Special characters, including hyphens (-) and underscores (_) The tag key of a VPC must be unique.
  value	String	Yes	Specifies the tag value. Can contain a maximum of 43 characters. Can contain only the following character types: Uppercase letters Lowercase letters Digits Special characters, including hyphens (-) and underscores (_)

Response Message

• Response parameter

  None

• Example response

  None

  Or

  {
         "code":"xxx",
         "message":"xxxxx"
  }

Status Code

See Status Codes.

Error Code

See Error Codes.