{"id":28338,"library":"tencentcloud-sdk-python-intl-en","title":"Tencent Cloud SDK for Python (International Edition)","description":"Official SDK for accessing Tencent Cloud services from Python, designed for international regions. Version 3.1.91 provides async support, auto-retry, and typed APIs. Released via PyPI with monthly updates.","status":"active","version":"3.1.91","language":"python","source_language":"en","source_url":"https://github.com/TencentCloud/tencentcloud-sdk-python-intl-en","tags":["tencent-cloud","sdk","cloud","international"],"install":[{"cmd":"pip install tencentcloud-sdk-python-intl-en","lang":"bash","label":"Install via pip"}],"dependencies":[],"imports":[{"note":"ClientProfile moved to submodule in v3.","wrong":"from tencentcloud.common import ClientProfile","symbol":"ClientProfile","correct":"from tencentcloud.common.profile.client_profile import ClientProfile"}],"quickstart":{"code":"import os\nfrom tencentcloud.common import credential\nfrom tencentcloud.common.profile.client_profile import ClientProfile\nfrom tencentcloud.common.profile.http_profile import HttpProfile\nfrom tencentcloud.cvm.v20170312 import cvm_client, models\n\ncred = credential.Credential(\n    os.environ.get('TENCENTCLOUD_SECRET_ID', ''),\n    os.environ.get('TENCENTCLOUD_SECRET_KEY', '')\n)\nhttpProfile = HttpProfile()\nhttpProfile.endpoint = \"cvm.tencentcloudapi.com\"\nclientProfile = ClientProfile()\nclientProfile.httpProfile = httpProfile\nclient = cvm_client.CvmClient(cred, \"ap-guangzhou\", clientProfile)\nreq = models.DescribeInstancesRequest()\nresp = client.DescribeInstances(req)\nprint(resp.to_json_string())","lang":"python","description":"Initialize a CVM client and describe instances."},"warnings":[{"fix":"Update imports to match v3 structure: `from tencentcloud.cvm.v20170312 import cvm_client, models`.","message":"In v3, all service modules have been restructured. Code from v2 (e.g., `from tencentcloud.cvm.v20170312 import cvm_client`) will fail if you use old import paths.","severity":"breaking","affected_versions":"<3.0.0"},{"fix":"Install `tencentcloud-sdk-python-intl-en-asyncio` and change imports to `from tencentcloud.cvm.v20170312 import cvm_client as cvm_client_async` from the asyncio module.","message":"Async client moved to separate package `tencentcloud-sdk-python-intl-en-asyncio`. If you use async, install that and import from `tencentcloud.asyncio`.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Ensure you install `tencentcloud-sdk-python-intl-en` and set endpoints to `*.tencentcloudapi.com` instead of `*.api.qcloud.com`.","message":"Many users mistakenly use the Chinese mainland SDK (`tencentcloud-sdk-python`) instead of the international SDK (`tencentcloud-sdk-python-intl-en`), causing endpoint mismatches.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `from tencentcloud.common import credential` and then `credential.Credential(...)`.","message":"The `Credential` class from `tencentcloud.common.credential` is deprecated in favor of `tencentcloud.common.credential.Credential` (same class, but future-proof).","severity":"deprecated","affected_versions":">=3.1.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use `from tencentcloud.cvm.v20170312 import cvm_client` then instantiate `cvm_client.CvmClient()`.","cause":"Wrong import path; the client is named `cvm_client`.","error":"ImportError: cannot import name 'CvmClient' from 'tencentcloud.cvm.v20170312'"},{"fix":"Verify region and endpoint. For international, use `*.tencentcloudapi.com` and check region list.","cause":"Region not available for the requested API or using wrong endpoint (e.g., Chinese mainland endpoint for international account).","error":"tencentcloud.common.exception.TencentCloudSDKException: [TencentCloudSDKException] code: UnsupportedOperation, message: this action not support this region"},{"fix":"Install `tencentcloud-sdk-python-intl-en` using pip.","cause":"Forgot to install the SDK; installed wrong package (mainland version).","error":"AttributeError: module 'tencentcloud' has no attribute 'cvm'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}