tencent cloud

文档反馈

版本控制

最后更新时间:2024-01-19 15:33:39

    简介

    本文档提供关于版本控制的 API 概览以及 SDK 示例代码。
    API
    操作名
    操作描述
    设置版本控制
    设置存储桶的版本控制功能
    查询版本控制
    查询存储桶的版本控制信息

    设置版本控制

    功能说明

    设置指定存储桶的版本控制功能(PUT Bucket versioning)。

    方法原型

    public void setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest setBucketVersioningConfigurationRequest)
    throws CosClientException, CosServiceException;

    参数说明

    参数名称
    描述
    类型
    setBucketVersioningConfigurationRequest
    版本控制配置
    SetBucketVersioningConfigurationRequest

    返回结果说明

    成功:无返回值。
    失败:发生错误(如身份认证失败),抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理

    请求示例

    开启版本控制
    String bucketName = "examplebucket-1250000000";
    // 开启版本控制
    cosClient.setBucketVersioningConfiguration(
    new SetBucketVersioningConfigurationRequest(bucketName,
    new BucketVersioningConfiguration(BucketVersioningConfiguration.ENABLED)));
    暂停版本控制
    String bucketName = "examplebucket-1250000000";
    // 暂停版本控制
    cosClient.setBucketVersioningConfiguration(
    new SetBucketVersioningConfigurationRequest(bucketName,
    new BucketVersioningConfiguration(BucketVersioningConfiguration.SUSPENDED)));

    查询版本控制

    功能说明

    查询指定存储桶的版本控制信息(GET Bucket versioning)。

    方法原型

    // 方法1 传入存储桶名称即可
    public BucketVersioningConfiguration getBucketVersioningConfiguration(String bucketName)
    throws CosClientException, CosServiceException;
    
    // 方法2 通过GetBucketVersioningConfigurationRequest 获取
    public BucketVersioningConfiguration getBucketVersioningConfiguration(
    GetBucketVersioningConfigurationRequest getBucketVersioningConfigurationRequest)
    throws CosClientException, CosServiceException;

    请求示例

    String bucketName = "examplebucket-1250000000";
    // 获取版本控制
    BucketVersioningConfiguration bvc =
    cosClient.getBucketVersioningConfiguration(bucketName);
    // 获取版本控制
    BucketVersioningConfiguration bvc2 = cosClient.getBucketVersioningConfiguration(
    new GetBucketVersioningConfigurationRequest(bucketName));

    参数说明

    参数名称
    描述
    类型
    bucketName
    存储桶的命名格式为 BucketName-APPID,详情请参见 命名规范
    String
    getBucketVersioningConfigurationRequest
    获取版本控制配置请求
    GetBucketVersioningConfigurationRequest

    返回结果说明

    成功:返回存储桶的多版本配置。
    失败:发生错误(如身份认证失败),抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持