环境准备

1. 运行环境

   Python SDK 支持在 Python 2.7 和 Python 3.x 的环境下运行。建议在安装前确认本地 Python 与 pip 可用。

1python3 --version
2pip3 --version

2. 安装 pycrypto 依赖

   安装 SDK 之前，需要先执行以下命令安装 pycrypto 依赖。

   Bash 复制

   1pip3 install pycrypto

   如果安装失败，请执行以下命令安装 pycryptodome。

   Bash 复制

   1pip3 install pycryptodome

3. 查看当前使用的 SDK 版本

   安装完成后，可以通过以下 Python 示例查看当前使用的 SDK 版本。

   Python 复制

   1import baidubce
   2
   3sdk_version = baidubce.SDK_VERSION
   4if isinstance(sdk_version, bytes):
   5    sdk_version = sdk_version.decode("utf-8", errors="replace")
   6
   7print(sdk_version)

   参数说明：

   参数	必填	说明
   baidubce.SDK_VERSION	是	当前 Python 环境中已安装并加载的百度智能云 Python SDK 版本号。

   示例输出：

   Text 复制

   10.9.71

下载和安装

方式一：通过 pip 安装

您可以通过 pip 安装的方式将百度智能云 Python SDK 安装到您的环境中。联网状态下，在命令行中执行如下命令：

1pip3 install bce-python-sdk

即可将 Python SDK 安装到本地。

方式二：将源码包下载到本地后进行安装

1. 在 开发者资源中心 下载 Python SDK 压缩工具包。

2. 命令行移动到压缩包所在路径，执行如下命令（version 替换为包名称中的版本号）：

   Bash 复制

   1pip3 install bce-python-sdk-version.zip

   即可将 Python SDK 安装到本地。

您也可以解压压缩包后执行如下命令（version 替换为包名称中的版本号）：

1cd bce-python-sdk-version
2
3python setup.py install

来完成 SDK 的安装。

SDK 目录结构

1baidubce
2├── auth                              // 公共权限目录
3├── http                              // Http 请求模块
4├── services                          // 服务公共目录
5│   └── bos                           // BOS 目录
6│       ├── bos_client.py             // BOS 客户端入口类
7│       ├── bos_handle.py             // HTTP response 处理函数
8│       ├── canned_acl.py             // 权限控制需要的常量
9│       └── storage_class.py          // 存储类型定义模块
10├── bce_base_client.py                // BCE 客户端入口类的基类
11├── bce_client_configuration.py       // 针对 BOS 特有的 HttpClient 的配置类
12├── bce_response.py                   // BCE 客户端的请求类
13├── exception.py                      // BCE 客户端的异常类
14├── protocol.py                       // 网络协议定义
15├── region.py                         // 区域处理模块
16├── retry_policy.py                   // BCE 服务公共配置类
17└── utils.py                          // BCE 公用工具类

卸载 SDK

预期卸载 SDK 时，使用 pip 卸载 bce-python-sdk 即可。

1pip3 uninstall bce-python-sdk