该接口用于获取 Bucket 的跨区域复制规则列表。山河云对象存储定义只有 Bucket 的所有者才能调用该 API。

请求语法

GET /?replication HTTP/1.1
Host: <bucket-name>.<zone_id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

无。

请求头

此接口仅包含公共请求头。关于公共请求头的更多信息，请参见公共请求头。

请求消息体

无。

响应头

此接口仅包含公共响应头。关于公共响应头的更多信息，请参见公共响应头。

响应体

成功调用该 API 后，会返回一个 Json 格式的 Response Body。该 Response Body 包括如下两个部分：

  • 前期设置的跨区域复制（Replication）规则，这部分可参考 PUT Bucket Replication。

  • 跨区域复制规则中目标 Bucket 所在的 Zone ID，这部分为 GET Bucket Replication 特有的 Response Body。详情如下：

名称 类型 说明

zone

String

目标 Bucket 所在的 Zone ID。

错误码

错误码 错误描述 HTTP 状态码

OK

成功获取跨区域复制（Replication）规则列表

200

其他错误码可参考错误码列表。

示例

请求示例

GET /?replication HTTP/1.1
Host: my-bucket.jn1.is.shanhe.com
Date: Mon, 1 Oct 2018 15:04:01 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Server: QingStor
Date: Mon, 1 Oct 2018 15:04:01 GMT
Content-Length: 193
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b

{
    "rules": [
        {
            "id": "replicatin-1",
            "status": enabled,
            "filters": {
                "prefix": "image"
            },
            "sync_marker": "disabled",
            "delete_marker": "disabled",
            "destination": {
                "zone": "pek3b",
                "bucket": "replicate-bucket-1",
                "storage_class": "standard_ia",
            },
        },
        {
            "id": "replicatin-2",
            "status": enabled,
            "filters": {
                "prefix": "videos/"
            },
            "sync_marker": "enabled"
            "delete_marker": "enabled",
            "destination": {
                "zone": "pek3b",
                "bucket": "replicate-bucket-1",
                "storage_class": "standard",
            },
        },
    ]
}

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。