Updated on 2024-04-16 GMT+08:00

Adding a Tag to an ECS

This API is used to add a tag 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.

Constraints

  • The tag contains a maximum of 80 characters.
  • A maximum of 50 tags can be added to an ECS.
  • An empty tag cannot be created.

URI

PUT /v2.1/{project_id}/servers/{server_id}/tags/{tag}

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the ID, see Obtaining a Project ID.

server_id

Yes

Specifies the ECS ID.

tag

Yes

Specifies the key of the tag to be added.

Request

None

Response

Table 2 Response parameters

Parameter

Type

Description

message

String

Example: "<br /><br />\n\n\n"

code

String

Example: "201 Created"

title

String

Example: "Created"

Example Request

Add a tag to a specified ECS.

PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/tags/{tag}

Example Response

By default, the response is in HTML format.

<html>
<head>
      <title>201 Created</title>
</head>
<body>
      <h1>201 Created</h1>
      <br /><br />



</body>
</html>

JSON format

{
   "message": "<br /><br />\n\n\n",
   "code": "201 Created",
   "title": "Created"
}