获取复制的目标区域(2022.12.15后开放使用)
更新时间 2025-06-11 14:55:22
最近更新时间: 2025-06-11 14:55:22
接口介绍
获取可复制到的目标存储空间所在的地域。
接口约束
支持的线上资源池 ：上海32<->杭州2、上海7<->杭州2
URI
GET /v4/oss/get-bucket-replication-region
请求参数
请求 Query 参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 区域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回码 取值范围：800 成功 |
800 |
| message | String | 状态描述 | SUCCESS |
| description | String | 状态描述，一般为中文 | 成功 |
| returnObj | Array of Objects | 响应对象 | 见下级对象 |
| errorCode | String | 业务细分码（仅失败时具有此参数），为product.module.code三段式码 | openapi.userPermission.accessFailed |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| regionID | String | 区域ID | 22f08348-ebbf-11ec-b70d-00505689ac50 |
| regionName | String | 区域名 | 贵州公测私有云 |
| num | Integer | 数量 | 3 |
| buckets | Array of string | 桶名的数组 | ["bucket1", "bucket2", "bucket3"] |
请求示例
GET https://zos-global.ctapi.ctyun.cn/v4/oss/get-bucket-replication-region?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0
响应示例
{
"returnObj": [
{
"regionID": "22f08348-ebbf-11ec-b70d-00505689ac50",
"regionName": "贵州公测私有云",
"num": 3,
"buckets": [
"bucket1",
"bucket2",
"bucket3"
]
},
{
"regionID": "12348348-ebbf-11ec-b70d-005056895678",
"regionName": "XX公测私有云",
"num": 2,
"buckets": [
"bucket3",
"bucket4"
]
}
],
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功。 |
| 900 | 表示请求失败。 |
错误码
errorCode 枚举值，见错误码总表
