Adding a Tag to a Security Group

Function

This API is used to create a tag for a security group. The API is idempotent. If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one.

URI

POST /v2.0/{project_id}/security-groups/{security_group_id}/tags

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
security_group_id	Yes	String	Security Group ID

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
tag	Yes	ResourceTag object	Request body for creating a security group tag.

**Table 3** ResourceTag
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. The key must be unique for each resource. Minimum: 0 Maximum: 36
value	Yes	String	Tag value Minimum: 0 Maximum: 43

Response Parameters

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
code	String	Error code returned for a request.
message	String	Error message returned for a request.

Status code: 401

**Table 5** Response body parameters
Parameter	Type	Description
code	String	Error code returned for a request.
message	String	Error message returned for a request.

Status code: 403

**Table 6** Response body parameters
Parameter	Type	Description
code	String	Error code returned for a request.
message	String	Error message returned for a request.

Status code: 404

**Table 7** Response body parameters
Parameter	Type	Description
code	String	Error code returned for a request.
message	String	Error message returned for a request.

Status code: 409

**Table 8** Response body parameters
Parameter	Type	Description
code	String	Error code returned for a request.
message	String	Error message returned for a request.

Status code: 500

**Table 9** Response body parameters
Parameter	Type	Description
code	String	Error code returned for a request.
message	String	Error message returned for a request.

Example Requests

Creating a Tag for a Security Group

POST https://{Endpoint}/v2.0/{project_id}/security-groups/{security_group_id}/tags

{
  "tag" : {
    "key" : "key1",
    "value" : "value1"
  }
}

Example Responses

None

Status Codes

Status Code	Description
204	Normal response.
400	The server failed to process the request.
401	Username and password are required to access the page requested.
403	You are forbidden to access the requested page.
404	The server could not find the requested page.
409	The request could not be processed due to a conflict.
500	Failed to complete the request because of an internal service error.