Adding an Instance Tag

Function

Adding an instance tag.

URI

POST /v5/iot/{project_id}/iotda-instances/{instance_id}/bind-tags

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Parameter description : project ID. For details, see Obtaining a Project ID.
instance_id	Yes	String	Parameter description: instance ID. Value: Enter up to 36 characters, including lowercase letters (a-f), digits, and hyphens (-).

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
tags	Yes	Array of Tag objects	Parameter description: instance tag.

**Table 3** Tag
Parameter	Mandatory	Type	Description
key	Yes	String	Parameter description: tag key. Use letters, digits, spaces, and special characters (_.:=+-@). No space is allowed at the beginning or end.
value	No	String	Parameter description: tag value, which can be an empty string or null. Use letters, digits, spaces, and special characters (_.:=+-@).

Response Parameters

Status code: 200

None

Example Requests

POST https://{endpoint}/v5/iot/{project_id}/iotda-instances/{instance_id}/bind-tags

{
  "tags" : [ {
    "key" : "testTagName",
    "value" : "testTagValue"
  } ]
}