CLI集成示例

前置概念

阅读本文前，若您还不了解阿里云CLI，请参见什么是阿里云CLI。

前提条件

使用阿里云CLI之前，如果您还没有账号，请访问阿里云官网注册阿里云账号（主账号），同时建议您创建专用于API访问的RAM用户。具体操作可参见创建RAM用户。

安装阿里云CLI

使用阿里云CLI前，您需要先安装阿里云CLI。阿里云CLI为用户提供了Windows、Linux和macOS三种操作系统下的安装服务，请根据您使用设备的操作系统选择对应的安装服务。

• Windows：在Windows上安装阿里云CLI。

• Linux：在Linux上安装阿里云CLI。

• macOS：在macOS上安装阿里云CLI。

您也可使用阿里云提供的云命令行Cloud Shell调试阿里云CLI命令。关于云命令行的更多信息，请参阅什么是云命令行？。

配置阿里云CLI

使用阿里云CLI之前，您需要在阿里云CLI中配置身份凭证、地域ID等信息。阿里云CLI支持多种身份凭证，详情请参见身份凭证类型。本文操作以AK类型凭证为例，具体操作步骤如下：

1. 您需要创建一个RAM用户并根据需要授予管理对应产品的权限。具体操作，请参见创建RAM用户及为RAM用户授权。

2. 创建RAM用户并授权后，您需要创建RAM用户对应的AccessKey，并记录AccessKey ID和AccessKey Secret，以便后续配置身份凭证使用。具体操作，请参见创建AccessKey。

3. 您需要获取并记录可用的地域ID，以便后续配置身份凭证使用。阿里云CLI将使用您指定的地域发起API调用。可用地域请参见服务接入点。

   说明

   使用阿里云CLI过程中您可使用--region选项指定地域发起命令调用，该选项在使用时将忽略默认身份凭证配置及环境变量设置中的地域信息。详情请参见API命令可用选项。

4. 使用RAM用户的AccessKey配置AK类型凭证，配置文件命名为AkProfile。具体操作，请参见配置示例。

生成CLI命令示例

1. 登录视频点播API调试列表。

2. 在API调试界面左侧搜索框中可搜索您需要使用的API。在参数配置中根据API文档信息填写参数，单击参数配置右侧的CLI示例页签即可生成携带参数的命令示例。

• 单击运行命令按钮，可唤出云命令行Cloud Shell并在其中快速完成命令调试。

• 单击复制按钮，将CLI示例复制到剪贴板中，可粘贴至本地Shell工具中运行。

  • 复制CLI示例到本地Shell工具中进行调试时请注意参数格式。关于阿里云CLI命令参数使用格式的详细信息，请参见参数格式说明。

  • OpenAPI门户生成示例中会默认添加--region选项，复制命令到本地调用时阿里云CLI将忽略默认身份凭证配置及环境变量设置中的地域信息，优先使用指定的地域调用命令，您可根据需要对该选项进行删除或保留。

调用API

命令结构

阿里云CLI的通用命令行结构如下。更多详情，请参见命令结构。

aliyun <command> <subcommand> [options and parameters]

常用命令选项

在阿里云CLI中，您可根据需要使用命令行选项，用来修改命令的默认行为或为命令提供额外功能。常用命令行选项如下：

• --profile <profileName>：使用--profile选项并指定有效配置名称profileName后，阿里云CLI将忽略默认身份凭证配置及环境变量设置，优先使用指定的配置进行命令调用。

• --help：在需要获取帮助的命令层级处键入--help选项，即可获取该命令的帮助信息。更多详情，请参见获取帮助信息。

更多详细信息，请参见API命令可用选项。

调用示例

示例一：以下代码示例将为您展示如何使用--help选项获取视频点播支持阿里云CLI调用API列表。您也可在API概览中查看支持调用的API。

1. 执行命令。

   aliyun vod --help

2. 输出结果

示例二：以下代码示例将为您展示如何使用阿里云CLI调用视频点播中的SearchMedia命令，搜索当前账号媒资信息。

1. 执行命令。

   aliyun vod SearchMedia --region cn-shanghai --PageSize 1

2. 输出结果。

   {
       "MediaList": [
           {
               "AiData": {},
               "AiRoughData": {},
               "AttachedMedia": {},
               "Audio": {},
               "CreationTime": "2024-08-16T09:36:00Z",
               "Image": {},
               "MediaId": "50798ff*************************",
               "MediaType": "video",
               "Video": {
                   "VideoId": "50798ff*************************"
               }
           }
       ],
       "RequestId": "45D92389-12CA-****-****-************",
       "ScrollToken": "5a0c898*************************",
       "Total": 1409
   }