not really known
Go to file
Huaweicloud-SDK a256d4a3f0 release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
examples release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-antiddos release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-aom release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-apig release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-apm release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-as release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-bcs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-bms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-bss release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-bssintl release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-campusgo release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cbh release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cbr release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cbs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cc release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cce release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ccm release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cdm release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cdn release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ces release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cgs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-classroom release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cloudbuild release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-clouddeploy release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cloudide release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cloudpipeline release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cloudrtc release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cloudtable release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cloudtest release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-codecheck release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-codecraft release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-codehub release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-core release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cpts release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-csms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-css release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-cts release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-das release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dbss release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dcs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ddm release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dds release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-deh release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-devstar release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dgc release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dns release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-drs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dsc release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-dws release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ecs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-eip release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-elb release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-eps release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-evs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-frs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-functiongraph release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-gaussdb release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-gaussdbfornosql release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-gaussdbforopengauss release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ges release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-gsl release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-hilens release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-hss release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-iam release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-iec release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ief release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-image release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-imagesearch release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ims release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-iotanalytics release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-iotda release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-iotedge release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ivs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-kafka release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-kms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-kps release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-live release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-lts release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-meeting release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-moderation release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-mpc release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-mrs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-nat release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-nlp release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-ocr release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-oms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-osm release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-projectman release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-rabbitmq release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-rds release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-res release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-rms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-roma release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-sa release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-scm release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-sdrs release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-servicestage release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-sfsturbo release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-sis release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-smn release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-sms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-swr release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-tms release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-vas release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-vod release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-vpc release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-vpcep release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-vss release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
huaweicloud-sdk-waf release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
CHANGELOG.md release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
CHANGELOG_CN.md release 3.0.84 source code for python 2022-04-14 19:06:46 +08:00
LICENSE release 3.0.1 beta code for python 2020-05-18 15:34:40 +08:00
README.md release 3.0.71 source code for python 2021-12-10 18:12:27 +08:00
README_CN.md release 3.0.71 source code for python 2021-12-10 18:12:27 +08:00
README_PYPI.md release 3.0.8-beta source code for python 2020-08-15 17:41:31 +08:00
__init__.py release 3.0.29-beta source code for python 2020-12-31 18:02:03 +08:00

README.md

English | 简体中文

Huawei Cloud Python Software Development Kit (Python SDK)

The Huawei Cloud Python SDK allows you to easily work with Huawei Cloud services such as Elastic Compute Service (ECS) and Virtual Private Cloud (VPC) without the need to handle API related tasks.

This document introduces how to obtain and use Huawei Cloud Python SDK.

Requirements

  • To use Huawei Cloud Python SDK, you must have Huawei Cloud account as well as the Access Key and Secret Key of the Huawei Cloud account. You can create an Access Key in the Huawei Cloud console. For more information, see My Credentials.

  • To use Huawei Cloud Python SDK to access the APIs of specific service, please make sure you do have activated the service in Huawei Cloud console if needed.

  • Huawei Cloud Python SDK requires Python 3.3 or later, run command python --version to check the version of Python.

Install Python SDK

You could use pip or source code to install dependencies.

You must install huaweicloudsdkcore library no matter which product/service development kit you need to use. Take using VPC SDK for example, you need to install huaweicloudsdkcore library and huaweicloudsdkvpc library:

  • Use python pip
# Install the core library
pip install huaweicloudsdkcore

# Install the VPC management library
pip install huaweicloudsdkvpc
  • Install from source code
# Install the core library
cd huaweicloudsdkcore-${version}
python setup.py install

# Install the VPC management library
cd huaweicloudsdkvpc-${version}
python setup.py install

Code example

  • The following example shows how to query a list of VPC in a specific region, you need to substitute your real {Service}Client for VpcClient in actual use.
  • Substitute the values for {your ak string}, {your sk string}, {your endpoint string} and {your project id}.
# coding: utf-8


from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcore.http.http_config import HttpConfig
# import specified service library huaweicloudsdk{service}, take vpc for example
from huaweicloudsdkvpc.v2 import *


