tencent cloud

Overview

This document provides an overview of APIs and SDK code samples for cross-region replication.

Setting Cross-region Replication Rules

Feature description

This API (PUT Bucket replication) is used to set the cross-bucket replication rule for a bucket.

Method prototype

public Guzzle\Service\Resource\Model putBucketReplication(array $args = array());

Sample request

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //Replace it with the actual `SecretId`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //Replace it with the actual `SecretKey`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //Replace it with the actual `region`, which can be viewed in the console at https://console.intl.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol header, which is http by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  $result = $cosClient->putBucketReplication(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-APPID`, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
      'Role' => 'qcs::cam::uin/100000000001:uin/100000000001',
      'Rules'=>array(
          array(
              'Status' => 'Enabled',
              'ID' => 'string',
              'Prefix' => 'string',
              'Destination' => array(                    
                  'Bucket' => 'qcs::cos:ap-beijing::destinationbucket-1250000000',
                  'StorageClass' => 'standard',                
              ),  
              // ...repeated            ),  
      ),      
  ))); 
  // Request succeeded   print_r($result);
} catch (\Exception $e) {    // Request failed
  echo "$e\n";
}

Parameter description

Querying Cross-region Replication Rules

Feature description

This API (GET Bucket replication) is used to query the cross-bucket replication rule of a bucket.

Method prototype

public Guzzle\Service\Resource\Model getBucketReplication(array $args = array());

Sample request

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //Replace it with the actual `SecretId`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //Replace it with the actual `SecretKey`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //Replace it with the actual `region`, which can be viewed in the console at https://console.intl.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol header, which is http by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  $result = $cosClient->getBucketReplication(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-APPID`, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
  )); 
  // Request succeeded
  print_r($result);
} catch (\Exception $e) {
  // Request failed
  echo "$e\n";
}

Parameter description

Sample response

Guzzle\Service\Resource\Model Object
(
  [data:protected] => Array
      (
          [Role] => qcs::cam::uin/100000000001:uin/100000000001
          [Rules] => Array
              (
                  [0] => Array
                      (
                          [ID] => string
                          [Status] => Enabled
                          [Prefix] => string
                          [Destination] => Array
                              (
                                  [Bucket] => qcs::cos:ap-guangzhou::examplebucket2-1250000000
                                  [StorageClass] => 
                              )
                      )
              )
          [RequestId] => NWQwOGI5MGVfNWFiMjU4NjRfNDUzY19mNzRh****
      )
)

Response description

Deleting Cross-region Replication Rules

Feature description

This API (DELETE Bucket replication) is used to delete the cross-bucket replication rule from a bucket.

Method prototype

public Guzzle\Service\Resource\Model deleteBucketReplication(array $args = array());

Sample request

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //Replace it with the actual `SecretId`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //Replace it with the actual `SecretKey`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //Replace it with the actual `region`, which can be viewed in the console at https://console.intl.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol header, which is http by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
          
try {
  $result = $cosClient->deleteBucketReplication(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-APPID`, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
  )); 
  // Request succeeded
  print_r($result);
} catch (\Exception $e) {
  // Request failed
  echo "$e\n";
}

Parameter description