Initializing an Instance of ObsClient (SDK for Python)

Function

ObsClient functions as the Python client for accessing OBS. It offers users a series of APIs for interaction with OBS. These APIs are used for managing resources, such as buckets and objects, stored in OBS.

Method

ObsClient(access_key_id, secret_access_key, server)

Constructor Parameter Description

• 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 a larger value for timeout.
• If the value of server does not contain any protocol, HTTPS is used by default.

• If the persistent connection mode is enabled, you must call ObsClient.close to close ObsClient explicitly to reclaim connection resources.
• For the sake of high DNS resolution performance and OBS reliability, you can set server only to the domain name of OBS, instead of the IP address.

Code Examples

• You can create an instance of ObsClient by using a constructor function. Sample code for creating an instance of ObsClient using permanent access keys (AK/SK):

  # Import the module.
  from obs import ObsClient
  
  # Obtain an AK and SK pair using environment variables or import the AK and SK pair in other ways. Using hard coding may result in leakage.
  # Obtain an AK and 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")
  # Set server to the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
  server = "https://obs.ap-southeast-1.myhuaweicloud.com" 
  
  # Create an obsClient instance.
  Specify a security token.
  obsClient = ObsClient(access_key_id=ak, secret_access_key=sk, server=server)
  
  # Use the instance to access OBS.
  
  # Close ObsClient.
  obsClient.close()

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

  # Import the module.
  from obs import ObsClient
  
  # Obtain an AK and SK pair using environment variables or import the AK and SK pair in other ways. Using hard coding may result in leakage.
  # Obtain an AK and 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 and SK pair and a security token to access OBS, obtain them from environment variables.
  security_token = os.getenv("SecurityToken")
  # Set server to the endpoint corresponding to the bucket. CN-Hong Kong is used here as an example. Replace it with the one currently in use.
  server = "https://obs.ap-southeast-1.myhuaweicloud.com" 
  
  # Create an obsClient instance.
  # If you use a temporary AK and SK pair and a security token to access OBS, you must specify security_token when creating an instance.
  obsClient = ObsClient(
      access_key_id=ak,
      secret_access_key=sk,
      server=server,
      security_token=security_token
  )
  
  # Use the instance to access OBS.
  
  # Close ObsClient.
  obsClient.close()

• Specify the method of obtaining temporary access keys:
  • Sample code for obtaining the access key from environment variables using a single method:

    # Import the module.
    from obs import ObsClient
    from obs import loadtoken
    
    # Create an instance of ObsClient.
    # Provide ENV to obtain the access keys.
    obsClient = ObsClient(
        server='https://your-endpoint',
        security_providers=[loadtoken.ENV]
    )
    
    # Use the instance to access OBS.
    
    # Close 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 ENV:

    # Import the module.
    from obs import ObsClient
    
    # Create an instance of ObsClient.
    # Provide ENV to obtain the access keys.
    obsClient = ObsClient(
        server='https://your-endpoint',
        security_provider_policy='ENV'
    )
    
    # Use the instance to access OBS.
    
    # Close ObsClient.
    obsClient.close()

    

    In the preceding method, access keys are searched from the environment variables of 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 used, the OBS_SECURITY_TOKEN field must also be defined in the environment variables.

  • Sample code for creating an instance of ObsClient using ECS:

    # Import the module.
    from obs import ObsClient
    
    # Create an instance of ObsClient.
    # Provide ECS to obtain the temporary access keys.
    obsClient = ObsClient(
        server='https://your-endpoint',
        security_provider_policy='ECS'
    )
    
    # Use the instance to access OBS.
    
    # Close ObsClient.
    obsClient.close()

    

    When an application is deployed on an ECS, temporary access keys can be obtained automatically using the preceding methods and updated periodically.

    If the client reports error 401, check whether an agency has been added during ECS creation.

    

    When obtaining temporary access keys using this method, ensure that the UTC time of the server is the same as that of the environment where the application is deployed. Otherwise, the temporary access keys may fail to be updated.

• In addition to the preceding methods, you can also search in sequence to obtain the corresponding access keys from the environment variables and ECSs.
  • You can set security_provider_policy to OBS_DEFAULT to specify that ObsClient searches for access keys in sequence.

    # Import the module.
    from obs import ObsClient
    
    # Create an instance of ObsClient.
    # Search for access keys from environment variables and ECSs in sequence. 
    obsClient = ObsClient(
        server='https://your-endpoint',
        security_provider_policy='OBS_DEFAULT'
    )
    
    # Use the instance to access OBS.
    
    # Close ObsClient.
    obsClient.close()

    

    In the preceding method, security_provider_policy is set to OBS_DEFAULT, which specifies that ObsClient searches for access keys in sequence from the predefined list. By default, the system provides two predefined search methods: obtaining the access keys from the environment variables and obtaining from ECSs. ObsClient searches for the access keys from the environment variables first and then from ECSs. In this case, ObsClient is created using the first pair of access keys obtained in the search.

• The project can contain one or more instances of ObsClient.

• ObsClient is thread secure and can be simultaneously used by multiple threads.