无配置方式使用Cloud CLI需要注意什么？

无配置方式使用是指在使用Cloud CLI时不通过已有配置项传入当前用户的认证信息，而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项，方便快捷。具体使用方式请参考：无配置方式使用Cloud CLI。

无配置方式使用Cloud CLI时，需要注意如下事项：

• 无配置方式AKSK
  • 访问密钥（永久AK/SK）方式
    • 使用永久AK/SK通过Cloud CLI调用云服务API时，必须同时在命令中传入Access Key ID（cli-access-key），Secret Access Key（cli-secret-key）用于鉴权，缺一不可。
    • 若访问的是全局服务，则在调用过程中还需IAM用户所属账号ID（cli-domain-id）用于鉴权。若未在命令中传入该值，Cloud CLI会根据用户认证信息自动获取；但若缺少cli-access-key或cli-secret-key参数，或自动获取cli-domain-id失败，会提示如下错误：
      • [USE_ERROR]参数cli-access-key,cli-secret-key必须同时输入
      • [USE_ERROR]使用AK/SK模式访问全局服务,缺少必填参数cli-domain-id.请添加该参数,或使用`cloud configure set`配置cli-domain-id
    • 命令中传入了AK/SK的情况下，若同时指定调用时使用的cli-profile，优先使用命令中的AK/SK作为认证参数。
  • 临时安全凭证（临时AK/SK和SecurityToken）方式
    • 使用临时AK/SK和SecurityToken通过Cloud CLI调用云服务API，与使用永久AK/SK类似。当命令中传入Access Key ID（cli-access-key），Secret Access Key（cli-secret-key）的同时，也传入了Security Token（cli-security-token）时，即认为该AK，SK为临时AK/SK。
    • 若访问的是全局服务，则在调用过程中还需IAM用户所属账号ID（cli-domain-id）用于鉴权。若未在命令中传入该值，Cloud CLI会根据用户认证信息自动获取；但若缺少cli-access-key或cli-secret-key参数，或自动获取cli-domain-id失败，会提示如下错误：
      • [USE_ERROR]参数cli-access-key,cli-secret-key必须同时输入
      • [USE_ERROR]使用AK/SK模式访问全局服务,缺少必填参数cli-domain-id.请添加该参数,或使用`cloud configure set`配置cli-domain-id
    • 命令中传入了临时AK/SK和SecurityToken的情况下，若同时指定调用时使用的cli-profile，优先使用命令中的AK/SK和SecurityToken作为认证参数。

• 无配置方式Account
  • 使用用户名密码通过Cloud CLI调用云服务API时，必须同时在命令中传入IAM用户名（cli-username）、IAM用户密码（cli-password）、IAM用户所属账号名（cli-domain）用于认证，缺一不可。否则会提示如下错误：

    [USE_ERROR]参数cli-username,cli-password,cli-domain必须同时输入

  • 命令中传入了用户名密码的情况下，若同时指定调用时使用的cli-profile，优先使用命令中的用户名密码作为认证参数。
• 无配置方式Token
  • 使用Token通过Cloud CLI调用云服务API时，若在命令提示符工具（如cmd.exe）执行命令，可能会因“cli-x-auth-token”值长度过长导致命令内容粘贴不完整，执行前请确认命令完整性。
  • 命令中传入了cli-x-auth-token的情况下，若同时指定调用时使用的cli-profile，优先使用命令中的cli-x-auth-token作为认证参数。
• 无配置方式ecsAgency
  • 此认证方式仅支持在弹性云服务器中使用Cloud CLI的场景。
  • 用户必须已在IAM对该弹性云服务器进行云服务委托授权，并在相应的弹性云服务器的详情页面“管理信息 > 委托”栏目中添加向弹性云（ECS）服务器的委托。详细操作请参考IAM。

无配置方式使用Cloud CLI时，除上述各注意事项之外，AKSK，Account，Token方式相关的参数不能在同一命令中混用，否则会提示如下错误：

[USE_ERROR]无配置方式调用API时不支持多方式混用:命令中同时存在[AKSK|Account|Token]相关的参数

在如上错误信息中，AKSK指命令中传入了cli-access-key，cli-secret-key，cli-security-token；Account指命令中传入了cli-username，cli-password，cli-domain；Token指命令中传入了cli-x-auth-token。