使用OpenAPI示例_媒体处理(MPS)-阿里云帮助中心

本文为您介绍使用OpenAPI搜索媒体工作流的完整示例。

查看OpenAPI文档

通过阅读API概览得知，搜索媒体工作流的OpenAPI为SearchMediaWorkflow - 搜索媒体工作流。请您根据文档，了解调用该接口需要准备的数据和权限。

创建RAM用户并授权

身份

您可以使用阿里云账号（主账号）、RAM用户、RAM角色调用该接口，有关各种身份的差异，请参见身份、凭证、授权的概述。本案例中，我们使用RAM用户进行接口调用。

登录RAM访问控制，创建一个仅允许API调用的RAM用户，并记录AccessKey信息。具体操作，请参见创建RAM用户。

授权

访问RAM用户列表，单击目标RAM用户操作列的添加权限。
在选择权限区块中输入关键字MTS进行搜索，选择AliyunMTSFullAccess策略。
说明
- 媒体处理的系统权限策略如下：
  - AliyunMTSFullAccess：管理媒体转码服务（MTS）的权限。
  - AliyunMTSPlayerAuth：使用媒体转码服务（MTS）播放器的权限。
- 关于如何创建自定义权限，请参见授权信息。
单击确定，完成授权操作。

凭证

在创建RAM用户时会默认生成一个AccessKey，可直接使用。

您也可以进入到对应的RAM用户详情页面，在认证管理页签，单击创建AccessKey，创建一个新的AccessKey。具体操作，请参见创建AccessKey。

调用OpenAPI

本文以Python语言为例，为您介绍OpenAPI的调用方法。

准备Python环境

下载并安装Python。
Python 3的下载地址，请参见Python 3。
查看Python版本。
- Linux和macOS系统
  打开终端，输入命令python --version。
- Windows系统
  - 在Python的安装路径下，双击python.exe。
  - 打开命令提示符页面。
    通过键盘快捷键Win+R打开运行对话框，在输入框中输入命令python，单击确定。

配置环境变量

为避免将AccessKey硬编码到业务代码中带来的安全风险，本示例采用配置环境变量的方法管理AccessKey。

Linux和macOS系统
将以下命令中的<access_key_id>和<access_key_secret>替换为您自己的AccessKey ID和AccessKey Secret，输入到终端执行。

export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>

Windows系统
新建环境变量文件，添加环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET，并写入已准备好的AccessKey ID和AccessKey Secret。然后重启Windows系统。

安装依赖

pip install alibabacloud_credentials
pip install alibabacloud_mts20140618==3.3.42
pip install alibabacloud_tea_console

下载示例代码

在OpenAPI门户，访问SearchMediaWorkflow - 搜索媒体工作流接口的调试地址。
输入媒体工作流状态列表和分页参数，然后单击发起调用。
调用成功后，单击SDK示例页签，选择Python语言，然后单击下载完整工程，下载Python语言的SDK示例。
在本地解压Python示例代码包，并进入alibabacloud_sample目录。

运行代码

执行以下命令。

python sample.py

得到如下输出结果：

{
	"headers": {
		"date": "Mon, 04 Sep 2023 09:55:25 GMT",
		"content-type": "application/json;charset=utf-8",
		"content-length": "137",
		"connection": "keep-alive",
		"keep-alive": "timeout=25",
		"access-control-allow-origin": "*",
		"access-control-expose-headers": "*",
		"x-acs-request-id": "C4849AF2-D00E-52D0-A959-E6558E*****",
		"x-acs-trace-id": "bff538ce7eaca3faf8600b0140******",
		"etag": "1o4iLdylGKZzvHXcAQ*****"
	},
	"statusCode": 200,
	"body": {
		"MediaWorkflowList": {
			"MediaWorkflow": []
		},
		"PageNumber": 1,
		"PageSize": 10,
		"RequestId": "C4849AF2-D00E-52D0-A959-E6558******",
		"TotalCount": 0
	}
}