100      財經資訊

專有雲和專有域版__配置命令行工具和 SDK_用戶指南_命令行工具 CLI-阿裏雲

注意：本文檔內容僅適用於專有雲、專有域用戶配置其命令行工具，公共雲用戶請參見配置命令行工具（公共雲版）。

安裝好命令行工具後，您需要先配置安全證書，證書是工具和阿裏雲基礎服務之間必須的憑證，所有命令的請求都必須包含這些信息。所以您首先要在可連網的設備上創建 access key。

除證書外，您還可以配置您專有雲或專有域的 RegionId 和命令行工具默認的輸出格式，如 text、table 或 json。

請您確保按照以下步驟配置命令行工具：

• 創建 access key

• 添加專有雲和專有域的 RegionId

• 配置命令行工具

創建 access key

專有雲和專有域用戶需要申請兩個賬號：User ID（UID）和 Business ID（BID）。UID 和 BID 都有自己對應的 access key ID 和 access key secrete。UID 賬號用於執行管理阿裏雲資產的操作。BID 賬號用於執行與費用相關的操作，如創建、刪除、變配阿裏雲資產等，但 BID 賬號無法管理阿裏雲資產。因此，在您進行不同的操作時，請使用相應賬號的 access key ID 和 access key secrete 配置命令行工具。

以下為 UID 賬號下可執行命令的示例：

aliyuncli ecs StartInstance --InstanceId  i-3XXXXkts

aliyuncli ecs RebootInstance --InstanceId  i-37XXXXX

以下為 BID 賬號下可執行命令的示例：

aliyuncli ecs DeleteInstance --InstanceId  iXXXXXXk3 --OwnerAccount zXXXXXXXXXer@aliyun.com

創建 UID 及其 access key

1. 執行如下命令，下載並安裝 AAS 的 SDK。

    $ sudo pip install aliyun-python-sdk-aas

2. 執行如下命令，創建您的 UID/AliyunId 和 PK 碼。

    aliyuncli aas CreateAliyunAccount

   係統顯示如下類似信息，則表明 UID 和 PK 碼創建成功。

   

3. 執行如下命令，創建您的 access key ID 和 access key secret。

    aliyuncli aas CreateAccessKeyForAccount --PK XXXXXXX

   係統顯示如下類似信息，則表明 access key Id 和 access key secret 創建成功。

   

創建 BID 及其 access key

1. 創建阿裏雲公共雲賬號 UID。

2. 將步驟1中創建的 UID 賬號交給阿裏雲商務經理，商務經理將為您創建 BID 賬號。

3. 用 BID 賬號登錄阿裏雲官網的管理控製台 https://www.aliyun.com/。

4. 點擊 AccessKeys，查看您 BID 賬號的 access key ID 和 access key secrete。

   注意：若出現如下提示框，請點擊繼續使用 Accesskey。

   

添加專有雲和專有域的 RegionId

專有雲和專有域用戶的 RegionId 與公網默認的可能不同，在配置命令行工具之前，專有雲和專有域用戶需要把自己的 RegionId 添加到命令行工具的 endpoints.xml 文檔中。另外，專有雲用戶同時還需要修改其接入點（endpoint）的信息。

用戶在購買專有雲和專有域時，即會獲得其專有雲和專有域的 RegionId。目前，公網支持的 RegionId 如下表所示：

您可使用如下命令查詢最新的 RegionId。

aliyuncli ecs DescribeRegions --output json

注意：在公網賬號下，該查詢結果顯示公網所支持的 RegionId。在專有雲和專有域賬號下，該查詢結果顯示您購買的專有雲或專有域所支持的 RegionId。

添加專有雲的 RegionId 和修改接入點信息

阿裏雲命令行工具默認不會包含專有雲用戶的 RegionId 以及接入點信息，RegionId 和接入點信息是寫在 SDK 裏麵的。專有雲用戶可以通過以下兩種方法添加您專有域的 RegionId 和修改接入點信息:

方法一：通過直接修改文件添加 RegionId 和修改接入點信息

添加 RegionId 時，可直接修改文件。找到 aliyunsdkcore 這個 SDK 下麵的 endpoints.xml 文件，找到 RegionIds。Windows 係統的參考路徑為：C:Python27Libsite-packagesaliyunsdkcore，Linux 係統的參考路徑為: /usr/local/lib/python2.7/site-packages/aliyunsdkcore。

按照如下格式添加您的 RegionId 即可。

<RegionIds>
            <RegionId>cn-beijing</RegionId>
            <RegionId>cn-qingdao</RegionId>
            <RegionId>cn-hangzhou</RegionId>
            <RegionId>cn-hongkong</RegionId>
            <RegionId>cn-shanghai-et2-b01</RegionId>
            <RegionId>cn-shanghai</RegionId>
            <RegionId>us-west-1</RegionId>
            <RegionId>cn-shanghai-et2-test01</RegionId>
            <RegionId>cn-shenzhen</RegionId>
            <RegionId>ap-southeast-1</RegionId>
    </RegionIds>

修改接入點信息時，您隻需要將 DomainName 修改為您的 DomainName 即可。請聯係專有雲用戶的產品經理查詢該信息。以修改 ECS 產品的接入點為例，請按照以下方法進行修改。

