Adds a share to an express synchronization group.

When you call the operation, take note of the following information:

  • Make sure that you have created an express synchronization group. You can create an express synchronization group by calling the CreateExpressSync operation. The express synchronization group and share must use the same Object Storage Service (OSS) bucket.
  • The GatewayShares parameter is required.

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 parameters

Parameter Type Required Example Description
Action String Yes AddSharesToExpressSync

The operation that you want to perform. Set the value to AddSharesToExpressSync.

ExpressSyncId String Yes sync-0001xv7je357xn8tr***

The ID of the express synchronization group.

GatewayShares String Yes {"gw-000gwgp0j3jp8cb3t***":"share1,share2","gw-0001b2otnkdzte62j***":"weekly"}

The name of the share. Specify the value in the JSON format.

  • Example: {"Gateway ID1":"Share 1, Share 2","Gateway ID2":"Share 1, Share 2"}

Response parameters

Parameter Type Example Description
RequestId String 1EDBC004-6B1C-4511-ACF5-0B4875BA3887

The ID of the request.

Success Boolean true

Indicates whether the request is successful.

Code String 200

The HTTP status code. If the request is successful, 200 is returned.

Message String successful

The description of the status code.

TaskId String t-0001xv7je357xr6ql***

The ID of the task.

Examples

Sample requests

http(s)://[Endpoint]/?Action=AddSharesToExpressSync
&ExpressSyncId=sync-0001xv7je357xn8tr***
&GatewayShares={"gw-000gwgp0j3jp8cb3t***":"share1,share2","gw-0001b2otnkdzte62j***":"weekly"}
&<Common request parameters>

Sample success responses

XML format 

<AddSharesToExpressSyncResponse>
      <TaskId>t-0001xv7je357xr6ql***</TaskId>
      <Message>successful</Message>
      <RequestId>1EDBC004-6B1C-4511-ACF5-0B4875BA3887</RequestId>
      <Code>200</Code>
      <Success>true</Success>
</AddSharesToExpressSyncResponse>

JSON format 

{
    "TaskId":"t-0001xv7je357xr6ql***",
    "Message":"successful",
    "RequestId":"1EDBC004-6B1C-4511-ACF5-0B4875BA3887",
    "Code":"200",
    "Success":true
}

Error codes

HttpCode Error code Error message Description
400 EmptyExpressSyncId You must specify a valid ID for the sync group. The error message returned because the ID of the express synchronization group is not specified.
400 ExpressSyncNotExist The specified sync group does not exist. You must specify a valid parameter. The error message returned because the specified express synchronization group does not exist. Check whether the parameters are valid.
400 ExpressSyncInOperation The sync group is busy. Try again later. The error message returned because another operation is in progress. Try again later.

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