配置OBS客户端
当使用配置类(ObsConfig)创建OBS客户端(ObsClient)时,您可通过ObsConfig配置类对ObsClient进行配置,可配置代理、连接超时、最大连接数等参数。通过ObsConfig可以设置的参数见下表:
| 
       参数  | 
     
       描述  | 
     
       建议值  | 
    
|---|---|---|
| 
       Endpoint  | 
     
       连接OBS的服务地址。可包含协议类型、域名、端口号。示例:https://your-endpoint:443。(出于安全性考虑,建议使用https协议)  | 
     
       N/A  | 
    
| 
       Timeout  | 
     
       同步调用的超时时间(单位:毫秒)。默认为-1表示不超时。  | 
     
       N/A  | 
    
| 
       ReadWriteTimeout  | 
     
       Socket层传输数据的超时时间(单位:毫秒)。默认为60000毫秒。  | 
     
       [10000, 60000]  | 
    
| 
       AsyncSocketTimeout  | 
     
       异步调用的超时时间(单位:毫秒)。默认为-1表示不超时。  | 
     
       N/A  | 
    
| 
       MaxIdleTime  | 
     
       如果空闲时间超过此参数的设定值,则关闭连接(单位:毫秒)。默认为30000毫秒。  | 
     
       默认  | 
    
| 
       ConnectionLimit  | 
     
       允许打开的最大HTTP连接数。默认为1000。  | 
     
       默认  | 
    
| 
       MaxErrorRetry  | 
     
       请求失败(请求异常、服务端报500或503错误)后最大的重试次数。默认3次。  | 
     
       [1, 5]  | 
    
| 
       ReceiveBufferSize  | 
     
       套接字接收缓冲区的大小。默认为8192。  | 
     
       [8192, 65536]  | 
    
| 
       SecurityProtocolType  | 
     
       使用HTTPS时的加密协议类型。  | 
     
       N/A  | 
    
| 
       ProxyHost  | 
     
       代理服务器的主机地址。  | 
     
       N/A  | 
    
| 
       ProxyPort  | 
     
       代理服务器的端口号。  | 
     
       N/A  | 
    
| 
       ProxyUserName  | 
     
       连接代理服务器时使用的用户名。  | 
     
       N/A  | 
    
| 
       ProxyPassword  | 
     
       连接代理服务器时使用的用户密码。  | 
     
       N/A  | 
    
| 
       ProxyDomain  | 
     
       代理服务器的域。  | 
     
       N/A  | 
    
| 
       ValidateCertificate  | 
     
       是否验证服务端证书。默认为false。  | 
     
       N/A  | 
    
| 
       BufferSize  | 
     
       上传对象到Socket流时的读/写缓存大小(单位:字节)。默认为8192字节。  | 
     
       默认  | 
    
| 
       KeepAlive  | 
     
       是否使用长连接访问OBS服务。默认为true。  | 
     
       N/A  | 
    
 
  - 建议值为N/A的表示需要根据实际情况进行设置。
 - 如网络状况不佳,建议调整Timeout、AsyncSocketTimeout和ReadWriteTimeout的值。
 - 如果设置的Endpoint不带协议类型,则默认使用HTTPS协议。
 - 出于DNS解析性能和OBS服务可靠性的考虑,不允许将Endpoint设置为IP,必须使用域名访问OBS服务。