<Product>
    <ProductName>Ecs</ProductName>
    <DomainName>ecs.aliyuncs.com</DomainName>
</Product>

方法二：通過命令行工具添加 RegionId 和修改接入點信息

通過命令行工具添加 RegionId 和修改接入點信息，但隻有 v1.0.7 以上版本的命令行工具才支持此功能。專有雲用戶必須同時設置 RegionId 和接入點，主要是為了防止用戶遺漏其中任何一個部分，導致修改失敗，工具無法使用。

在 Windows 環境下，執行如下命令，設置專有域名稱和接入點。

aliyuncli ecs ModifyEndPoint --RegionId my-region-id --EndPoint my.ecs.domainname.com

在 Linux/UNIX 和 Mac OS 環境下，執行如下命令，設置專有域名稱和接入點。

sudo aliyuncli ecs ModifyEndPoint --RegionId my-region-id --EndPoint my.ecs.domainname.com

注意：此命令並不會直接顯示在在線幫助中，因為此命令錯誤執行時，會導致命令行工具無法使用。因此您在執行該命令時，需要清楚了解自己在做的操作。

添加專有域的 RegionId

阿裏雲命令行工具默認不會包含專有域用戶的 RegionId，RegionId 的信息是寫在 SDK 裏麵的。專有域用戶可以通過以下兩種方法添加自己的專有域名稱。

方法一：通過直接修改文件添加 RegionId

直接修改文件。找到 aliyunsdkcore 這個 SDK 下麵的 endpoints.xm l文件，找到 RegionIds。Windows 係統的參考路徑為：C:Python27Libsite-packagesaliyunsdkcore，Linux 係統的參考路徑為: /usr/local/lib/python2.7/site-packages/aliyunsdkcore。

按照如下格式添加您的 RegionId 即可。

<RegionIds>
            <RegionId>cn-beijing</RegionId>
            <RegionId>cn-qingdao</RegionId>
            <RegionId>cn-hangzhou</RegionId>
            <RegionId>cn-hongkong</RegionId>
            <RegionId>cn-shanghai</RegionId>
            <RegionId>us-west-1</RegionId>
            <RegionId>cn-shanghai-et2-test01</RegionId>
            <RegionId>cn-shenzhen</RegionId>
            <RegionId>ap-southeast-1</RegionId>
    </RegionIds>

方法二：通過命令行工具添加 RegionId

通過命令行工具添加，但隻有 v1.0.7 以上版本的命令行工具才支持此功能。專有域用戶請不要對 —EndPoint ecs.aliyuncs.com 做任何修改。

在 Windows 環境下，執行如下命令，添加專有域名稱。

aliyuncli ecs ModifyEndPoint --RegionId my-region-id --EndPoint ecs.aliyuncs.com

在 Linux/UNIX 和 Mac OS 環境下，執行如下命令，添加專有域名稱。

sudo aliyuncli ecs ModifyEndPoint --RegionId my-region-id --EndPoint ecs.aliyuncs.com

注意：此命令並不會直接顯示在在線幫助中，因為此命令錯誤執行時，會導致 CLI 無法使用。因此您在使用時，需要清楚了解自己在做的操作。

配置命令行工具的參數

在 Windows 環境下，執行如下命令，打開並填寫所列參數。

cd C:Python27
aliyuncli configure
Aliyun Access Key ID [None]: <輸入 Access Key ID>
Aliyun Access Key Secret [None]: <輸入 Access Key Secret>
Default Region Id [None]: <輸入實例的 Region Id>
Default output format [None]: <輸入您需要的輸出格式>

在 Linux/UNIX 和 Mac OS 環境下，執行如下命令，打開並填寫所列參數。

$ sudo aliyuncli configure
Aliyun Access Key ID [None]: <輸入 Access Key ID>
Aliyun Access Key Secret [None]: <輸入 Access Key Secret>
Default Region Id [None]: <輸入您專有雲或專有域的 Region Id>
Default output format [None]: <輸入您需要的輸出格式>

修改命令行工具的參數

若需要修改命令行工具中的參數設置，請執行aliyuncli configure命令。不需修改的參數，請直接按 Enter 鍵；需要修改的參數，請輸入新的參數值。請參見以下案例。

在 Windows 環境下，執行如下命令：

cd C:Python27
aliyuncli configure
Aliyun Access Key ID [************jkf]: <Enter>
Aliyun Access Key Secret [***************Okl]: <Enter>
Default Region Id [cn-qingdao]: cn-hangzhou
Default output format [table]: <Enter>

在 Linux/UNIX 和 Mac OS 環境下，執行如下命令：

$ sudo aliyuncli configure
Aliyun Access Key ID [************jkf]: <Enter>
Aliyun Access Key Secret [***************Okl]: <Enter>
Default Region Id [cn-qingdao]: cn-hangzhou
Default output format [table]: <Enter>

最後更新：2016-11-23 16:04:06

  上一篇： 公共雲版__配置命令行工具和 SDK_用戶指南_命令行工具 CLI-阿裏雲

  下一篇： 全局 SDK 版本配置__配置命令行工具和 SDK_用戶指南_命令行工具 CLI-阿裏雲