前置概念

閱讀本文前，若您還不了解阿里云CLI，請參見什么是阿里云CLI。

安裝阿里云CLI

使用阿里云CLI前，您需要先安裝阿里云CLI。阿里云CLI為用戶提供了Windows、Linux和macOS三種操作系統(tǒng)下的安裝服務(wù)，請根據(jù)您使用設(shè)備的操作系統(tǒng)選擇對應(yīng)的安裝服務(wù)。

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

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

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

您也可使用阿里云提供的云命令行Cloud Shell調(diào)試阿里云CLI命令。關(guān)于云命令行的更多信息，請參閱什么是云命令行。

配置阿里云CLI

使用阿里云CLI之前，您需要在阿里云CLI中配置身份憑證、地域ID等信息。阿里云CLI支持多種身份憑證，詳情請參見身份憑證類型。本文操作以AK類型憑證為例，具體操作步驟如下：

1. 您需要創(chuàng)建一個RAM用戶并授予相應(yīng)操作權(quán)限。具體操作，請參見創(chuàng)建RAM用戶及為RAM用戶授權(quán)。

   重要

   本示例需要您為RAM用戶授予AliyunCDNReadOnlyAccess權(quán)限策略。您也可以按需選擇AliyunCDNFullAccess權(quán)限（具有查詢、修改CDN域名的完全控制權(quán)限）或進(jìn)行自定義策略，更多信息請參見CDN自定義權(quán)限策略參考。

2. 創(chuàng)建RAM用戶并授權(quán)后，您需要創(chuàng)建RAM用戶對應(yīng)的AccessKey，并記錄AccessKey ID和AccessKey Secret，以便后續(xù)配置身份憑證使用。具體操作，請參見創(chuàng)建AccessKey。

3. 您需要獲取并記錄可用的地域ID，以便后續(xù)配置身份憑證使用。阿里云CLI將使用您指定的地域發(fā)起API調(diào)用，可用地域請參見請求結(jié)構(gòu)。

   說明

   使用阿里云CLI過程中您可使用--region選項指定地域發(fā)起命令調(diào)用，該選項在使用時將忽略默認(rèn)身份憑證配置及環(huán)境變量設(shè)置中的地域信息。詳情請參見API命令可用選項。

4. 使用RAM用戶的AccessKey配置AK類型憑證，配置文件命名為AkProfile。具體操作，請參見服務(wù)接入點。

生成CLI命令示例

1. 登錄CDN API調(diào)試列表。

2. 在API調(diào)試界面左側(cè)搜索框中可搜索您需要使用的API。在參數(shù)配置中根據(jù)API文檔信息填寫參數(shù)，單擊參數(shù)配置右側(cè)的CLI示例頁簽即可生成攜帶參數(shù)的命令示例。

   • 單擊按鈕，可喚出云命令行Cloud Shell并在其中快速完成命令調(diào)試。

   • 單擊按鈕，將CLI示例復(fù)制到剪貼板中，可粘貼至本地Shell工具中運行。

     • 復(fù)制CLI示例到本地Shell工具中進(jìn)行調(diào)試時請注意參數(shù)格式。關(guān)于阿里云CLI命令參數(shù)使用格式的詳細(xì)信息，請參見參數(shù)格式說明。

     • OpenAPI門戶生成示例中會默認(rèn)添加--region選項，復(fù)制命令到本地調(diào)用時阿里云CLI將忽略默認(rèn)身份憑證配置及環(huán)境變量設(shè)置中的地域信息，優(yōu)先使用指定的地域調(diào)用命令，您可根據(jù)需要對該選項進(jìn)行刪除或保留。

調(diào)用API

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