调用AddSharesToExpressSync可以添加指定的共享到极速同步组中。

调用该接口时,您需要注意:

  • 请确认您已创建极速同步组。如果还未创建,您可以通过CreateExpressSync创建极速同步组,且同步组的Bucket必须与共享的Bucket相同。
  • 如果您传入的共享名称为空,请求将被忽略。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddSharesToExpressSync

系统规定参数。取值:AddSharesToExpressSync。

ExpressSyncId String sync-0001xv7je357xn8tr***

极速同步组ID。

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

网关共享名称。可以添加多个共享,JSON格式为:

  • {"网关ID1":"共享1,共享2","网关ID2":"共享1,共享2"}

返回数据

名称 类型 示例值 描述
RequestId String 1EDBC004-6B1C-4511-ACF5-0B4875BA3887

请求ID。

Success Boolean true

请求是否成功。

Code String 200

状态码。状态码为200表示请求成功。

Message String successful

请求结果描述。

TaskId String t-0001xv7je357xr6ql***

任务ID。

示例

请求示例

http(s)://[Endpoint]/?Action=AddSharesToExpressSync
&ExpressSyncId=sync-0001xv7je357xn8tr***
&GatewayShares={"gw-000gwgp0j3jp8cb3t***":"share1,share2","gw-0001b2otnkdzte62j***":"weekly"}
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
400 EmptyExpressSyncId You must specify a valid ID for the sync group. 极速同步组ID不能为空。
400 ExpressSyncNotExist The specified sync group does not exist. You must specify a valid parameter. 极速同步组不存在,请确认输入参数是否正确。
400 ExpressSyncInOperation The sync group is busy. Try again later. 极速同步组正在进行操作中,请稍后再试。

访问错误中心查看更多错误码。