更新时间：2023-11-08 GMT+08:00
创建桶
开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。
您可以通过create_bucket或create_bucket_with_params创建一个对象桶，通过create_pfs_bucket创建一个并行文件系统的桶。
参数描述
字段名 |
类型 |
约束 |
说明 |
|---|---|---|---|
option |
请求桶的上下文，配置option |
必选 |
桶参数。 |
canned_acl |
obs_canned_acl，管理桶访问权限 |
必选 |
权限控制策略。 |
location_constraint |
char * |
可选 |
桶的区域位置。 |
handler |
obs_response_handler * |
必选 |
回调函数。 |
callback_data |
void * |
可选 |
回调数据。 |
param |
obs_create_bucket_params * |
必选 |
仅限create_bucket_with_params接口使用。 结构体包含：
|
示例代码
以下代码展示如何新建一个对象桶：
static void test_create_bucket(obs_canned_acl canned_acl, 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/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");
// 设置响应回调函数
obs_response_handler response_handler =
{
0, &response_complete_callback
};
// 创建桶，<预定义访问策略>值参考5.5管理桶访问权限
create_bucket(&option, "<bucket ACL>", NULL, &response_handler, &ret_status);
if (ret_status == OBS_STATUS_OK) {
printf("create bucket successfully. \n");
}
else
{
printf("create bucket failed(%s).\n", obs_get_status_name(ret_status));
}
}
以下代码展示如何新建一个3AZ的对象桶：
static void test_create_3az_bucket(obs_canned_acl canned_acl, 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
option.bucket_options.access_key = getenv("ACCESS_KEY_ID");
option.bucket_options.secret_access_key = getenv("SECRET_ACCESS_KEY");
// 设置响应回调函数
obs_response_handler response_handler =
{
0, &response_complete_callback
};
// 创建桶，<预定义访问策略>值参考5.5管理桶访问权限
obs_create_bucket_params create_param;
create_param.canned_acl = canned_acl;
create_param.location_constraint = "Region name that support 3AZ";
create_param.az_redundancy = OBS_REDUNDANCY_3AZ;
create_bucket_with_params(&option, &create_param, &response_handler, &ret_status);
if (ret_status == OBS_STATUS_OK) {
printf("create bucket with params successfully. \n");
}
else
{
printf("create bucket with params failed(%s).\n", obs_get_status_name(ret_status));
}
}
以下代码展示如何新建一个并行文件系统的桶：
static void test_create_pfs_bucket(obs_canned_acl canned_acl, 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/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");
// 设置响应回调函数
obs_response_handler response_handler =
{
0, &response_complete_callback
};
// 创建桶，<预定义访问策略>值参考5.5管理桶访问权限
create_pfs_bucket(&option, "<bucket ACL>", NULL, &response_handler, &ret_status);
if (ret_status == OBS_STATUS_OK) {
printf("create bucket successfully. \n");
}
else
{
printf("create bucket failed(%s).\n", obs_get_status_name(ret_status));
}
}
桶的名字是全局唯一的，所以您需要确保不与已有的桶名称重复。桶命名规则如下：
- 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。
- 禁止使用IP地址。
- 禁止以“-”或“.”开头及结尾。
- 禁止两个“.”相邻（如：“my..bucket”）。
- 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。
- 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。
本示例创建的桶的访问权限默认是私有读写，存储类型默认是标准类型，区域位置为全局域名所在的默认区域。
- 创建桶时，如果使用的终端节点归属于默认区域华北-北京一（cn-north-1），则可以不指定区域；如果使用的终端节点归属于其他区域，则必须指定区域，且指定的区域必须与终端节点归属的区域一致。当前有效的区域名称可从这里查询。比如初始化时使用的终端节点EndPoint是obs.cn-north-4. myhuaweicloud.com，那么在创建桶的时候必须指定Location：cn-north-4 才会创建成功，否则会返回状态码400。
带参数创建
创建桶时可以指定桶的访问权限、存储类型和区域位置。OBS支持的桶的存储类型有三类，参见桶存储类型。示例代码如下：
obs_status ret_status = OBS_STATUS_BUTT;
// 创建并初始化option
obs_options option;
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/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");
// 设置响应回调函数
obs_response_handler response_handler =
{
0, &response_complete_callback
};
// 设置桶的存储类型
option.bucket_options.storage_class = "<Your bucket storage policy>";
// 创建桶，入参可设置桶预定义访问策略、桶区域位置
create_bucket(&option, "<bucket ACL>", "<Your bucket location>", &response_handler, &ret_status);
if (ret_status == OBS_STATUS_OK) {
printf("create bucket successfully. \n");
}
else
{
printf("create bucket failed(%s).\n", obs_get_status_name(ret_status));
}
父主题： 管理桶
