更新时间:2024-05-08 GMT+08:00

配置OBS客户端

您可通过OBSServiceConfiguration配置类对OBSClient进行配置,可配置代理、连接超时、最大连接数等参数。通过OBSServiceConfiguration可以设置的参数见下表:

表1 OBS网络请求配置表

参数

描述

建议值

OBSServiceConfiguration.credentialProvider

用户凭证,参见表2 OBS服务身份验证配置表

N/A

OBSServiceConfiguration.proxyConfig

代理配置,默认为空,参见表3 代理服务配置表

N/A

OBSServiceConfiguration.trustUnsafeCert

是否信任不安全证书,默认为“NO”。

默认

OBSServiceConfiguration.maxConcurrentCommandRequestCount

允许的最大的命令请求并发数,默认为3。

默认

OBSServiceConfiguration.maxConcurrentUploadRequestCount

允许的最大的上传请求并发数,默认为3。

默认

OBSServiceConfiguration.maxConcurrentDownloadRequestCount

允许的最大的下载请求并发数,默认为3。

默认

OBSServiceConfiguration.defaultDomainMode

指定域名访问模式的参数,可设置为OBSDomainModeCustom以使用自定义域名, 默认为非自定义域名访问模式。

默认

OBSServiceConfiguration.commandSessionConfiguration.HTTPMaximumConnectionsPerHost

允许打开的最大的命令请求连接数, ios系统中默认为4。

N/A

OBSServiceConfiguration.uploadSessionConfiguration.HTTPMaximumConnectionsPerHost

允许打开的最大的上传请求连接数, ios系统中默认为4。

N/A

OBSServiceConfiguration.downloadSessionConfiguration.HTTPMaximumConnectionsPerHost

允许打开的最大的下载请求连接数, ios系统中默认为4。

N/A

OBSServiceConfiguration.backgroundUploadSessionConfiguration.HTTPMaximumConnectionsPerHost

允许打开的最大的后台上传请求连接数, ios系统中默认为4。

N/A

OBSServiceConfiguration.backgroundDownloadSessionConfiguration.HTTPMaximumConnectionsPerHost

允许打开的最大的后台下载请求连接数, ios系统中默认为4。

N/A

OBSServiceConfiguration.commandSessionConfiguration.timeoutIntervalForRequest

配置命令请求的超时时间;(单位秒)

60

OBSServiceConfiguration.uploadSessionConfiguration.timeoutIntervalForRequest

配置上传相关请求的超时时间;(单位秒)

60

OBSServiceConfiguration.downloadSessionConfiguration.timeoutIntervalForRequest

配置下载相关请求的超时时间;(单位秒)

60

建议值为N/A的表示需要根据实际情况进行设置。出于安全性考虑,endpoint建议使用https协议。

OBSStaticCredentialProvider可以设置的参数见下表:

表2 OBS服务身份验证配置表

参数

描述

方法

accessKey

用户的 Access Key。

credentialProvider.Access_Key = Access_Key

secretKey

用户的Secret Key。

credentialProvider.Secret_Key = Secret_Key

securityToken

临时Token

credentialProvider.securityToken = token

credentialProvider是OBSStaticCredentialProvider的实例对象。

securityToken获取方式参见OBS服务环境搭建

OBSHTTPProxyConfiguration可以设置的参数见下表:

表3 代理服务配置表

参数

描述

方法

proxyType

网络访问的类型(枚举类型)。

只允许HTTP:

proxyConfig.proxyType=OBSHTTPRroxyTypeHTTP

只允许HTTPS:

proxyConfig.proxyType=OBSHTTPRroxyTypeHTTPS

允许HTTP和HTTPS:

proxyConfig.proxyType=OBSHTTPRroxyTypeHTTPAndHTTPS

proxyHost

代理服务器的主机地址。

proxyConfig.proxyHost = @"host"

proxyPort

代理服务器的端口号。

proxyConfig.proxyPort = @"port"

username

连接代理服务器时使用的用户名。

proxyConfig.username = @"username"

password

连接代理服务器时使用的用户密码。

proxyConfig.password = @"password"

proxyConfig是OBSHTTPProxyConfiguration实例对象。