Updated on 2026-09-20 GMT+08:00

Synchronizing Agent Information of Resources in On-premises IDCs

Function

This API is used to synchronize Agent information from on-premises IDCs when you manage such resources in COC.

URI

POST /v1/other-resources/uniagent/sync

Request Parameters

**Table 1** Request body parameters
Parameter	Mandatory	Type	Description
resource_infos	No	Array of resource_infos objects	Definition Select the resource information corresponding to the resource to be synchronized. Constraints N/A Range The list contains 1 to 100 items. Default value N/A
vendor	No	String	Definition Cloud vendor. Constraints N/A Range When Huawei Cloud resources are synchronized, this parameter can be left blank. When Alibaba Cloud resources are synchronized, ALI is used. Default value The value is a string. It contains 1 to 64 characters.

**Table 2** resource_infos
Parameter	Mandatory	Type	Description
region_id	No	String	Definition ID of the region to which the resource belongs. Constraints N/A Range The value is a string. It contains 0 to 64 characters. Default value N/A
resource_id	No	String	Definition ID of the resource selected by the user. Constraints N/A Range The value is a string. It contains 36 characters. Default value N/A
id	No	String	Definition ID of the resource stored in COC-CMDB. Constraints N/A Range N/A Default value N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
data	String	Definition Task ID. Range N/A

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code. Range The value is a string. It contains 8 to 36 characters.
error_msg	String	Definition Error description. Range The value is a string. It contains 2 to 512 characters.

Example Requests

Synchronize the agent information of resources in on-premises IDCs.

POST https://{Endpoint}/v1/other-resources/uniagent/sync

{
  "resource_infos" : [ {
    "region_id" : "string",
    "agent_id" : null,
    "id" : "67e24aa6acb0972ab0272e97"
  } ]
}

Example Responses

Status code: 200

Agent information of resources in on-premises IDCs is synchronized.

{
  "data" : "ed0e78ed-91ee-4ef1-ad9f-39daea9cd352"
}

Status Codes

Status Code	Description
200	Agent information of resources in on-premises IDCs is synchronized.
400	Failed to synchronize the agent information of resources in on-premises IDCs.

Error Codes

See Error Codes.

Parent topic: IDC Resource Configuration