On this page

Show all

Help Center/ Object Storage Service/ SDK Reference/ iOS/ Initialization/ Configuring an Instance of OBSClient

Configuring an Instance of OBSClient

Updated on 2024-12-09 GMT+08:00

View PDF

You can use the OBSServiceConfiguration configuration class to configure an instance of OBSClient, including the proxy, connection timeout period, maximum number of retry attempts, and other parameters listed in the following table.

**Table 1** Parameters for configuring a network request
Parameter	Description	Recommended Value
OBSServiceConfiguration.credentialProvider	User credential. For details, see Table 2.	N/A
OBSServiceConfiguration.proxyConfig	Proxy configuration. The default value is null. For details, see Table 3.	N/A
OBSServiceConfiguration.trustUnsafeCert	Whether to trust insecure certificates. The default value is NO.	Default value
OBSServiceConfiguration.maxConcurrentCommandRequestCount	Maximum number of concurrent command requests. The default value is 3.	Default value
OBSServiceConfiguration.maxConcurrentUploadRequestCount	Maximum number of concurrent upload requests. The default value is 3.	Default value
OBSServiceConfiguration.maxConcurrentDownloadRequestCount	Maximum number of concurrent download requests. The default value is 3.	Default value
OBSServiceConfiguration.defaultDomainMode	Domain name access mode. You can set this parameter to OBSDomainModeCustom to use a user-defined domain name. By default, the non-user-defined domain name access mode is used.	Default value
OBSServiceConfiguration.commandSessionConfiguration.HTTPMaximumConnectionsPerHost	Maximum number of command request connections that can be opened. The default value in iOS is 4.	N/A
OBSServiceConfiguration.uploadSessionConfiguration.HTTPMaximumConnectionsPerHost	Maximum number of upload request connections that can be opened. The default value in iOS is 4.	N/A
OBSServiceConfiguration.downloadSessionConfiguration.HTTPMaximumConnectionsPerHost	Maximum number of download request connections that can be opened. The default value in iOS is 4.	N/A
OBSServiceConfiguration.backgroundUploadSessionConfiguration.HTTPMaximumConnectionsPerHost	Maximum number of background upload request connections that can be opened. The default value in iOS is 4.	N/A
OBSServiceConfiguration.backgroundDownloadSessionConfiguration.HTTPMaximumConnectionsPerHost	Maximum number of background download request connections that can be opened. The default value in iOS is 4.	N/A
OBSServiceConfiguration.commandSessionConfiguration.timeoutIntervalForRequest	Timeout interval for a command request, in seconds.	60
OBSServiceConfiguration.uploadSessionConfiguration.timeoutIntervalForRequest	Timeout interval for an upload request, in seconds.	60
OBSServiceConfiguration.downloadSessionConfiguration.timeoutIntervalForRequest	Timeout interval for a download request, in seconds.	60

NOTE:

Set parameters with N/A as the recommended value based on your needs. For security purposes, you are advised to use HTTPS for endpoints.

The following table describes parameters involved in OBSStaticCredentialProvider:

**Table 2** Server identification configurations
Parameter	Description	Method
accessKey	User's AK	credentialProvider.Access_Key = Access_Key
secretKey	User's SK	credentialProvider.Secret_Key = Secret_Key
securityToken	Temporary token	credentialProvider.securityToken = token

NOTE:

credentialProvider is an instance of OBSStaticCredentialProvider.

For details about how to obtain the value of securityToken, see Setting Up an OBS Environment.

The following table describes parameters involved in OBSHTTPProxyConfiguration:

**Table 3** Proxy server configurations
Parameter	Description	Method
proxyType	Network access type (Possible values are enumerated).	To allow HTTP only: proxyConfig.proxyType=OBSHTTPRroxyTypeHTTP To allow HTTPS only: proxyConfig.proxyType=OBSHTTPRroxyTypeHTTPS To allow both HTTP and HTTPS: proxyConfig.proxyType=OBSHTTPRroxyTypeHTTPAndHTTPS
proxyHost	Host address of the proxy server.	proxyConfig.proxyHost = @"host"
proxyPort	Port ID of the proxy server.	proxyConfig.proxyPort = @"port"
username	Username used for connecting to the proxy server.	proxyConfig.username = @"username"
password	Password used for connecting to the proxy server.	proxyConfig.password = @"password"

NOTE:

proxyConfig is an instance of OBSHTTPProxyConfiguration.

Parent topic: Initialization

Previous topic: Creating an Instance of OBSClient

Next topic: Bucket Management

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot