命令行工具 CLI：配置命令行工具和SDK：专有云和专有域版

注意：本文档内容仅适用于专有云、专有域用户配置其命令行工具，公共云用户请参见 配置命令行工具（公共云版）。
安装好命令行工具后，您需要先配置安全证书，证书是工具和阿里云基础服务之间必须的凭证，所有命令的请求都必须包含这些信息。所以您首先要在可连网的设备上创建 access key。
除证书外，您还可以配置您专有云或专有域的 RegionId 和命令行工具默认的输出格式，如  text、table 或 json。
请您确保按照以下步骤配置命令行工具：

• 
  创建 access key
• 
  添加专有云和专有域的 RegionId
• 
  配置命令行工具

创建 access key


专有云和专有域用户需要申请两个账号：UserID（UID）和 Business ID（BID）。UID 和 BID 都有自己对应的 access key ID 和 access keysecrete。UID 账号用于执行管理阿里云资产的操作。BID 账号用于执行与费用相关的操作，如创建、删除、变配阿里云资产等，但 BID账号无法管理阿里云资产。因此，在您进行不同的操作时，请使用相应账号的 access key ID 和 access key secrete配置命令行工具。
以下为 UID 账号下可执行命令的示例：

1. aliyuncli ecs StartInstance --InstanceId  i-3XXXXkts

1. aliyuncli ecs RebootInstance --InstanceId  i-37XXXXX

以下为 BID 账号下可执行命令的示例：

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

创建 UID 及其 access key

1. 
   执行如下命令，下载并安装 AAS 的 SDK。 $ sudo pip install aliyun-python-sdk-aas

执行如下命令，创建您的 UID/AliyunId 和 PK 码。

1. aliyuncli aas CreateAliyunAccount

系统显示如下类似信息，则表明 UID 和 PK 码创建成功。

执行如下命令，创建您的 access key ID 和 access key secret。

1. 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
亚太（新加坡）	ap-southeast-1
深圳	cn-shenzhen
青岛	cn-qingdao
北京	cn-beijing
上海	cn-shanghai
美东	us-east-1
香港	cn-hongkong
杭州	cn-hangzhou
美国硅谷	us-west-1

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

1. aliyuncli ecs DescribeRegions --output json

注意：在公网账号下，该查询结果显示公网所支持的 RegionId。在专有云和专有域账号下，该查询结果显示您购买的专有云或专有域所支持的 RegionId。

添加专有云的 RegionId 和修改接入点信息


阿里云命令行工具默认不会包含专有云用户的 RegionId 以及接入点信息，RegionId 和接入点信息是写在 SDK 里面的。专有云用户可以通过以下两种方法添加您专有域的 RegionId 和修改接入点信息:
方法一：通过直接修改文件添加 RegionId 和修改接入点信息
添加 RegionId 时，可直接修改文件。找到 aliyunsdkcore 这个 SDK 下面的 endpoints.xml 文件，找到RegionIds。Windows系统的参考路径为：C:\Python27\Lib\site-packages\aliyunsdkcore，Linux 系统的参考路径为:/usr/local/lib/python2.7/site-packages/aliyunsdkcore。
按照如下格式添加您的 RegionId 即可。

1. <RegionIds>
2.             <RegionId>cn-beijing</RegionId>
3.             <RegionId>cn-qingdao</RegionId>
4.             <RegionId>cn-hangzhou</RegionId>
5.             <RegionId>cn-hongkong</RegionId>
6.             <RegionId>cn-shanghai-et2-b01</RegionId>
7.             <RegionId>cn-shanghai</RegionId>
8.             <RegionId>us-west-1</RegionId>
9.             <RegionId>cn-shanghai-et2-test01</RegionId>
10.             <RegionId>cn-shenzhen</RegionId>
11.             <RegionId>ap-southeast-1</RegionId>
12.     </RegionIds>

修改接入点信息时，您只需要将 DomainName 修改为您的 DomainName 即可。请联系专有云用户的产品经理查询该信息。以修改 ECS 产品的接入点为例，请按照以下方法进行修改。

1. <Product>
2.     <ProductName>Ecs</ProductName>
3.     <DomainName>ecs.aliyuncs.com</DomainName>
4. </Product>

方法二：通过命令行工具添加 RegionId 和修改接入点信息
通过命令行工具添加 RegionId 和修改接入点信息，但只有 v1.0.7 以上版本的命令行工具才支持此功能。专有云用户必须同时设置 RegionId 和接入点，主要是为了防止用户遗漏其中任何一个部分，导致修改失败，工具无法使用。
在 Windows 环境下，执行如下命令，设置专有域名称和接入点。

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

在 Linux/UNIX 和 Mac OS 环境下，执行如下命令，设置专有域名称和接入点。

1. 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:\Python27\Lib\site-packages\aliyunsdkcore，Linux 系统的参考路径为:/usr/local/lib/python2.7/site-packages/aliyunsdkcore。
按照如下格式添加您的 RegionId 即可。

1. <RegionIds>
2.             <RegionId>cn-beijing</RegionId>
3.             <RegionId>cn-qingdao</RegionId>
4.             <RegionId>cn-hangzhou</RegionId>
5.             <RegionId>cn-hongkong</RegionId>
6.             <RegionId>cn-shanghai</RegionId>
7.             <RegionId>us-west-1</RegionId>
8.             <RegionId>cn-shanghai-et2-test01</RegionId>
9.             <RegionId>cn-shenzhen</RegionId>
10.             <RegionId>ap-southeast-1</RegionId>
11.     </RegionIds>

方法二：通过命令行工具添加 RegionId
通过命令行工具添加，但只有 v1.0.7 以上版本的命令行工具才支持此功能。专有域用户请不要对 —EndPoint ecs.aliyuncs.com 做任何修改。
在 Windows 环境下，执行如下命令，添加专有域名称。

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

在 Linux/UNIX 和 Mac OS 环境下，执行如下命令，添加专有域名称。

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

注意：此命令并不会直接显示在在线帮助中，因为此命令错误执行时，会导致 CLI 无法使用。因此您在使用时，需要清楚了解自己在做的操作。

配置命令行工具的参数


在 Windows 环境下，执行如下命令，打开并填写所列参数。

1. cd C:\Python27
2. aliyuncli configure
3. Aliyun Access Key ID [None]: <输入 Access Key ID>
4. Aliyun Access Key Secret [None]: <输入 Access Key Secret>
5. Default Region Id [None]: <输入实例的 Region Id>
6. Default output format [None]: <输入您需要的输出格式>

在 Linux/UNIX 和 Mac OS 环境下，执行如下命令，打开并填写所列参数。

1. $ sudo aliyuncli configure
2. Aliyun Access Key ID [None]: <输入 Access Key ID>
3. Aliyun Access Key Secret [None]: <输入 Access Key Secret>
4. Default Region Id [None]: <输入您专有云或专有域的 Region Id>
5. Default output format [None]: <输入您需要的输出格式>

修改命令行工具的参数


若需要修改命令行工具中的参数设置，请执行aliyuncli configure命令。不需修改的参数，请直接按 Enter 键；需要修改的参数，请输入新的参数值。请参见以下案例。
在 Windows 环境下，执行如下命令：

1. cd C:\Python27
2. aliyuncli configure
3. Aliyun Access Key ID [************jkf]: <Enter>
4. Aliyun Access Key Secret [***************Okl]: <Enter>
5. Default Region Id [cn-qingdao]: cn-hangzhou
6. Default output format [table]: <Enter>

在 Linux/UNIX 和 Mac OS 环境下，执行如下命令：

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