def list_vpc(client):
    try:
        request = ListVpcsRequest(limit=1)
        response = client.list_vpcs(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)


if __name__ == "__main__":
    ak = "{your ak string}"
    sk = "{your sk string}"
    endpoint = "{your endpoint}"
    project_id = "{your project id}"

    config = HttpConfig.get_default_config()
    config.ignore_ssl_verification = True
    credentials = BasicCredentials(ak, sk, project_id)

    vpc_client = VpcClient.new_builder() \
        .with_http_config(config) \
        .with_credentials(credentials) \
        .with_endpoint(endpoint) \
        .build()

    list_vpc(vpc_client)

Changelog

Detailed changes for each released version are documented in the CHANGELOG.md.

User Manual 🔝

1. Client Configuration 🔝

1.1 Default Configuration 🔝

#  Use default configuration
config = HttpConfig.get_default_config()

1.2 Network Proxy 🔝

# Use Proxy if needed
config.proxy_protocol = 'http'
config.proxy_host = 'proxy.huaweicloud.com'
config.proxy_port = 80
config.proxy_user = 'username'
config.proxy_password = 'password'

1.3 Connection 🔝

# The default connection timeout is 60 seconds, the default read timeout is 120 seconds. You could specify a unified timeout by using config.timeout=timeout, or specify timeout separately config.timeout=(connect timeout, read timeout)
config.timeout = 120

1.4 SSL Certification 🔝

# Skip ssl certifaction checking while using https protocol if needed
config.ignore_ssl_verification = True
# Server ca certification if needed
config.ssl_ca_cert = ssl_ca_cert

2. Credentials Configuration 🔝

There are two types of Huawei Cloud services, regional services and global services.

Global services contain BSS, DevStar, EPS, IAM, RMS, TMS.

For regional services' authentication, projectId is required to initialize BasicCredentials. For global services' authentication, domainId is required to initialize GlobalCredentials.

Parameter description:

  • ak is the access key ID for your account.
  • sk is the secret access key for your account.
  • project_id is the ID of your project depending on your region which you want to operate.
  • domain_id is the account ID of Huawei Cloud.
  • security_token is the security token when using temporary AK/SK.

2.1 Use Permanent AK&SK 🔝

# Regional services
basic_credentials = BasicCredentials(ak, sk, project_id)

# Global services
global_credentials = GlobalCredentials(ak, sk, domain_id)

Notice:

  • project_id/domain_id supports automatic acquisition in version 3.0.26-beta or later, if you want to use this feature, you need to provide the ak and sk of your account and the id of the region, and then build your client instance with method with_region(), detailed example could refer to 3.2 Initialize the client with specified Region .

2.2 Use Temporary AK&SK 🔝

It's required to obtain temporary access key, security key and security token first, which could be obtained through permanent access key and security key or through an agency.

Obtaining a temporary access key token through permanent access key and security key, you could refer to document: https://support.huaweicloud.com/en-us/api-iam/iam_04_0002.html . The API mentioned in the document above corresponds to the method of CreateTemporaryAccessKeyByToken in IAM SDK.

Obtaining a temporary access key and security token through an agency, you could refer to document: https://support.huaweicloud.com/en-us/api-iam/iam_04_0101.html . The API mentioned in the document above corresponds to the method of CreateTemporaryAccessKeyByAgency in IAM SDK.

# Regional services
basic_credentials = BasicCredentials(ak, sk, project_id).with_security_token(security_token)

# Global services
global_credentials = GlobalCredentials(ak, sk, domain_id).with_security_token(security_token)

3. Client Initialization 🔝

There are two ways to initialize the {Service}Client, you could choose one you preferred.

3.1 Initialize the {Service}Client with specified Endpoint 🔝

# Specify the endpoint, take the endpoint of VPC service in region of cn-north-4 for example
endpoint = "https://vpc.cn-north-4.myhuaweicloud.com"

# Initialize the credentials, you should provide project_id or domain_id in this way, take initializing BasicCredentials for example
basic_credentials = BasicCredentials(ak, sk, project_id)

