Python

最近更新时间:2019-08-06 19:57:18

简介

欢迎使用腾讯云开发者工具套件(SDK)3.0,SDK3.0 是云 API3.0 平台的配套工具。目前已经支持 CVM、VPC、CBS 等产品,后续所有的云服务产品都会接入进来。新版 SDK 实现了统一化,具有各个语言版本的 SDK 使用方法相同,接口调用方式相同,统一的错误码和返回包格式这些优点。
为方便 Python 开发者调试和接入腾讯云产品 API,这里向您介绍适用于 Python 的腾讯云开发工具包,并提供首次使用开发工具包的简单示例。让您快速获取腾讯云 Python SDK 并开始调用。

支持 3.0 版本的产品列表

SDK3.0支持全部 API3.0下的产品,本列表可能滞后于实际代码,如有疑问请咨询具体的产品。

云服务器 黑石物理服务器 云硬盘 容器服务 容器实例服务
弹性伸缩 无服务器云函数 批量计算 负载均衡 私有网络
专线接入 云数据库 MySQL 云数据库 Redis 云数据库 MongoDB 数据传输服务 DTS
云数据库 MariaDB 分布式数据库 DCDB 云数据库 SQL Server 云数据库 PostgreSQL 内容分发网络
主机安全 Web 漏洞扫描 应用安全 云点播 云直播
智能语音服务 机器翻译 催收机器人 智聆口语评测 腾讯优评
Elasticsearch Service 物联网通信 TBaaS 云监控 迁移服务平台
电子合同服务 计费相关 渠道合作伙伴 人脸核身-云智慧眼 威胁情报云查
样本智能分析平台 数学作业批改 人脸融合 人脸识别 数字版权管理

API Explorer

API Explorer 提供了在线调用、签名验证、 SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

依赖环境

  1. 依赖环境:Python 2.7 到 3.6 版本。
  2. 腾讯云控制台 开通相应产品。
  3. 获取 SecretID、SecretKey 以及调用地址(endpoint),endpoint 一般形式为*.tencentcloudapi.com,如CVM 的调用地址为 cvm.tencentcloudapi.com,具体参考各产品说明。

获取安装

安装 Python SDK 前,先获取安全凭证。在第一次使用云 API 之前,用户首先需要在腾讯云控制台上申请安全凭证,安全凭证包括 SecretID 和 SecretKey,SecretID 是用于标识 API 调用者的身份,SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。SecretKey 必须严格保管,避免泄露。

通过 Pip 安装(推荐)

您可以通过 pip 安装方式将腾讯云 API Python SDK 安装到您的项目中,如果您的项目环境尚未安装 pip,请详细参见 pip 官网 安装。
通过 pip 方式安装请在命令行中执行以下命令:

pip install tencentcloud-sdk-python

通过源码包安装

前往 Github 代码托管地址 或者 快速下载地址 下载最新代码,解压后

    $ cd tencentcloud-sdk-python
    $ python setup.py install

示例

以查询可用区接口为例:

# -*- coding: utf-8 -*-
from tencentcloud.common import credential
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
# 导入对应产品模块的 client models。
from tencentcloud.cvm.v20170312 import cvm_client, models
try:
    # 实例化一个认证对象,入参需要传入腾讯云账户 secretId,secretKey
    cred = credential.Credential("secretId", "secretKey")

    # 实例化要请求产品(以 CVM 为例)的 client 对象
    client = cvm_client.CvmClient(cred, "ap-shanghai")

    # 实例化一个请求对象
    req = models.DescribeZonesRequest()

    # 通过 client 对象调用想要访问的接口,需要传入请求对象
    resp = client.DescribeZones(req)
    # 输出 JSON 格式的字符串回包
    print(resp.to_json_string())

except TencentCloudSDKException as err:
    print(err)

更多示例

您可以在 GitHub 仓库中 examples 目录 下找到更详细的示例。

旧版 SDK

旧版本的 SDK 存放于 QcloudApi 目录,详细使用说明请到 旧版 Python SDK ,但不再维护更新,推荐使用新版 SDK。