Interface Description

This interface is used to get all replication synchronization rules of the bucket.

Request

• Request syntax

  GET /?replication&list HTTP/1.1
  Host: <BucketName>.bj.bcebos.com
  Date: <GMT Date>
  Authorization: AuthorizationString

• Request header field

  No special parameters.

• Request parameters

  No special parameters.

Response

• Response element

  Parameters	Description
  rules	Replication rule list
  +id	Replication rule name
  +status	Effective?
  +resource	Replication effective prefix
  +destination	Replicated destination configuration
  ++bucket	Destination bucket name
  ++storageClass	Storage type of the destination object. If the storage type is consistent with that of the source bucket, this parameter is empty. STANDARD represents the standard storage, STANDARD_IA represents the infrequent access, and COLD represents the cold storage. If it is a multi-AZ bucket, MAZ_STANDARD_IA represents the multi-AZ infrequent access, MAZ_STANDARD represents the multi-AZ standard storage and cannot be other values.
  +replicateHistory	Historical file replication. If such item exists, it is considered as “Enabled”.
  ++storageClass	Storage type of the destination object, which is REMAIN by default and can be STANDARD, STANDARD_IA, COLD, MAZ_STANDARD or MAZ_STANDARD_IA.
  +replicateDeletes	Is the synchronous deletion enabled? It can be enabled or disabled.
  +create_time	Replication rule creation time
  +destRegion	Destination region

• Response header field

  No special parameters.

Example

• Request example

  GET /?replication&list HTTP/1.1
  Host: BucketName.bj.bcebos.com
  Date: Thu, 15 May 2017 00:17:23 GMT
  Authorization: AuthorizationString

• Response example

  HTTP/1.1 200 OK
  Date: Thu, 15 May 2017 00:17:23 GMT
  Server: BceBos
  x-bce-request-id: xxxx-xxxxx-xxxx
  Connection: keep-alive
  Content-Length: xxx
  
  {
     "rules": [
         {
             "status": "enabled",
             "resource": [
                 "src-bucket-name/abc",
                 "src-bucket-name/cd*"
             ],
             "destination": {
                 "bucket": "dst-bucket-name",
                 "storageClass": "COLD"
             },
             "replicateHistory": {
                 "storageClass": "COLD"
             },
             "replicateDeletes": "enabled",
             "id": "sample-bucket-replication-config",
             "create_time: 1583060606,
             "destRegion":"bj"
         }
     ]
  }