tencent cloud


PUT Bucket replication

Terakhir diperbarui:2023-04-12 14:25:11


    This API is used to add a cross-bucket replication rule to a versioning-enabled bucket. Note that the existing cross-bucket replication rule (if any) will be overwritten.


    • To use this API, ensure that versioning is enabled for the bucket. For the API documentation of versioning, please see PUT Bucket versioning.
    • Objects in MAZ buckets cannot be replicated to an OAZ bucket. For example, objects in MAZ_STANDARD cannot be replicated to STANDARD.
    API Explorer (recommended)
    Tencent Cloud API Explorer makes it easy for you to make online API calls, verify signatures, generate SDK code, and search for APIs. You can use it to query the request and response of each API call and generate sample SDK codes for the call.


    Request example

    PUT /?replication HTTP/1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: GMT Date
    Content-MD5: MD5
    Authorization: Auth String
    request body

    Request headers

    This API only uses Common Request Headers.

    Request body

    You can set the cross-bucket replication configuration in the request body, which includes the rule status, priority, objects to replicate, filter scope, name and region of the destination bucket, and more.


    The nodes are described as follows:

    Node Name (Keyword) Parent Node Description Type Required
    ReplicationConfiguration None All replication configurations Container Yes
    Role ReplicationConfiguration Request initiator identifier, formatted as qcs::cam::uin/<owneruin>:uin/<subuin> String Yes
    Rule ReplicationConfiguration Specific configuration. You can set a maximum of 1,000 rules. Container Yes
    ID ReplicationConfiguration.Rule Name of a specific rule String No
    Status ReplicationConfiguration.Rule Rule status identifier. Enumerated values: Enabled, Disabled. String Yes
    Prefix ReplicationConfiguration.Rule Prefix of the object to be replicated String No
    Destination ReplicationConfiguration.Rule Destination bucket information Container Yes
    Bucket ReplicationConfiguration.Rule.Destination Resource identifier, formatted as
    String Yes
    DeleteMarkerReplication ReplicationConfiguration.Rule Whether to sync the delete marker Container No
    Status ReplicationConfiguration.Rule. DeleteMarkerReplication Whether to sync the delete marker. Valid values: Disabled, Enabled. Default value: Enabled. String No


    Response headers

    This API only returns Common Response Headers.

    Response body

    The response body is empty.

    Error codes

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



    The following request adds a cross-bucket replication rule to the originbucket-1250000000 bucket. The ReplicationConfiguration specifies that all objects prefixed with testPrefix are to be replicated to the destinationbucket-1250000000 destination bucket in Guangzhou region.

    PUT /?replication HTTP/1.1
    Date: Mon, 28 Aug 2017 02:53:38 GMT
    Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1503888878;1503889238&q-key-time=1503888878;1503889238&q-header-list=host&q-url-param-list=replication&q-signature=254bf9cd3d6615e89a36ab652437f9d45c5f****
    Content-MD5: AAq9nzrpsz5LJ4UEe1f6Q==
    Host: originbucket-1250000000.cos.ap-guangzhou.myqcloud.com
    Content-Length: 312


    After the request above is made, COS returns the following response, indicating that the cross-bucket replication rule has been successfully configured.

    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 0
    Connection: keep-alive
    Date: Fri, 14 Apr 2019 07:06:19 GMT
    Server: tencent-cos
    x-cos-bucket-region: ap-guangzhou
    x-cos-request-id: NWQwMzQ3NmJfMjRiMjU4NjRfOTM4NV82ZDU1****

    Hubungi Kami

    Hubungi tim penjualan atau penasihat bisnis kami untuk membantu bisnis Anda.

    Dukungan Teknis

    Buka tiket jika Anda mencari bantuan lebih lanjut. Tiket kami tersedia 7x24.

    Dukungan Telepon 7x24