文档首页> 对象存储服务 OBS> C > 管理桶> 获取桶存量信息
更新时间:2023-11-09 GMT+08:00

获取桶存量信息

开发过程中,您有任何问题可以在github上提交issue

桶存量信息包括桶已使用的空间大小以及桶包含的对象个数。您可以通过get_bucket_storage_info获取桶的存量信息。

参数描述

字段名

类型

约束

说明

option

请求桶的上下文,配置option

必选

桶参数。

capacity_length

int

必选

使用容量的缓存大小。

capacity

char *

必选

使用容量。

object_number_length

int

必选

对象数目的缓存大小。

object_number

char *

必选

对象数目的缓存。

handler

obs_response_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

示例代码

static void test_get_bucket_storage_info(char *bucket_name)
{
    // 创建并初始化option
    obs_options option; 
    obs_status ret_status = OBS_STATUS_BUTT;
    init_obs_options(&option);

    option.bucket_options.host_name = "<your-endpoint>";
    option.bucket_options.bucket_name = "<Your bucketname>";
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY。
    // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
    option.bucket_options.access_key = getenv("ACCESS_KEY_ID");
    option.bucket_options.secret_access_key = getenv("SECRET_ACCESS_KEY");
    //定义桶容量缓存及对象数缓存
    char capacity[OBS_COMMON_LEN_256] = {0};
    char obj_num[OBS_COMMON_LEN_256] = {0};

    // 设置响应回调函数
    obs_response_handler response_handler =
    { 
        NULL,
        &response_complete_callback
    };

    // 获取桶存量信息
    get_bucket_storage_info(&option, OBS_COMMON_LEN_256, capacity, OBS_COMMON_LEN_256, obj_num, 
        &response_handler, &ret_status); 

    if (ret_status == OBS_STATUS_OK) {
         printf("get_bucket_storage_info success,bucket=%s objNum=%s capacity=%s\n", 
            bucket_name, obj_num, capacity);
    }
    else
    {
       printf("head bucket failed(%s).\n", obs_get_status_name(ret_status));
    }
}