Updated on 2024-01-31 GMT+08:00

Creating Tags in Batches

Function

This API is used to create tags in batches.

Calling Method

For details, see Calling APIs.

URI

POST /v5/{project_id}/{resource_type}/{resource_id}/tags/create

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant ID

Minimum: 1

Maximum: 256

resource_type

Yes

String

Resource type. The value is hss.

Minimum: 1

Maximum: 64

resource_id

Yes

String

Resource ID

Minimum: 0

Maximum: 128

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.

Minimum: 32

Maximum: 512

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

tags

No

Array of ResourceTagInfo objects

Tag List

Array Length: 0 - 1024

sys_tags

No

Array of ResourceTagInfo objects

Tag List

Array Length: 0 - 1024

Table 4 ResourceTagInfo

Parameter

Mandatory

Type

Description

key

No

String

Key. It can contain up to 128 Unicode characters. The key cannot be left blank.

Minimum: 1

Maximum: 128

value

No

String

Value

Minimum: 1

Maximum: 128

Response Parameters

None

Example Requests

Create a tag key TESTKEY20220831190155 (the tag value is 2) and a tag key test (the tag value is hss).

POST https://{endpoint}/v5/05e1e8b7ba8010dd2f80c01070a8d4cd/hss/fbaa9aca-2b5f-11ee-8c64-fa163e139e02/tags/create

{
  "tags" : [ {
    "key" : "TESTKEY20220831190155",
    "value" : "2"
  }, {
    "key" : "test",
    "value" : "hss"
  } ]
}

Example Responses

None

Status Codes

Status Code

Description

200

success

400

Invalid parameter.

401

Authentication failed.

403

Insufficient permission.

404

Resources not found.

500

System error.

Error Codes

See Error Codes.