On this page

Show all

Help Center/ Object Storage Service/ SDK Reference/ Go/ Initializing OBS SDK for Go/ obsClient Initialization (OBS SDK for Go)

obsClient Initialization (OBS SDK for Go)

Updated on 2025-02-26 GMT+08:00

View PDF

Function

ObsClient functions as the Go client for accessing OBS. It offers users a series of APIs for interaction with OBS. These APIs are used for managing and operating resources, such as buckets and objects, stored in OBS. To use the OBS Go SDK to send a request to OBS, you need to initialize an instance of ObsClient and modify configuration parameters of the instance based on actual needs.

Initialization Method

func New(ak, sk, endpoint string, configurers ...configurer) (*ObsClient, error)

Parameters

Parameter	Type	Mandatory (Yes/No)	Description
ak	string	Yes	Access key ID (AK)
sk	string	Yes	Secret access key (SK)
endpoint	string	Yes	Endpoint for accessing OBS, which contains the protocol type, domain name (or IP address), and port ID. For example, https://your-endpoint:443. For security purposes, you are advised to use HTTPS. To view the endpoints available for OBS, see Regions and Endpoints.
securityToken	string	No	The security token in temporary security credentials.
configurers	configurer (private type contained in the obs package)	No	A group of parameters used to configure ObsClient, including connection timeout period, maximum retries, and maximum number of connections.

Available Configurers

You can use configurers (private type provided by the obs namespace) to configure ObsClient. The following table lists available configurers:

Configurer	Description	Recommended Value
WithSslVerifyAndPemCerts(sslVerify bool, pemCerts []byte)	Specifies whether to verify server-side certificates. Server-side certificates will not be verified by default.	N/A
WithHeaderTimeout(headerTimeout int)	Specifies the timeout period of obtaining the response headers. The default value is 60, in seconds.	[10, 60]
WithMaxConnections(maxIdleConns int)	Specifies the maximum number of idle HTTP connections. The default value is 1000.	N/A
WithConnectTimeout(connectTimeout int)	Specifies the timeout period for establishing an HTTP/HTTPS connection, in seconds. The default value is 60.	[10, 60]
WithSocketTimeout(socketTimeout int)	Specifies the timeout duration for transmitting data at the socket layer, in seconds. The default value is 60.	[10, 60]
WithIdleConnTimeout(idleConnTimeout int)	Specifies the timeout period of an idle HTTP connection in the connection pool, in seconds. The default value is 30.	Default
WithMaxRetryCount(maxRetryCount int)	Specifies the maximum number of retries when an HTTP/HTTPS connection is abnormal. The default value is 3.	[1, 5]
WithProxyUrl(proxyUrl string)	Configures the HTTP proxy.	N/A
WithCustomDomainName(cname bool)	Whether to use a custom domain name to access OBS. The default value is false.	Default
WithHttpTransport(transport *http.Transport)	Configures custom structs of the Transport type.	Default
WithRequestContext(ctx context.Context)	Configures the context for each HTTP request.	N/A
WithMaxRedirectCount(maxRedirectCount int)	Specifies the maximum number of times that the HTTP/HTTPS request is redirected. The default value is 3.	[1, 5]
WithSecurityToken(securityToken string)	Specifies security token in the temporary access keys.	N/A

NOTE:

Parameters whose recommended value is N/A need to be set according to the actual conditions.
If the network is unstable, you are advised to set larger values for WithConnectTimeout and WithSocketTimeout.

Code Examples

You can call New to create an instance of ObsClient. Sample code for creating an instance of ObsClient using permanent access keys (AK/SK):

      
       
         
         // Import the dependency package.
import (
    obs "github.com/huaweicloud/huaweicloud-sdk-go-obs/obs"
)

func main() {
    //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
    //Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.    ak := os.Getenv("AccessKeyID")
    sk := os.Getenv("SecretAccessKey")
    // Enter the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
    endPoint := "https://obs.ap-southeast-1.myhuaweicloud.com"
    // Create an obsClient instance.
    obsClient, err := obs.New(ak, sk, endPoint)
    if err == nil {
         // Use the obsClient to access OBS.

         // Close the obsClient.
         obsClient.Close()
    }
}

        

      
     

Sample code for creating an ObsClient instance with a proxy:

      
       
         
         // Import the dependency package.
