文档首页/ 华为云命令行工具服务 KooCLI/ 常见问题/ 其他/ 无配置方式使用KooCLI需要注意什么?
更新时间:2024-04-19 GMT+08:00

无配置方式使用KooCLI需要注意什么?

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

无配置方式使用KooCLI时,需要注意如下事项:

  • 无配置方式AKSK
    • 访问密钥(永久AK/SK)方式
      • 使用永久AK/SK通过KooCLI调用云服务API时,必须同时在命令中传入Access Key ID(cli-access-key),Secret Access Key(cli-secret-key)用于鉴权,缺一不可。
      • 若访问的是全局服务,则在调用过程中还需IAM用户所属账号ID(cli-domain-id)用于鉴权。若未在命令中传入该值,KooCLI会根据用户认证信息自动获取;但若缺少cli-access-key或cli-secret-key参数,或自动获取cli-domain-id失败,会提示如下错误:
        • [USE_ERROR]参数cli-access-key,cli-secret-key必须同时输入
        • [USE_ERROR]使用AK/SK模式访问全局服务,缺少必填参数cli-domain-id.请添加该参数,或使用`hcloud configure set`配置cli-domain-id
      • 命令中传入了AK/SK的情况下,若同时指定调用时使用的cli-profile,优先使用命令中的AK/SK作为认证参数。
    • 临时安全凭证(临时AK/SK和SecurityToken)方式
      • 使用临时AK/SK和SecurityToken通过KooCLI调用云服务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)用于鉴权。若未在命令中传入该值,KooCLI会根据用户认证信息自动获取;但若缺少cli-access-key或cli-secret-key参数,或自动获取cli-domain-id失败,会提示如下错误:
        • [USE_ERROR]参数cli-access-key,cli-secret-key必须同时输入
        • [USE_ERROR]使用AK/SK模式访问全局服务,缺少必填参数cli-domain-id.请添加该参数,或使用`hcloud configure set`配置cli-domain-id
      • 命令中传入了临时AK/SK和SecurityToken的情况下,若同时指定调用时使用的cli-profile,优先使用命令中的AK/SK和SecurityToken作为认证参数。
  • 无配置方式ecsAgency
    • 此认证方式仅支持在弹性云服务器中使用KooCLI的场景。
    • 用户必须已在IAM对该弹性云服务器进行云服务委托授权,并在相应的弹性云服务器的详情页面“管理信息 > 委托”栏目中添加向弹性云(ECS)服务器的委托。详细操作请参考委托其他云服务管理资源