You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

GetBucketReplication

最近更新时间：2024.01.15 15:20:45

首次发布时间：2023.03.14 21:02:15

我的收藏

此接口用于用于获取指定存储桶（Bucket）当前的数据复制进度、跨区域复制规则或同区域复制规则。

请求消息样式

GET /?replication&progress&rule-id=1 HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称

位置

参数类型

是否必选

示例值

说明

replication

Query

String

是

-

代表 GetBucketReplication 请求的特殊标识。

progress

Query

String

否

progress

是否查询桶的数据复制进度，需与 rule-id 参数一起使用。

rule-id

Query

String

否

1

查询复制进度的规则编号，需与 progress 参数一起使用。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称

参数类型

示例值

说明

Role

String

ServiceRoleforReplicationAccessTOS

角色名称。

Rules

Array

-

复制规则。

ID

String

1

规则的唯一标识符。

Status

String

Enabled

指定是否启用该规则，取值说明如下：

  • Enabled：启用该规则。
  • Disabled：不启用该规则。

PrefixSet

Array

prefix_1

适用该规则的对象名前缀。

Destination

Object

-

保存目标 Bucket 信息。

Bucket

String

Target Bucket Name

存储被规则标识的对象副本的桶名称。

Location

String

cn-beijing

目标桶所在的地域。

StorageClass

String

STANDARD

指定复制到目标存储桶的对象的存储类型，取值说明如下：

  • STANDARD：标准存储。
  • STANDARD_IA：低频存储。
  • GLACIER_IR: 归档闪回存储。
  • INTELLIGENT_TIERING： 智能分层存储。
  • ARCHIVE：归档存储。
  • COLD_ARCHIVE：冷归档存储。
  • DEEP_COLD_ARCHIVE：深度冷归档存储

说明

如果同时设置了 StorageClass 和 StorageClassInheritDirective 参数，优先根据 StorageClass指定的值设置对象的存储类型。

StorageClassInheritDirective

String

DESTINATION_BUCKET

设置复制到目标存储桶的对象存储类型，取值说明如下：

  • SOURCE_OBJECT：继承源桶对象的存储类型。
  • DESTINATION_BUCKET：继承目标存储桶的默认存储类型。

HistoricalObjectReplication

String

Enabled

是否开启复制历史对象，如果开启，会复制符合这条规则的历史对象，取值说明如下：

  • Enabled：开启复制历史对象。
  • Disabled：不开启复制历史对象。

Progress

Object

-

保存复制的进度。

NewObject

String

2015-09-24T15:28:14.000Z

显示数据复制到目标桶的时间点。

HistoricalObject

float64

0.99

显示已复制历史数据的百分比。

请求示例

GET /?replication&progress&rule-id=1 HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2021 13:53:55 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
Content-Length: 643

{
    "Role": "Your role",
    "Rules":[{
        "ID": "1",
        "Status": "Enabled",
        "PrefixSet": ["prefix_1", "prefix_2"],
        "Destination":{
            "Bucket":"Target Bucket Name",
            "Location": "Target Bucket Location",
            "StorageClass": "STANDARD"
        },
        "HistoricalObjectReplication": "Enabled",
        "Progress":{
            "NewObject": "2015-09-24T15:28:14.000Z",
            "0.99"
        }
    }]
}