Updated on 2025-10-24 GMT+08:00

Updating Resource Tags

Function

This API is used to update a resource tag.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    coc:document:update

    Write

    document *

    -

    -

    -

URI

POST /v1/script/{resource_type}/{resource_id}/tags/update

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

resource_id

Yes

String

Resource ID.

resource_type

Yes

String

Resource type.

  • coc:script

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

tags

No

Array of ResourceTag objects

Definition:

Tag array.

Constraints:

N/A.

Value range:

N/A.

Default value:

N/A.

Table 3 ResourceTag

Parameter

Mandatory

Type

Description

key

No

String

Definition:

Tag key.

Constraints:

N/A.

Value range:

N/A.

Default value:

N/A.

value

No

String

Definition:

Tag value.

Constraints:

N/A.

Value range:

N/A.

Default value:

N/A.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

data

String

Definition:

Script ID returned by the system after a script is created.

Value range:

N/A

Example Requests

Update the resource type to the script tag SC202504221542083c8xxx of coc:script.

POST https://{Endpoint}/v1/script/coc:script/SC202504221542083c8xxx/tags/update

{
  "tags" : [ {
    "key" : 122,
    "value" : 122
  } ]
}

Example Responses

Status code: 200

UUID of the created script.

For more status codes, see Status Codes.

{
  "data" : "SC2023102521xxxxxxxxxx"
}

Status Codes

Status Code

Description

200

UUID of the created script.

For more status codes, see Status Codes.

Error Codes

See Error Codes.