Overview

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

Setting Cross-Region Replication

Feature description

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

Method prototype

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

Sample request

try {
    $result = $cosClient->putBucketReplication(array(
        'Bucket' => 'examplebucket-1250000000', // Format: BucketName-APPID
        '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

Feature description

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

Method prototype

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

Sample request

try {
    $result = $cosClient->getBucketReplication(array(
        'Bucket' => 'examplebucket-1250000000', // Format: BucketName-APPID
    )); 
    // Request succeeded
    print_r($result);
} catch (\Exception $e) {
    // Request failed
    echo "$e\n";
}

Parameter description

Sample return result

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****
        )
)

Returned result description

Deleting Cross-Region Replication

Feature description

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

Method prototype

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

Sample request

try {
    $result = $cosClient->deleteBucketReplication(array(
        'Bucket' => 'examplebucket-1250000000', // Format: BucketName-APPID
    )); 
    // Request succeeded
    print_r($result);
} catch (\Exception $e) {
    // Request failed
    echo "$e\n";
}

Parameter description