You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/API 参考/存储桶/存储桶复制/GetBucketReplication
GetBucketReplication
最近更新时间：2024.08.21 17:46:59首次发布时间：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

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

Tags

Array

-

TOS 可针对有特定标签的 Object 进行复制，最多可配置 10 个标签。关于标签的详细说明，请参见文件标签管理。

Key

String

key

对象标签的键。
父节点：Tags

Value

String

value

对象标签的值。
父节点：Tags

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：不开启复制历史对象。

TransferType

String

tos_acc

数据复制时使用的数据传输链路，取值说明如下：

  • internal：TOS 默认传输链路。该链路仅允许在中国内地和中国内地之间进行跨区域复制数据时使用。
  • tos_acc：传输加速链路。该链路仅允许在中国内地和中国内地以外地区之间进行跨区域复制数据时使用。

关于传输加速的详细介绍，请参见传输加速。

AccessControlTranslation

Object

-

对象的所有者管理权限。

说明

仅跨账号复制对象时，会返回 AccessControlTranslation 参数，如果存储桶使用的是跨账号复制功能，但是没有返回 AccessControlTranslation 参数，说明没有授予目的存储桶复制的对象所有者管理权限，即目标存储桶所有者可以覆盖和删除对象，但是不能读取对象，也不能授予其他账号读取对象的权限。

Owner

String

BucketOwnerEntrusted

已授予目的存储桶复制的对象所有者管理权限，即目的存储桶拥有读取对象，授予其他账号读取对象的权限。

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": "ServiceRoleforReplicationAccessTOS",
    "Rules":[{
        "ID": "1",
        "Status": "Enabled",
        "PrefixSet": ["prefix_1", "prefix_2"],
        "Destination":{
            "Bucket":"Target Bucket Name",
            "Location": "Target Bucket Location",
            "StorageClass": "STANDARD"
        },
        "HistoricalObjectReplication": "Enabled",
        "AccessControlTranslation": {
                "Owner": "BucketOwnerEntrusted"
        },
        "Progress":{
            "NewObject": "2015-09-24T15:28:14.000Z",
            "NewObject": "0.99"
        }
    }]
}