import (
       "obs"
)

func main() {
    //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
    //Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.    ak := os.Getenv("AccessKeyID")
    sk := os.Getenv("SecretAccessKey")
    // Enter the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
    endPoint := "https://obs.ap-southeast-1.myhuaweicloud.com"
    // Create an obsClient instance.
    obsClient, err := obs.New(ak, sk, endPoint, obs.WithProxyUrl("https://username:password!@yourProxy"))
    if err == nil {
         // Use the obsClient to access OBS.

         // Close the obsClient.
         obsClient.Close()
    }
}

        

      
     

Sample code for creating an instance of ObsClient using temporary access keys (AK/SK and security token):

      
       
         
         // Import the dependency package.
import (
    obs "github.com/huaweicloud/huaweicloud-sdk-go-obs/obs"
)

func main() {
    //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
    //Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.    ak := os.Getenv("AccessKeyID")
    sk := os.Getenv("SecretAccessKey")
    // (Optional) If you use a temporary AK/SK pair and a security token to access OBS, you are advised not to use hard coding to reduce leakage risks. You can obtain an AK/SK pair using environment variables or import it in other ways.
    // securityToken := os.Getenv("SecurityToken")
    // Enter the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
    endPoint := "https://obs.ap-southeast-1.myhuaweicloud.com"
    // Create an obsClient instance.
    // If you use a temporary AK/SK pair and a security token to access OBS, use the obs.WithSecurityToken method to specify a security token when creating an instance.
    obsClient, err := obs.New(ak, sk, endPoint, obs.WithSecurityToken(securityToken))
    if err == nil {
         // Use the obsClient to access OBS.

         // Close the obsClient.
         obsClient.Close()
    }
}

        

      
     

You can also create an instance of ObsClient by using temporary access keys obtained by configuring system environment variables or by accessing an ECS.

Sample code for creating an instance of ObsClient using access keys obtained from environment variables:

        
         
           
           // Import the dependency package.
import (
    obs "github.com/huaweicloud/huaweicloud-sdk-go-obs/obs"
)