# Initialize specified service client instance, take initializing the regional service VPC's VpcClient for example
client = VpcClient.new_builder() \
    .with_http_config(config) \
    .with_credentials(basic_credentials) \
    .with_endpoint(endpoint) \
    .build()

where:

  • endpoint varies by services and regions, see Regions and Endpoints to obtain correct endpoint.

  • When you meet some trouble in getting projectId using the specified region way, you could use this way instead.

# dependency for region module
from huaweicloudsdkiam.v3.region.iam_region import IamRegion

# Initialize the credentials, project_id or domain_id could be unassigned in this situation, take initializing GlobalCredentials for example
global_credentials = GlobalCredentials(ak, sk)

# initialize specified service client instance, take initializing the global service IAM's IamClient for example
client = IamClient.new_builder() \
    .with_http_config(config) \
    .with_credentials(global_credentials) \
    .with_region(IamRegion.CN_NORTH_4) \
    .build()

Notice:

  • If you use {Service}Region to initialize {Service}Client, project_id/domain_id supports automatic acquisition, you don't need to configure it when initializing Credentials.

  • Multiple ProjectId situation is not supported.

  • Supported region list: af-south-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, cn-east-2, cn-east-3, cn-north-1, cn-north-4, cn-south-1, cn-southwest-2, ru-northwest-2. You may get exception such as Unsupported regionId if your region don't in the list above.

Comparison of the two ways:

Initialization Advantages Disadvantage
Specified Endpoint The API can be invoked successfully once it has been published in the environment. You need to prepare projectId and endpoint yourself.
Specified Region No need for projectId and endpoint, it supports automatic acquisition if you configure it in the right way. The supported services and regions are limited.

4. Send Requests and Handle Responses 🔝

# Initialize a request and print response, take interface of ListVpcs for example
request = ListVpcsRequest(limit=1)

response = client.list_vpcs(request)
print(response)

4.1 Exceptions 🔝

Level 1 Notice Level 2 Notice
ConnectionException Connection error HostUnreachableException Host is not reachable
SslHandShakeException SSL certification error
RequestTimeoutException Request timeout CallTimeoutException timeout for single request
RetryOutageException no response after retrying
ServiceResponseException service response error ServerResponseException server inner error, http status code: [500,]
ClientRequestException invalid request, http status code: [400? 500)
# handle exceptions
try:
    request = ListVpcsRequest(limit=1)
    response = client.list_vpcs(request)
    print(response)
except exception.ServiceResponseException as e:
    print(e.status_code)
    print(e.request_id)
    print(e.error_code)
    print(e.error_msg)

4.2 Get Response Object 🔝

The default response format of each request is json string, if you want to obtain the response object, the Python SDK supports using method to_json_object() to get it.

request = ListVpcsRequest(limit=1)
# original response json string
response = client.list_vpcs(request)
print(response)
# response object
response_obj = response.to_json_object()
print(response_obj["vpcs"])

Notice: This method is only supported in version 3.0.34-rc or later.

5. Use Asynchronous Client 🔝

# Initialize asynchronous client, take VpcAsyncClient for example
client = VpcAsyncClient.new_builder() \
    .with_http_config(config) \
    .with_credentials(basic_credentials) \
    .with_endpoint(endpoint) \
    .build()

# send asynchronous request
request = ListVpcsRequest(limit=1)
response = client.list_vpcs_async(request)

# get asynchronous response
print(response.result())

6. Troubleshooting 🔝

SDK supports Access log and Debug log which could be configured manually.

6.1 Access Log 🔝

SDK supports print access log which could be enabled by manual configuration, the log could be output to the console or specified files.

For example:

# Initialize specified service client instance, take VpcClient for example
client = VpcClient.new_builder() \
    .with_http_config(config) \
    .with_credentials(basic_credentials) \
    .with_endpoint(endpoint) \
    .with_file_log(path="test.log", log_level=logging.INFO) \  # Write log files
    .with_stream_log(log_level=logging.INFO) \                 # Write log to console
    .build()

