tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Cloud Object Storage
    Documentation
    Download PDF

    GET Bucket replication

    Last updated: 2024-03-28 18:12:17
    Download PDF

      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.
      

      Requests

      Request example

      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, <BucketName-APPID> is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and <Region> is a COS region (see Regions and Access Endpoints).
      Authorization: Auth String (See Request Signature for details.)

      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/<OwnerUin>:uin/<SubUin></Role>
          <Rule>
              <Status></Status>
              <ID></ID>
              <Prefix></Prefix>
              <Destination>
                  <Bucket>qcs::cos:<Region>::<BucketName-APPID></Bucket>
                  <StorageClass></StorageClass>
              </Destination>
              <DeleteMarkerReplication>
                  <Status></Status>
              </DeleteMarkerReplication>
          </Rule>
      </ReplicationConfiguration>
      The nodes are described as follows:
      Node Name (Keyword)
      Parent Node
      Description
      Type
      ReplicationConfiguration
      None
      All replication configurations
      Container
      Role
      ReplicationConfiguration
      Request initiator identifier, formatted as qcs::cam::uin/&lt;OwnerUin>:uin/&lt;SubUin>
      String
      Rule
      ReplicationConfiguration
      Specific configuration. You can set a maximum of 1,000 rules, which should apply to the same destination bucket
      Container
      ID
      ReplicationConfiguration.Rule
      Name of a specific rule
      String
      Status
      ReplicationConfiguration.Rule
      Rule status identifier. Enumerated values: Enabled, Disabled
      String
      Prefix
      ReplicationConfiguration.Rule
      Prefix matching policy. Policies cannot overlap; otherwise, an error will be returned. To match the root directory, leave this parameter empty.
      String
      Destination
      ReplicationConfiguration.Rule
      Destination bucket information
      Container
      Bucket
      ReplicationConfiguration.Rule.Destination
      Resource identifier, formatted as qcs::cos:[region]::[BucketName-APPID]
      String
      StorageClass
      ReplicationConfiguration.Rule.Destination
      Storage class. Enumerated values: STANDARD, INTELLIGENT_TIERING, STANDARD_IA, ARCHIVE, DEEP_ARCHIVE. Defaults to the storage class of the source bucket.
      String
      DeleteMarkerReplication
      ReplicationConfiguration.Rule
      Whether to sync the delete marker
      Container
      Status
      ReplicationConfiguration.Rule. DeleteMarkerReplication
      Whether to sync the delete marker. Valid values: Disabled, Enabled. Default value: Enabled.
      String

      Error codes

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

      Examples

      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>
      
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy