调用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格式为:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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. | 极速同步组正在进行操作中,请稍后再试。 |
访问错误中心查看更多错误码。