Synchronizes the basic Alibaba Cloud resources that belong to your account to Enterprise Distributed Application Service (EDAS). This operation is applicable to Elastic Compute Service (ECS) clusters.

If you call this operation to synchronize ECS resource information, all instance data is synchronized from ECS. If you have more than 100 ECS instances, we recommend that you do not frequently call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only the common request header. For more information, see Common request parameters.

Request syntax

GET /pop/v5/resource/pop_sync_resource HTTPS|HTTP

Request parameters

Parameter Type Position Required Example Description
Type String Query Yes ecs

The type of the resource to be synchronized. Valid values: ecs, slb, vpc, ram, and all. These values are case-sensitive.

ResourceIds String Query No i-bp17c***5q8x,i-bp1**5q8x

The ID of the resource. This parameter is required only if the Type parameter is set to ecs. When you specify multiple IDs, separate them with commas (,). You can synchronize up to 50 resources at a time.

Response parameters

Parameter Type Example Description
Code Integer 200

The HTTP status code.

Data String PopSyncResource success

The data returned for the request.

Message String success

The message returned for the request.

RequestId String F8DFGED-K98***************

The ID of the request.

Success Boolean true

The request result. Valid values:

  • true: success
  • false: failure

Examples

Sample requests

GET /pop/v5/resource/pop\_sync\_resource HTTP/1.1
Common request parameters
{
  "Type": ""
}

Sample success responses

XML format

<Message>success</Message>
<Data>PopSyncResource success</Data>
<Code>200</Code>
<Success>true</Success>

JSON format

{
	"Message": "success",
	"Data": "PopSyncResource success",
	"Code": 200,
	"Success": true
}

Error codes

For a list of error codes, visit the API Error Center.

Notes

In real scenarios of calling this operation, you may encounter the timeout issue when you connect to the Point of Presence (POP) API gateway from a client. The default timeout period is 10 seconds. To resolve this issue, before you call this operation, you must manually set the timeout period for reading the data returned by the POP API gateway. We recommend that you set the timeout period to 30 seconds. This is because the time limit for service processing between the POP API gateway and the server is 30 seconds.

  • If you use Alibaba Cloud EDAS SDK for Java and call this operation in the client code, you can set the read timeout period in the following way:
    
    SynchronizeResourceRequest request = new SynchronizeResourceRequest();
    request.setSysReadTimeout(30000);  // The timeout period for the API client to wait for the POP API gateway to return data. Unit: milliseconds.
    request.setType("ecs");
    ........
    
  • If you use Alibaba Cloud EDAS SDK for Python and call this operation in the client code, you can set the read timeout period in the following way:
    
    request = SynchronizeResourceRequest()
    request.set_read_timeout(30000)
    request.set_Type('ecs')