tencent cloud

フィードバック

Cross-Bucket Replication

最終更新日:2024-02-02 16:24:05

    Overview

    This document provides an overview of APIs and SDK code samples related to bucket copying.
    API
    Operation
    Description
    Setting cross-bucket replication
    Sets a cross-bucket replication rule for a bucket
    Querying cross-bucket replication
    Queries the cross-bucket replication rule of a bucket
    Deleting cross-bucket replication
    Deletes a cross-bucket replication rule of a bucket

    Setting Cross-Bucket Replication

    Description

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

    Method prototype

    public void setBucketReplicationConfiguration(
    SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest)
    throws CosClientException, CosServiceException;

    Sample request

    // Source bucket name, including appid
    String bucketName = "examplebucket-1250000000";
    
    BucketReplicationConfiguration bucketReplicationConfiguration = new BucketReplicationConfiguration();
    // Configure initiator identity in the format: qcs::cam::uin/<OwnerUin>:uin/<SubUin>
    bucketReplicationConfiguration.setRoleName("qcs::cam::uin/100000000001:uin/100000000001");
    
    // Configure the destination bucket and storage class in the QCS format: qcs::cos:[region]::[bucketname-AppId]
    ReplicationDestinationConfig replicationDestinationConfig = new ReplicationDestinationConfig();
    replicationDestinationConfig.setBucketQCS("qcs::cos:ap-beijing::destinationbucket-1250000000");
    replicationDestinationConfig.setStorageClass(StorageClass.Standard);
    
    // Configure the rule status and prefix
    ReplicationRule replicationRule = new ReplicationRule();
    replicationRule.setStatus(ReplicationRuleStatus.Enabled);
    replicationRule.setPrefix("");
    replicationRule.setDestinationConfig(replicationDestinationConfig);
    // Add a rule
    String ruleId = "replication-to-beijing";
    bucketReplicationConfiguration.addRule(replicationRule);
    
    SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest =
    new SetBucketReplicationConfigurationRequest(bucketName, bucketReplicationConfiguration);
    cosClient.setBucketReplicationConfiguration(setBucketReplicationConfigurationRequest);

    Parameter description

    Parameter
    Description
    Type
    bucketName
    Bucket name in the format of BucketName-APPID. For details, see Naming Conventions
    String
    setBucketReplicationConfigurationRequest
    Cross-bucket replication configuration
    SetBucketReplicationConfigurationRequest

    Response description

    Success: No value is returned.
    Failure: If an error (such as authentication failure) occurs, the CosClientException or CosServiceException exception will be thrown. For more information, please see Troubleshooting.

    Querying Cross-Bucket Replication

    Description

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

    Method prototype

    // Method 1 to get the cross-bucket replication configuration of the bucket
    public BucketReplicationConfiguration getBucketReplicationConfiguration(String bucketName)
    throws CosClientException, CosServiceException;
    
    // Method 2 to get the cross-bucket replication configuration of the bucket
    public BucketReplicationConfiguration getBucketReplicationConfiguration(
    GetBucketReplicationConfigurationRequest getBucketReplicationConfigurationRequest)
    throws CosClientException, CosServiceException;

    Sample request

    String bucketName = "examplebucket-1250000000";
    
    // Method 1 to get the cross-bucket replication configuration of the bucket
    BucketReplicationConfiguration brcfRet = cosClient.getBucketReplicationConfiguration(bucketName);
    
    // Method 2 to get the cross-bucket replication configuration of the bucket
    BucketReplicationConfiguration brcfRet2 = cosClient.getBucketReplicationConfiguration(
    new GetBucketReplicationConfigurationRequest(bucketName));

    Parameter description

    Parameter
    Description
    Type
    bucketName
    Bucket name in the format of BucketName-APPID. For details, see Naming Conventions
    String
    getBucketReplicationConfigurationRequest
    Obtaining cross-bucket replication configuration requests
    GetBucketReplicationConfigurationRequest

    Response description

    Success: Returns the cross-bucket replication rule for the bucket.
    Failure: If an error (such as authentication failure) occurs, the CosClientException or CosServiceException exception will be thrown. For more information, please see Troubleshooting.

    Deleting Cross-Bucket Replication

    Description

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

    Method prototype

    // Method 1 to delete the cross-bucket replication configuration of the bucket
    public void deleteBucketReplicationConfiguration(String bucketName)
    throws CosClientException, CosServiceException;
    
    // Method 2 to delete the cross-bucket replication configuration of the bucket
    public void deleteBucketReplicationConfiguration(
    DeleteBucketReplicationConfigurationRequest deleteBucketReplicationConfigurationRequest)
    throws CosClientException, CosServiceException;

    Sample request

    String bucketName = "examplebucket-1250000000";
    
    // Method 1 to delete the cross-bucket replication configuration of the bucket
    cosClient.deleteBucketReplicationConfiguration(bucketName);
    
    // Method 2 to delete the cross-bucket replication configuration of the bucket
    cosClient.deleteBucketReplicationConfiguration(new DeleteBucketReplicationConfigurationRequest(bucketName));

    Parameter description

    Parameter
    Description
    Type
    bucketName
    Bucket name in the format of BucketName-APPID. For details, see Naming Conventions
    String
    deleteBucketReplicationConfigurationRequest
    Deleting cross-bucket replication configuration requests
    DeleteBucketReplicationConfigurationRequest

    Response description

    Success: No value is returned.
    Failure: If an error (such as authentication failure) occurs, the CosClientException or CosServiceException exception will be thrown. For more information, please see Troubleshooting.
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)