配置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两个结构,可以设置的参数见下表:
参数 |
描述 |
默认值 |
建议值 |
---|---|---|---|
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 |
- |
参数 |
描述 |
默认值 |
建议值 |
---|---|---|---|
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的值。