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-阿里云