where:

  • with_file_log:
    • path means log file path.
    • log_level means log level, default is INFO.
    • max_bytes means size of single log file, the default value is 10485760 bytes.
    • backup_count means count of log file, the default value is 5.
  • with_stream_log:
    • stream means stream object, the default value is sys.stdout.
    • log_level means log level, the default value is INFO.

After enabled log, the SDK will print the access log by default, every request will be recorded to the console like:

2020-06-16 10:44:02,019 4568 HuaweiCloud-SDK http_handler.py 28 INFO "GET https://vpc.cn-north-1.myhuaweicloud.com/v1/0904f9e1f100d2932f94c01f9aa1cfd7/vpcs" 200 11 0:00:00.543430 b5c927ffdab8401e772e70aa49972037

The format of access log is:

%(asctime)s %(thread)d %(name)s %(filename)s %(lineno)d %(levelname)s %(message)s

6.2 Original HTTP Listener 🔝

In some situation, you may need to debug your http requests, original http request and response information will be needed. The SDK provides a listener function to obtain the original encrypted http request and response information.

⚠️ Warning: The original http log information is used in debugging stage only, please do not print the original http header or body in the production environment. These log information is not encrypted and contains sensitive data such as the password of your ECS virtual machine, or the password of your IAM user account, etc. When the response body is binary content, the body will be printed as "***" without detailed information.

import logging
from huaweicloudsdkcore.http.http_handler import HttpHandler


def response_handler(**kwargs):
    logger = kwargs.get("logger")
    response = kwargs.get("response")
    request = response.request

    base = "> Request %s %s HTTP/1.1" % (request.method, request.path_url) + "\n"
    if len(request.headers) != 0:
        base = base + "> Headers:" + "\n"
        for each in request.headers:
            base = base + "    %s : %s" % (each, request.headers[each]) + "\n"
    base = base + "> Body: %s" % request.body + "\n\n"

    base = base + "< Response HTTP/1.1 %s " % response.status_code + "\n"
    if len(response.headers) != 0:
        base = base + "< Headers:" + "\n"
        for each in response.headers:
            base = base + "    %s : %s" % (each, response.headers[each],) + "\n"
    base = base + "< Body: %s" % response.content
    logger.debug(base)


if __name__ == "__main__":
    client = VpcClient.new_builder() \
        .with_http_config(config) \
        .with_credentials(basic_credentials) \
        .with_stream_log(log_level=logging.DEBUG) \
        .with_http_handler(HttpHandler().add_response_handler(response_handler)) \
        .with_endpoint(endpoint) \
        .build()

Notice:

HttpHandler supports method add_request_handler and add_response_handler.

7. Upload and download files 🔝

Take the interface CreateImageWatermark of the service Data Security Center as an example, this interface needs to upload an image file and return the watermarked image file stream:

# coding: utf-8
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcore.http.http_config import HttpConfig
from huaweicloudsdkcore.http.formdata import FormFile
from huaweicloudsdkdsc.v1 import *


def create_image_watermark(client):

    try:
        request = CreateImageWatermarkRequest()
        # Open the file in mode "rb", create a Formfile object.
        image_file = FormFile(open("demo.jpg", "rb"))
        body = CreateImageWatermarkRequestBody(file=image_file, blind_watermark="test_watermark")
        request.body = body
        response = client.create_image_watermark(request)
        image_file.close()
        
        # Define the method of downloading files.
        def save(stream):
            with open("result.jpg", "wb") as f:
                f.write(stream.content)
        # Download the file.
        response.consume_download_stream(save)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)


if __name__ == "__main__":
    ak = "{your ak string}"
    sk = "{your sk string}"
    endpoint = "{your endpoint}"
    project_id = "{your project id}"
    config = HttpConfig.get_default_config()
    config.ignore_ssl_verification = True
    credentials = BasicCredentials(ak, sk, project_id)
    dsc_client = DscClient.new_builder()
        .with_http_config(config) \
        .with_credentials(credentials) \
        .with_endpoint(endpoint) \
        .build()
    
    create_image_watermark(dsc_client)