{"id":28350,"library":"tencentcloud-sdk-python-oceanus","title":"Tencent Cloud Oceanus SDK","description":"Tencent Cloud Oceanus SDK for Python provides access to Tencent Cloud's Oceanus (real-time computing) services. The current version is 3.1.79, released from a monorepo under the tencentcloud-sdk-python project. It follows the main SDK's release cadence, with frequent minor updates.","status":"active","version":"3.1.79","language":"python","source_language":"en","source_url":"https://github.com/TencentCloud/tencentcloud-sdk-python","tags":["tencent-cloud","oceanus","real-time-computing","sdk"],"install":[{"cmd":"pip install tencentcloud-sdk-python-oceanus","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Common SDK components and client initialization","package":"tencentcloud-sdk-python-common","optional":false}],"imports":[{"note":"OceanusClient is in oceanus_client module, not models","wrong":"from tencentcloud.oceanus.v20190422.models import OceanusClient","symbol":"OceanusClient","correct":"from tencentcloud.oceanus.v20190422 import oceanus_client"}],"quickstart":{"code":"from tencentcloud.common import credential\nfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException\nfrom tencentcloud.oceanus.v20190422 import oceanus_client, models\n\ntry:\n    cred = credential.Credential(\n        secret_id=os.environ.get('TENCENTCLOUD_SECRET_ID', ''),\n        secret_key=os.environ.get('TENCENTCLOUD_SECRET_KEY', '')\n    )\n    client = oceanus_client.OceanusClient(cred, \"ap-guangzhou\")\n    req = models.DescribeClustersRequest()\n    resp = client.DescribeClusters(req)\n    print(resp.to_json_string())\nexcept TencentCloudSDKException as e:\n    print(e)","lang":"python","description":"Initializes the Oceanus client and describes clusters."},"warnings":[{"fix":"from tencentcloud.oceanus.v20190422 import oceanus_client, models","message":"The SDK uses camelCase for API actions (e.g., DescribeClusters), but the request class is PascalCase (e.g., DescribeClustersRequest). Import models from the same module as the client.","severity":"gotcha","affected_versions":"All"},{"fix":"Use credential.Credential(secret_id, secret_key) or credential.STSAssumeRoleCredential for temporary keys.","message":"Credential must be created with secret_id and secret_key, not with token or session_token. The SDK does not support STS by default.","severity":"gotcha","affected_versions":"All"},{"fix":"Upgrade to tencentcloud-sdk-python-oceanus and use the new import paths.","message":"Older versions (pre-3.0) used a different package name and import structure. If you see imports from 'oceanus' or 'qcloudoceanus', you are using a deprecated version.","severity":"deprecated","affected_versions":"<3.0.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.oceanus.v20190422 import oceanus_client; client = oceanus_client.OceanusClient(...)","cause":"Trying to import OceanusClient from the wrong submodule (e.g., from models).","error":"ImportError: cannot import name 'OceanusClient' from 'tencentcloud.oceanus.v20190422'"},{"fix":"Set TENCENTCLOUD_SECRET_ID and TENCENTCLOUD_SECRET_KEY environment variables, or pass them explicitly to credential.Credential.","cause":"Missing or incorrect credentials in environment variables or code.","error":"TencentCloudSDKException: The SecretId and SecretKey are not set correctly"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}