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 common request headers. For more information, see the topic about common request parameters.

Request syntax

GET /pop/v5/resource/pop_sync_resource HTTP/1.1

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 when you set the Type parameter to ecs. If 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 returned message that indicates whether the call is successful.

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

The unique ID of the request.

Success Boolean true

Indicates whether the resources are synchronized. Valid values:

  • true: The resources are synchronized.
  • false: The resources fail to be synchronized.

Examples

Sample requests

GET /pop/v5/resource/pop\_sync\_resource HTTP/1.1
Common request headers
{
  "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.

Usage notes

When you call this operation, you may encounter the timeout issue when you connect to the OpenAPI Developer Portal 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 OpenAPI Developer Portal. We recommend that you set the timeout period to 30 seconds. This is because the time limit for service processing between the OpenAPI Developer Portal and the server is 30 seconds.

  • If you use 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 client to wait for the OpenAPI Developer Portal to return data for the call to the API operation. Unit: milliseconds. 
    request.setType("ecs");
    ........
    
  • If you use 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')