在使用阿里云CLI之前,您需要配置调用阿里云资源所需的凭证信息、地域、语言等。

凭证类型

阿里云CLI可通过在configure命令后添加--mode <authenticationMethod>选项的方式,使用不同的认证方式。目前支持的四种凭证类型,如下表所示。

验证方式 说明 交互式配置凭证(快速) 非交互式配置凭证
AK 使用AccessKeyID和AccessKeySecret访问。 配置AccessKey凭证 配置AccessKey凭证
StsToken 使用STS Token访问。 配置STS Token凭证 配置STS Token凭证
RamRoleArn 使用RAM子账号的AssumeRole方式访问。 配置RamRoleArn凭证 配置RamRoleArn凭证
EcsRamRole 在ECS实例上通过EcsRamRole实现免密验证。 配置EcsRamRole凭证 配置EcsRamRole凭证
说明 除了EcsRamRole凭证无需AccessKey信息,其它三种都需要AccessKey信息。

配置凭证方式

在阿里云CLI中配置凭证时,您可以选择以下两种配置方式,并自行指定配置的凭证类型。下面为您介绍交互式配置方式AccessKey凭证。非交互式配置及其它配置详情,请参见配置凭证方式

  • 交互式配置(快速配置):此配置过程方便快速,您只需要根据提示信息输入相应的值即可。
  • 非交互式配置:即单命令行配置方式,您需要指定配置名称、凭证类型和对应凭证所需的鉴权信息等。

交互式配置简介

使用configure命令来配置凭证。其命令格式如下:

aliyun configure --mode <AuthenticateMode> --profile <profileName>

配置选项说明如下:

  • --profile:指定配置名称。如果指定的配置存在,则修改配置。若不存在,则创建配置。
  • --profile:指定凭证类型,分别为AKStsTokenRamRoleArnEcsRamRole

此配置方式的交互式提示信息中,包含AccessKey信息、RegionId等:

  • 请配置正确的AccessKey信息,否则可能导致误操作或者无法调用接口。
    说明 您可以在阿里云控制台的 AccessKey页面 ,创建和查看您的AccessKey,或者联系您的系统管理员获取AccessKey。
  • 阿里云支持的RegionId详情,请参见地域和可用区

配置AccessKey凭证

在阿里云CLI中,AccessKey凭证类型被命名为AK,且为默认凭证类型。因此,使用该方式快速配置凭证时,可以忽略--mode选项。

配置名为akProfile的AccessKey凭证,示例如下:

aliyun configure --profile akProfile
Configuring profile 'akProfile' in ''
authenticate mode...
Access Key Id []: AccessKey ID
Access Key Secret []: AccessKey Secret
Default Region Id []: cn-hangzhou
Default Output Format [json]: json (Only support json))
Default Language [zh|en] en:
Saving profile[akProfile] ...Done.

命令自动补全功能

在使用阿里云CLI时,您可以通过以下命令开启或关闭自动补全功能,目前仅支持zsh/bash。

  • 开启自动补全功能
    aliyun auto-completion
  • 关闭自动补全功能
    aliyun auto-completion --uninstall