Creating a Tag

Function

This API is used to create a tag.

URI

POST /v2/{project_id}/cfw-cfw/{fw_instance_id}/tags/create

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID, which can be obtained by calling an API or from the console. For details, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
fw_instance_id	Yes	String	Definition Firewall ID, which can be obtained by referring to Obtaining a Firewall ID. Constraints N/A Range N/A Default Value N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Constraints N/A Range N/A Default Value N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
tags	No	Array of CreateTag objects	Definition Create a firewall tag list. Constraints N/A Range N/A Default Value N/A

**Table 4** CreateTag
Parameter	Mandatory	Type	Description
key	No	String	Definition Tag key. Constraints N/A Range N/A Default Value N/A
value	No	String	Definition Tag value. Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
-	String

Example Requests

Add a tag whose key is keytest and value is valuetest to firewall 5e7eba7f-5de4-4ce9-8f60-11330dfc6565 in project 0b2179bbe180d3762fb0c01a2d5725c7.

https://{Endpoint}/v2/0b2179bbe180d3762fb0c01a2d5725c7/cfw-cfw/5e7eba7f-5de4-4ce9-8f60-11330dfc6565/tags/create

{
  "tags" : [ {
    "key" : "keytest",
    "value" : "valuetest"
  } ]
}