安装SDK工具包
更新时间:2021-10-25
环境准备
-
运行环境
Python SDK工具包支持在Python 2.7 以上环境运行。
-
安装pycrypto依赖
安装SDK之前,需要先执行命令
pip install pycrypto
安装pycrypto依赖。
如果安装失败,请执行pip install pycryptodome
下载和安装
方式一:通过pip安装
您可以通过pip安装的方式将百度智能云Python SDK安装到您的环境中。 联网状态下,在命令行中执行如下命令:
Plain Text
1pip install bce-python-sdk
即可将Python SDK安装到本地。 方式二:将源码包下载到本地后进行安装
- 在开发者资源中心下载Python SDK压缩工具包。
-
命令行移动到压缩包所在路径,执行如下命令(version替换为包名称中的版本号):
Plain Text1pip install bce-python-sdk-version.zip
即可将Python SDK安装到本地。
您也可以解压压缩包后执行如下命令(version替换为包名称中的版本号)
Plain Text
1cd bce-python-sdk-version
2
3python setup.py install
SDK目录结构
Plain Text
1 baidubce
2 ├── auth //公共权限目录
3 ├── services //服务公共目录
4 │ └── mms //MMS目录
5 └── http //Http请求模块
MmsClient
配置MmsClient
通过AK/SK方式访问MMS
MmsClient是 MMS 服务的Python客户端,封装了Restful服务的通信细节,为开发者提供简单易用的交互工具。
在新建MmsClient之前,需要先创建配置文件对MmsClient进行配置,以下将此配置文件命名为mms_sample_conf.py
,具体配置信息如下所示:
Plain Text
1# !/usr/bin/env python
2# coding=utf-8
3
4#导入Python标准日志模块
5import logging
6
7#从Python SDK导入MMS配置管理模块以及安全认证模块
8from baidubce.auth.bce_credentials import BceCredentials
9from baidubce.bce_client_configuration import BceClientConfiguration
10
11#设置MmsClient的Host,Access Key ID和Secret Access Key
12HOST = 'http://mms.bj.baidubce.com'
13AK = 'Fill AK here'
14SK = 'Fill SK here'
15
16#设置日志文件的句柄和日志级别
17logger = logging.getLogger('baidubce.services.mms.mms_client')
18fh = logging.FileHandler('sample.log')
19fh.setLevel(logging.DEBUG)
20
21#设置日志文件输出的顺序、结构和内容
22formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
23fh.setFormatter(formatter)
24logger.setLevel(logging.DEBUG)
25logger.addHandler(fh)
26
27#创建BceClientConfiguration
28config = BceClientConfiguration(credentials=BceCredentials(AK, SK), endpoint=HOST)
注意:
- 针对日志文件,Logging有如下级别:DEBUG,INFO,WARNING,ERROR,CRITICAL。
- MMS为全局服务,服务域名是mms.bj.baidubce.com。
新建MmsClient
在完成上述配置之后,参考如下代码新建一个MmsClient。
Plain Text
1#导入MmsClient配置文件
2import mms_sample_conf
3
4#导入MMS相关模块
5import logging
6from baidubce.services.mms.mms_client import MmsClient
7
8#新建MmsClient
9mms_client = MmsClient(mms_sample_conf.config)
设置自定义参数(可选)
用户可以设置一些网络参数:
Plain Text
1#设置请求超时时间
2mms_sample_conf.config.connection_timeout_in_mills = TIMEOUT
3
4#设置接收缓冲区大小
5mms_sample_conf.config.recv_buf_size(BUF_SIZE)
6
7#设置发送缓冲区大小
8mms_sample_conf.config.send_buf_size(BUF_SIZE)
9
10#设置连接重试策略
11#三次指数退避重试
12mms_sample_conf.config.retry_policy = BackOffRetryPolicy()
13#不重试
14mms_sample_conf.config.retry_policy = NoRetryPolicy()
参数说明
通过mms_sample_conf.config能指定的所有参数如下表所示:
参数 | 说明 |
---|---|
send_buf_size | 发送缓冲区大小 |
recv_buf_size | 接收缓冲区大小 |
connection_timeout_in_mills | 请求超时时间(单位:毫秒) |
retry_policy | 连接重试策略,初始化Client时默认为三次指数退避 |