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

Transferring Resources

Function

This API is used to move the resources from a group to another group for management.

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:application:updateResources

    Write

    application *

    -

    -

    -

URI

PUT /v1/group-resource-relations

Request Parameters

Table 1 Request body parameters

Parameter

Mandatory

Type

Description

id_list

Yes

Array of strings

Definition:

List of UUIDs associated with resources.

Constraints:

N/A

Value range:

The list contains 0 to 100 items.

Default value:

N/A

group_id

Yes

String

Definition:

ID of the group to which the resource to be transferred belongs.

Constraints:

N/A

Value range:

The value is a string. It contains 24 characters.

Default value:

N/A

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

data

String

Definition:

ID of the group resource allocated by CloudCMDB.

Value range:

N/A

Example Requests

This API is used to transfer resources.

PUT https://{endpoint}/v1/group-resource-relations

{
  "id_list" : [ "687df406705dd42025d32667" ],
  "group_id" : "6811e1855a774958c43bab99"
}

Example Responses

Status code: 200

Resources are transferred.

{
  "data" : [ "687df406705dd42025d32667" ]
}

Status Codes

Status Code

Description

200

Resources are transferred.

Error Codes

See Error Codes.