全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件

专有云和专有域版

更新时间:2017-06-07 13:26:11

注意:本文档内容仅适用于专有云、专有域用户配置其命令行工具,公共云用户请参见配置命令行工具(公共云版)

安装好命令行工具后,您需要先配置安全证书,证书是工具和阿里云基础服务之间必须的凭证,所有命令的请求都必须包含这些信息。所以您首先要在可连网的设备上创建 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 账号下可执行命令的示例:

  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。

    1. $ sudo pip install aliyun-python-sdk-aas
  2. 执行如下命令,创建您的 UID/AliyunId 和 PK 码。

    1. aliyuncli aas CreateAliyunAccount

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

    创建UID access key

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

    1. aliyuncli aas CreateAccessKeyForAccount --PK XXXXXXX

    系统显示如下类似信息,则表明 access key Id 和 access key secret 创建成功。

    创建UID akID

创建 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。

    AK安全提示

添加专有云和专有域的 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>
本文导读目录