tencentyun#qcloud-documents#自定义域名3

## 简介 本文档提供关于自定义域名的 API 概览以及 SDK 示例代码。 | API | 操作名 | 操作描述 | | ----------------- | -------------- | -------------------------- | | PUT Bucket domain | 设置自定义域名 | 设置存储桶的自定义域名信息 | | GET Bucket domain | 查询自定义域名 | 查询存储桶的自定义域名信息 | ## 设置自定义域名 #### 功能说明 PUT Bucket domain 用于为存储桶配置自定义域名。 #### 方法原型 ```c cos_status_t *cos_put_bucket_domain(const cos_request_options_t *options, const cos_string_t *bucket, cos_domain_params_t *domain_params, cos_table_t **resp_header); ``` #### 请求示例 ```cpp #include "cos_http_io.h" #include "cos_api.h" #include "cos_log.h" // endpoint 是 COS 访问域名信息，详情请参见 https://cloud.tencent.com/document/product/436/6224 文档 static char TEST_COS_ENDPOINT[] = "cos.ap-guangzhou.myqcloud.com"; // 开发者拥有的项目身份ID/密钥，可在 https://console.cloud.tencent.com/cam/capi 页面获取 static char *TEST_ACCESS_KEY_ID; //your secret_id static char *TEST_ACCESS_KEY_SECRET; //your secret_key // 开发者访问 COS 服务时拥有的用户维度唯一资源标识，用以标识资源，可在 https://console.cloud.tencent.com/cam/capi 页面获取 static char TEST_APPID[] = ""; //your appid //the cos bucket name, syntax: [bucket]-[appid], for example: mybucket-1253666666，可在 https://console.cloud.tencent.com/cos5/bucket 查看 static char TEST_BUCKET_NAME[] = ""; void log_status(cos_status_t *s) { cos_warn_log("status->code: %d", s->code); if (s->error_code) cos_warn_log("status->error_code: %s", s->error_code); if (s->error_msg) cos_warn_log("status->error_msg: %s", s->error_msg); if (s->req_id) cos_warn_log("status->req_id: %s", s->req_id); } void init_test_config(cos_config_t *config, int is_cname) { cos_str_set(&config->endpoint, TEST_COS_ENDPOINT); cos_str_set(&config->access_key_id, TEST_ACCESS_KEY_ID); cos_str_set(&config->access_key_secret, TEST_ACCESS_KEY_SECRET); cos_str_set(&config->appid, TEST_APPID); config->is_cname = is_cname; } void init_test_request_options(cos_request_options_t *options, int is_cname) { options->config = cos_config_create(options->pool); init_test_config(options->config, is_cname); options->ctl = cos_http_controller_create(options->pool, 0); } void test_put_bucket_domain() { cos_pool_t *pool = NULL; int is_cname = 0; cos_status_t *status = NULL; cos_request_options_t *options = NULL; cos_domain_params_t *domain_params = NULL; cos_table_t *resp_headers = NULL; cos_string_t bucket; //创建内存池 cos_pool_create(&pool, NULL); //初始化请求选项 options = cos_request_options_create(pool); init_test_request_options(options, is_cname); cos_str_set(&bucket, TEST_BUCKET_NAME); //创建 domain 参数 domain_params = cos_create_domain_params(options->pool); cos_str_set(&domain_params->status, "ENABLED"); cos_str_set(&domain_params->name, "www.exmaple.com"); cos_str_set(&domain_params->type, "REST"); cos_str_set(&domain_params->forced_replacement, "CNAME"); status = cos_put_bucket_domain(options, &bucket, domain_params, &resp_headers); log_status(status); // 销毁内存池 cos_pool_d