调用DescribeSharesBucketInfoForExpressSync查询可以创建极速同步组的Bucket信息。只返回创建了共享的OSS区域和Bucket信息。

调试

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

请求参数

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

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

BucketRegion String cn-hangzhou

Bucket 所在地域。为空时查询所有Region下的Bucket信息。

BucketName String bucket***

Bucket 名称。不为空时查询指定Bucket名称下的Bucket信息。

返回数据

名称 类型 示例值 描述
BucketInfos Array of BucketInfo

Bucket信息。

BucketInfo
BucketName String zy-1m***

Bucket 名称。

BucketPrefix String test1

Bucket 子目录。

BucketRegion String cn-hangzhou

Bucket 所在地域。

Code String 200

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

Message String successful

请求结果描述。

RequestId String 29BD52E7-CF30-418F-A240-E15A9351B666

请求ID。

Success Boolean true

请求是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSharesBucketInfoForExpressSync
&<公共请求参数>

正常返回示例

XML格式

<DescribeSharesBucketInfoForExpressSyncResponse>
      <BucketInfos>
            <BucketInfo>
                  <BucketName>zy-1m***</BucketName>
                  <BucketRegion>cn-hangzhou</BucketRegion>
                  <BucketPrefix></BucketPrefix>
            </BucketInfo>
            <BucketInfo>
                  <BucketName>zy-2m***</BucketName>
                  <BucketRegion>cn-hangzhou</BucketRegion>
                  <BucketPrefix></BucketPrefix>
            </BucketInfo>
      </BucketInfos>
      <Message>successful</Message>
      <RequestId>29BD52E7-CF30-418F-A240-E15A9351B666</RequestId>
      <Code>200</Code>
      <Success>true</Success>
</DescribeSharesBucketInfoForExpressSyncResponse>

JSON格式

{
    "BucketInfos":{
        "BucketInfo":[
            {
                "BucketName":"zy-1m***",
                "BucketRegion":"cn-hangzhou",
                "BucketPrefix":""
            },
            {
                "BucketName":"zy-2m***",
                "BucketRegion":"cn-hangzhou",
                "BucketPrefix":""
            }
        ]
    },
    "Message":"successful",
    "RequestId":"29BD52E7-CF30-418F-A240-E15A9351B666",
    "Code":"200",
    "Success":true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidRegionId The specified RegionId does not exist. You must specify a valid RegionId. 指定的RegionId不存在,请您确认该参数是否正确。

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