doc-exports/docs/sdrs/api-ref/sdrs_05_0802.html

Adding Protected Instance Tags in Batches

Function

This API is used to add protected instance tags for a specified protected instance in batches.

You can add a maximum of 20 tags to a protected instance.

This API is idempotent.

• If there are duplicate keys in the request body when you add tags, an error is reported.
• During tag creation, duplicate keys are not allowed. If a key exists in the database, its value will be overwritten.

URI

• URI format

  POST /v1/{project_id}/protected-instances/{protected_instance_id}/tags/action

• Parameter description

  Parameter	Mandatory	Type	Description
  project_id	Yes	String	Specifies the project ID.
  protected_instance_id	Yes	String	Specifies the ID of a protected instance. For details, see Querying Protected Instances.

Request

• Parameter description

  Parameter	Mandatory	Type	Description
  action	Yes	String	Identifies the operation. The value can be create or delete. create: indicates to create a tag.
  tags	Yes	Array of objects	Specifies the tag list. For details, see Table 1.

  Table 1 resource_tag field description

  Parameter	Mandatory	Type	Description
  key	Yes	String	Specifies the tag key. The tag key of a resource must be unique.
  value	Yes	String	Specifies the tag value.

• Example request
  POST https://{Endpoint}/v1/{project_id}/protected-instances/67a2cc7e-fb87-41a8-ba28-9c032abcaee1/tags/action

  {
      "action": "create",
      "tags": [
          {
              "key": "key1",
              "value": "value1"
          },
          {
              "key": "key",
              "value": "value3"
          }
      ]
  }

Response

• Parameter description

  None

Returned Value

• Normal

  Returned Value	Description
  204	No Content

• Abnormal

  Returned Value	Description
  400	Invalid parameters.
  401	Authentication failed.
  403	Insufficient permission.
  404	The requested resource was not found.
  500	Internal service error.

Parent topic: Tag Management