AttachTag

Prev Next

Available in Classic and VPC

Add a tag to a resource.

Request

This section describes the request format. The method and URI are as follows:

Method URI
POST /api/v1/resource-tags

Request headers

For information about the headers common to all Resource Manager APIs, see Resource Manager request headers.

Request body

You can include the following data in the body of your request:

Field Type Required Description
nrnList Array Required NAVER Cloud Platform resource identification value
tagKey String Required Tag key
  • 1 - 127 characters
  • Special characters (-, _) can be used
  • Only update tag values when adding an already existing key
tagValue String Required Tag value
  • 1 - 127 characters
  • Special characters (-, _) can be used
  • Use to distinguish individual resources that share a tag key

nrnList

The following describes nrnList.

Field Type Required Description
nrn String Required NAVER Cloud Platform resource identification value

Request example

The request example is as follows:

curl --location --request POST 'https://resourcemanager.apigw.ntruss.com/api/v1/resource-tags' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
          "nrnList": [ 
        	"nrn:PUB:SecureZone:KR:****:Member/Standard/****"
          ],
          "tagKey": "tag04",
          "tagValue": "tag04-01"      
}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field Type Required Description
success Boolean - Whether the response was successful
  • true | false
    • true: success
    • false: failure
error Object - Error code and message
  • Displayed if success is false
error.errorCode Integer - Error code
error.message String - Error message

Response example

The response example is as follows:

{
  "success": "true",
}