- API Reference
- Native OpenStack Nova APIs
- Tag Management
- Adding Tags to an ECS
Adding Tags to an ECS¶
This API is used to add tags to an ECS.
You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the microversion on the client.
URI¶
PUT /v2.1/{project_id}/servers/{server_id}/tags
Table 1 describes the parameters in the URI.
Parameter | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the project ID. |
server_id | Yes | Specifies the ECS ID. |
Request¶
Table 2 describes the request parameters.
Parameter | Mandatory | Type | Description |
---|---|---|---|
tags | Yes | Array of strings | Specifies ECS tags. A maximum of 50 tags can be configured, and each tag can contain up to 80 characters. Can only consist of digits, letters, hyphens (-), and underscores (_). |
Response¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
tags | Yes | Array of strings | Specifies ECS tags. |
Tag Name | Description |
---|---|
__type_baremetal | Specifies that the server is a BMS. |
__type_virtual | Specifies that the server is an ECS. |
Example Request¶
Add tags to a specified ECS.
PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/tags
{
"tags": ["baz", "foo", "qux"]
}
Example Response¶
{
"tags": ["baz", "foo", "qux"]
}