Adding a Tag to an EIP
Function
This API is used to add a tag to an EIP.
URI
POST /v2.0/{project_id}/publicips/{publicip_id}/tags
Table 1 describes the parameters.
| Parameter | Mandatory | Description |
|---|---|---|
| project_id | Yes | Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. |
| publicip_id | Yes | Specifies the unique identifier of an EIP. |
Request Message
- Request parameter
Table 2 Request parameter Parameter
Type
Mandatory
Description
tag
tag object
Yes
Specifies the tag objects. For details, see Table 3.
Table 3 tag objects Parameter
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 (-), underscores (_), and at signs (@)
- 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 (-), underscores (_), and at signs (@)
- Example request
POST https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags { "tag": { "key": "key1", "value": "value1" } }
Response Message
Status Code
See Status Codes.
Error Code
See Error Codes.