环境准备

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

   说明： SDK 实际声明的运行依赖为 pycryptodome>=3.8.0、future>=0.6.0、six>=1.4.0、crc32c>=2.2.post0。通过下文的 pip3 install bce-python-sdk 安装 SDK 时，这些依赖会被自动安装，通常无需手动执行上述命令。

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.80

下载和安装

方式一：通过 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_handler.py            // HTTP response 处理函数
8│       ├── canned_acl.py             // 权限控制需要的常量
9│       ├── common.py                 // BOS 公共常量定义
10│       └── storage_class.py          // 存储类型定义模块
11├── bce_base_client.py                // BCE 客户端入口类的基类
12├── bce_client_configuration.py       // 针对 BOS 特有的 HttpClient 的配置类
13├── bce_response.py                   // BCE 客户端的请求类
14├── exception.py                      // BCE 客户端的异常类
15├── protocol.py                       // 网络协议定义
16├── region.py                         // 区域处理模块
17├── retry                             // 连接重试策略目录
18│   └── retry_policy.py               // 连接重试策略定义（BackOffRetryPolicy、NoRetryPolicy）
19└── utils.py                          // BCE 公用工具类

卸载 SDK

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

1pip3 uninstall bce-python-sdk