文档

使用阿里云CLI管理阿里云资源

更新时间:

阿里云CLI是基于阿里云OpenAPI建立的管理工具,您可在云命令行中使用阿里云CLI快速管理阿里云资源。

前置概念

在云命令行中使用阿里云CLI之前,您可能需要了解以下信息:

  • 阿里云CLI是基于阿里云OpenAPI建立的管理工具,更多信息请参见什么是阿里云CLI

  • 为确保您的阿里云账号及云资源使用安全,推荐您使用RAM身份(即RAM用户和RAM角色)来访问云命令行。使用RAM身份访问云命令行需要授予对应权限,详情请参见基于身份的策略

  • 由于同步需求排期存在多种影响因素,云命令行预装版本通常会在阿里云CLI版本升级后数天内完成同步更新。您可使用aliyun version命令查看阿里云CLI的当前版本信息。您也可手动安装任意版本阿里云CLI。

操作步骤

步骤一:启动云命令行

重要

在启动云命令行之前,您需要使用已授予权限的可用RAM身份登录阿里云主页。云命令行将使用当前登录态为您自动配置身份凭证,无需手动操作。为避免自动配置凭证功能失效,建议您在操作时避免对初始配置文件default进行修改或删除。

您可以通过以下方式启动云命令行:

  • 在控制台中运行

    单击控制台首页顶部导航栏中的云命令行按钮,启动云命令行。

    image

  • 独立运行

    在浏览器中输入https://shell.aliyun.com,打开云命令行操作界面。

说明
  • 云命令行启动时会为您创建一台虚拟机,这个过程将消耗一些时间,最长不超过30秒。

  • 您可以根据实际需要打开多个云命令行窗口,最多可同时打开5个云命令行窗口。多个云命令行窗口会连接到同一台虚拟机,虚拟机数量不会因为您打开新的命令行窗口而增加。

  • 更多信息,请参见什么是云命令行?

步骤二:获取CLI命令

自动生成

说明

OpenAPI门户可以在线生成阿里云CLI所有命令,建议您通过此方式获取需要的命令示例。若您需要更详细的操作步骤,请参见生成命令

在API调试界面左侧搜索框中可搜索您需要使用的API。在参数配置中根据API文档信息填写参数,单击参数配置右侧的CLI示例页签即可生成携带参数的命令示例。

image

  • 单击运行命令image按钮,可唤出云命令行并快速完成命令调试。

  • 单击复制image按钮,将CLI命令示例复制到剪贴板中,可粘贴至云命令行中运行。

手动编写

阿里云云产品的API分为RPC和RESTful两种类型,大部分产品提供RPC API,例如云服务器ECS,云数据库RDS和负载均衡等。

不同类型的API的调用方法也不同。您可以通过以下特点判断API类型:

  • API参数中包含Action字段的是RPC API,需要PathPattern参数的是RESTful API。

  • 一般情况下,一个云产品的API类型是一致的。

更多详情,请参见调用RPC API和RESTful API

获取帮助信息

  • 在Cloud Shell中运行以下命令查看云产品的帮助信息。

    aliyun <ProductCode> --help

    以查看ECS的API列表的帮助信息为例,执行以下命令:

    aliyun ecs --help
  • 在Cloud Shell中运行以下命令查看指定API的帮助信息:

    aliyun <ProductCode> <ApiName> --help

    以查看ECS的DescribeInstanceAttribute接口的帮助信息为例,执行以下命令:

    aliyun ecs DescribeInstanceAttribute --help

步骤三:在云命令行中执行命令

如图所示,在云命令行中执行云服务器 ECSCreateInstance命令,创建一台按量付费ECS实例。

image

相关文档