tencent cloud

Overview

This API is used to query the cross-bucket replication configuration of a bucket. When calling this API, you need to carry a request signature.

Request

Sample request

GET /?replication HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

Note：

• In Host: <bucketname-appid>.cos.<region>.myqcloud.com, is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and is a COS region (see Regions and Access Endpoints).
• Authorization: Auth String (see Request Signature for more information).

Request headers

This API only uses Common Request Headers.

Request body

The request body of this request is empty.

Response

Response headers

This API only returns Common Response Headers.

Response body

The response body returns application/xml data. The following contains all the nodes:

<ReplicationConfiguration>
  <Role>qcs::cam::uin/[UIN]:uin/[Subaccount]</Role>
  <Rule>
      <Status></Status>
      <ID></ID>
      <Prefix></Prefix>
      <Destination>
          <Bucket>qcs::cos:[Region]::[BucketName-APPID]</Bucket>
      </Destination>
  </Rule>
</ReplicationConfiguration>

The nodes are described as follows:

Error codes

This API returns common error responses and error codes. For more information, please see Error Codes.

Sample

Request

The following example queries the configuration of the originbucket-1250000000 bucket:

GET /?replication HTTP/1.1
Date: Fri, 14 Apr 2019 07:17:19 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98JM&q-sign-time=1503895278;1503895638&q-key-time=1503895278;1503895638&q-header-list=host&q-url-param-list=replication&q-signature=f77900be432072b16afd8222b4b349aabd837cb9
Host: originbucket-1250000000.cos.ap-guangzhou.myqcloud.com
Content-Length: 0

Response

After the request above is made, COS returns the following response, indicating that the cross-bucket replication configuration of the bucket is enabled. The ReplicationConfiguration indicates that all objects prefixed with testPrefix in the originbucket-1250000000 bucket are to be replicated. Storage classes of the replicated objects are subject to those of the source bucket.

Content-Type: application/xml
Content-Length: 309
Connection: keep-alive
Date: Fri, 14 Apr 2019 07:17:19 GMT
Server: tencent-cos
x-cos-replication-rule-creation-time: Fri, 14 Apr 2019 07:06:19 GMT
x-cos-request-id: NWQwMzQ5ZmZfMjBiNDU4NjRfNjAwOV84MzA2****
<ReplicationConfiguration>
  <Role>qcs::cam::uin/100000000001:uin/100000000001</Role>
  <Rule>
      <Status>Enabled</Status>
      <ID>RuleId_01</ID>
      <Prefix>testPrefix</Prefix>
      <Destination>
          <Bucket>qcs::cos:ap-guangzhou::destinationbucket-1250000000</Bucket>
      </Destination>
  </Rule>
</ReplicationConfiguration>