func main() {
    //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
    //Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.    ak := os.Getenv("AccessKeyID")
    sk := os.Getenv("SecretAccessKey")
    // (Optional) If you use a temporary AK/SK pair and a security token to access OBS, you are advised not to use hard coding to reduce leakage risks. You can obtain an AK/SK pair using environment variables or import it in other ways.
    // securityToken := os.Getenv("SecurityToken")
    // Enter the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
    endPoint := "https://obs.ap-southeast-1.myhuaweicloud.com"
    // Create an obsClient instance.
    // If you use a temporary AK/SK pair and a security token to access OBS, use the obs.WithSecurityToken method to specify a security token when creating an instance.
    obsClient, err := obs.New(ak, sk, endPoint, obs.WithSecurityProviders(obs.NewEnvSecurityProvider(""))
    if err == nil {
         // Use the obsClient to access OBS.

         // Close the obsClient.
         obsClient.Close()
    }
}

          

        
       

NOTE:

In the preceding method, access keys are searched from the environment variables in the current system. The OBS_ACCESS_KEY_ID and OBS_SECRET_ACCESS_KEY fields need to be defined in the corresponding environment variables. If temporary access keys are also used, the OBS_SECURITY_TOKEN field must also be defined in the environment variables.

Sample code for creating an instance of ObsClient by obtaining temporary access keys from an ECS:

        
         
           
           // Import the dependency package.
import (
    obs "github.com/huaweicloud/huaweicloud-sdk-go-obs/obs"
)

func main() {
    //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
    //Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.    ak := os.Getenv("AccessKeyID")
    sk := os.Getenv("SecretAccessKey")
    // (Optional) If you use a temporary AK/SK pair and a security token to access OBS, you are advised not to use hard coding to reduce leakage risks. You can obtain an AK/SK pair using environment variables or import it in other ways.
    // securityToken := os.Getenv("SecurityToken")
    // Enter the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
    endPoint := "https://obs.ap-southeast-1.myhuaweicloud.com"
    // Create an obsClient instance.
    // If you use a temporary AK/SK pair and a security token to access OBS, use the obs.WithSecurityToken method to specify a security token when creating an instance.
    obsClient, err := obs.New(ak, sk, endPoint, obs.WithSecurityProviders(obs.NewEcsSecurityProvider(1))
    if err == nil {
         // Use the obsClient to access OBS.

         // Close the obsClient.
         obsClient.Close()
    }
}

          

        
       

NOTE:

If an application is deployed on an ECS and the ECS has relevant agencies bound, you can use the preceding method to automatically obtain temporary access keys from the ECS.

Sample code for creating an instance of ObsClient by obtaining access keys from system environment variables or ECSs in sequence:

        
         
           
           // Import the dependency package.
import (
    obs "github.com/huaweicloud/huaweicloud-sdk-go-obs/obs"
)

func main() {
    //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
    //Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.    ak := os.Getenv("AccessKeyID")
    sk := os.Getenv("SecretAccessKey")
    // (Optional) If you use a temporary AK/SK pair and a security token to access OBS, you are advised not to use hard coding to reduce leakage risks. You can obtain an AK/SK pair using environment variables or import it in other ways.
    // securityToken := os.Getenv("SecurityToken")
    // Enter the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
    endPoint := "https://obs.ap-southeast-1.myhuaweicloud.com"
    // Create an obsClient instance.
    // If you use a temporary AK/SK pair and a security token to access OBS, use the obs.WithSecurityToken method to specify a security token when creating an instance.
    obsClient, err := obs.New(ak, sk, endPoint,
      obs.WithSecurityProviders(obs.NewEnvSecurityProvider(""), obs.NewEcsSecurityProvider(1)) 
    )
    if err == nil {
         // Use the obsClient to access OBS.

         // Close the obsClient.
         obsClient.Close()
    }
}

          

        
       

NOTE:

In the preceding initialization process, access keys are obtained from environment variables and ECSs in sequence, and the first group of obtained access keys is used to create an ObsClient.

NOTE:

The project can contain one or more instances of ObsClient.

ObsClient is thread-safe and can be simultaneously used by multiple threads.
After you call the ObsClient.close method to close an instance of ObsClient, the instance cannot be used anymore.

You can call WithHttpTransport to pass a user-defined Transport parameter that specifies maximum connections for a single host. The sample code is as follows:

      
       
         
         // Import the dependency package.
import (
       "time"
    obs "github.com/huaweicloud/huaweicloud-sdk-go-obs/obs"
)

// Create an obsClient struct.
var obsClient, err = obs.New(ak, sk, endpoint, obs.WithHttpTransport(transport))

func main() {
    //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
    //Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.    ak := os.Getenv("AccessKeyID")
    sk := os.Getenv("SecretAccessKey")
    // (Optional) If you use a temporary AK/SK pair and a security token to access OBS, you are advised not to use hard coding to reduce leakage risks. You can obtain an AK/SK pair using environment variables or import it in other ways.
    // securityToken := os.Getenv("SecurityToken")
    // Enter the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
    endPoint := "https://obs.ap-southeast-1.myhuaweicloud.com"
    // Initialize the user-defined transport.
    var maxIdleConns = 1000
    var maxConnsPerHost = 1000
    var idleConnTimeout = 30
    var transport = &http.Transport{
        MaxIdleConns:        maxIdleConns,
        MaxIdleConnsPerHost: maxIdleConns,
        MaxConnsPerHost:     maxConnsPerHost,
        IdleConnTimeout:     time.Second * time.Duration(idleConnTimeout),
    }
    // Create an obsClient instance.
    // If you use a temporary AK/SK pair and a security token to access OBS, use the obs.WithSecurityToken method to specify a security token when creating an instance.
    obsClient, err := obs.New(ak, sk, endPoint,obs.WithHttpTransport(transport))

    if err == nil {
        // Use the obsClient to access OBS.
        // Close the obsClient.
        obsClient.Close()
    }
}

        

      
     

NOTICE:

The MaxConnsPerHost parameter can be specified in the Transport struct only in Golang 1.11 and later versions.
If a user-defined Transport is specified, the maximum number of idle connections and proxy can only be configured in Transport, rather than through the methods WithMaxConnections and WithProxyUrl.

Parent topic: Initializing OBS SDK for Go

Previous topic: Initializing OBS SDK for Go

Next topic: Log Initialization (SDK for Go)

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