更新时间:2024-04-29 GMT+08:00

配置option

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

在调用C SDK的功能函数时,都要传入obs_options参数,您可通过init_obs_options函数初始化obs_options配置,通过obs_options设置AK、SK、Endpoint、bucket、超时时间、临时鉴权。obs_options主要包括obs_bucket_context和obs_http_request_option两个结构,可以设置的参数见下表:

表1 obs_options.obs_bucket_context参数

参数

描述

默认值

建议值

host_name

请求使用的主机名,是指存放资源的服务器的域名,就是终端节点endpoint。

NULL

-

bucket_name

操作的桶名。

NULL

-

protocol

请求使用的协议类型: http、https。(出于安全性考虑,建议使用https协议)

HTTPS协议:OBS_PROTOCOL_HTTPS

OBS_PROTOCOL_HTTPS

access_key

连接对象存储服务的AK

NULL

-

secret_access_key

鉴权使用的SK,可用于字符串的签名。

NULL

-

obs_storage_class

在PUT,POST请求中,需要配置存储类型时设置此参数。

标准存储:OBS_STORAGE_CLASS_STANDARD

默认值

token

临时访问密钥的SecurityToken。

NULL

-

bucket_type

创桶时,指定是对象桶还是并行文件系统

对象桶:OBS_BUCKET_OBJECT

-

bucket_list_type

列举桶时,确定列举桶的类型:所有桶、对象桶、并行文件系统

所有桶:OBS_BUCKET_LIST_ALL

-

表2 obs_options.obs_http_request_option参数

参数

描述

默认值

建议值

connect_time

建立HTTP/HTTPS连接的超时时间(单位:毫秒)。默认为60000毫秒。

60000

[10000, 60000]

max_connected_time

请求超时时间(单位:秒)。0代表永远不会断开链接。

0

0

proxy_auth

代理认证信息,格式username:password

NULL

-

proxy_host

代理服务器

NULL

-

如网络状况不佳,建议增大connect_time和max_connected_time的值。