MediaClient
更新时间：2025-08-21
配置MediaClient
MediaClient是Media服务的Python客户端，为调用者与Media服务进行交互提供了一系列的方法。
在新建MediaClient之前，需要先创建配置文件对MediaClient进行配置，以下将此配置文件命名为conf.py，具体配置信息如下所示：
Plain Text
1#!/usr/bin/env python
2#coding=utf-8
3
4#导入Python标准日志模块
5import logging
6
7#从Python SDK导入Media配置管理模块以及安全认证模块
8from baidubce.bce_client_configuration import BceClientConfiguration
9from baidubce.auth.bce_credentials import BceCredentials
10
11#设置MediaClient的Host，Access Key ID和Secret Access Key
12media_host = "http://media.bj.baidubce.com"
13access_key_id = "your-access-key-id"
14secret_access_key = "your-secret-access-key"
15
16#设置日志文件的句柄和日志级别
17logger = logging.getLogger('baidubce.services.media.mediaclient')
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(access_key_id, secret_access_key), endpoint = media_host)注意：
1.在上面的代码中，变量AK与SK是系统分配给用户的，用于标识用户，为访问Media做签名验证。其中AK对应控制台中的“Access Key ID”，SK对应控制台中的“Access Key Secret”，获取方式请参考《操作指南 管理ACCESSKEY》。
2.ENDPOINT参数只能用指定的包含Region的域名来进行定义，目前MCP提供了“华北-北京”、“华南-广州”和“华东-苏州”三个Region。详细的服务域名可以参考：服务域名。随着Region的增加将会开放其他可以支持的域名。
新建MediaClient
在完成上述配置之后，参考如下代码新建一个MediaClient。
Plain Text
1import conf
2import sys
3from baidubce import exception
4from baidubce.services import media
5from baidubce.services.media.media_client import MediaClient
6
7# create new MediaClient
8client = MediaClient(conf.config)
9reload(sys)
10sys.setdefaultencoding('utf-8')
11print client.list_pipelines()参数说明
Python SDK在baidubce\bce_client_configuration.py中默认设置了一些基本参数，若用户想要对参数的值进行修改，可以参考此文件创建自身的参数配置函数，并在构造MediaClient的时候传入，传入代码参考如下：
Plain Text
1from baidubce.retry_policy import BackOffRetryPolicy
2from baidubce.bce_client_configuration import BceClientConfiguration
3from baidubce.auth.bce_credentials import BceCredentials
4from baidubce.protocol import HTTP
5from baidubce.region import BEIJING
6
7my_policy = BackOffRetryPolicy(max_error_retry = 3,
8 max_delay_in_millis=20 * 1000,
9 base_interval_in_millis=300)
10
11my_config = BceClientConfiguration(
12 credentials = BceCredentials('your-access-key-id', 'your-secret-access-key'),
13 endpoint = media_host,
14 protocol = baidubce.protocol.HTTP,
15 region = baidubce.region.BEIJING,
16 connection_timeout_in_mills = 50 * 1000,
17 send_buf_size = 1024 * 1024,
18 recv_buf_size = 10 * 1024 * 1024,
19 retry_policy = my_policy)
20
21
22# create MediaClient with my config
23my_client = MediaClient(my_config)
24
25pipelines = client.list_pipelines()
26for pipeline in pipelines.pipelines:
27 print pipeline参数说明如下：
| 参数 | 说明 | 默认值 |
|---|---|---|
| PROTOCOL | 协议 | baidubce.protocol.HTTP |
| REGION | 区域 | baidubce.region.BEIJING（目前只支持北京地区） |
| CONNECTION_TIMEOUT_IN_MILLIS | 请求超时时间（单位：毫秒） | 120 * 1000 |
| SOCKET_TIMEOUT_IN_MILLIS | 通过打开的连接传输数据的超时时间（单位：毫秒） | 300 * 1000（0指的是无限等待，若设置非0数值需要对文件大小和网速进行评估，否则上传大文件时会产生超时） |
| SEND_BUF_SIZE | 发送缓冲区大小 | 5 1024 1024 |
| RECV_BUF_SIZE | 接收缓冲区大小 | 5 1024 1024 |
| retry_policy | 重试逻辑 | 最大重试次数3次, 超时时间为20 * 1000毫秒，重试间隔300毫秒 |
相关说明
MediaClient将可选的参数封装到config中，每一个方法具有的可选参数详见具体的接口使用方法介绍，现以create_pipeline方法为例，参考如下代码实现设置可选参数：
Plain Text
1#利用options在通过创建Pipeline传入指定可选参数
2my_config = BceClientConfiguration(
3 credentials = BceCredentials('your-access-key-id', 'your-secret-access-key'),
4 endpoint = media_host,
5 send_buf_size = 5 * 1024 * 1024)
6client.create_pipeline('your_pipeline', 'your_source_bucket', 'your_source_bucket', config=my_config);