更新时间:2024-08-20 GMT+08:00

概述

如果您需要同时在多个区域或多个项目下管理资源,或者同时使用多个账号,可以通过增加配置项的方式,存储多个不同场景的固定信息。已配置多个配置项的情况下,您可在命令中以“--cli-profile”指定要操作或使用的配置项的名称。

KooCLI配置项中可修改的参数如下表所示。

表1 配置项参数

参数名

说明

cli-profile

配置项名称。如果修改配置项时不指定此参数,则修改默认配置项。执行“hcloud configure show”命令可查看默认配置项的内容。

cli-mode

认证模式。取值范围:

  • AKSK:分为访问密钥和临时安全凭证。访问密钥即为永久AK/SK,临时安全凭证即为临时AK,SK和SecurityToken。
  • ecsAgency:当委托给ECS服务器时,在ECS服务器中使用KooCLI调用云服务API时自动获取临时认证信息。
  • SSO:开通IAM身份中心并完成配置后,允许用户使用特定用户名和密码登录统一的用户门户网站,访问为其分配的多个账号下的资源。认证信息有效期内,无需多次登录。

cli-region

区域。

cli-access-key

访问密钥ID(Access Key ID,简称AK),此参数必须和SK同步修改。

cli-secret-key

秘密访问密钥(Secret Access Key,简称SK),此参数必须和AK同步修改。

cli-security-token

临时安全凭证。在使用临时AK/SK认证身份时,需同时使用此参数。注意过期后需重新配置,否则调用云服务API时无法完成认证。

cli-lang

KooCLI的语言。取值范围:

  • cn(中文)
  • en(英文)

cli-offline

是否使用KooCLI的离线模式。取值范围:

  • true(默认值,表示使用离线模式)
  • false(表示使用在线模式)

cli-project-id

项目ID。

cli-domain-id

IAM用户所属账号ID,以AKSK模式调用全局服务的API时需要。

cli-custom

是否操作custom参数。取值范围:

  • true(表示要操作配置项中的custom参数)
  • false(默认值,表示要操作配置项中的系统参数)

cli-read-timeout

I/O超时时间(秒)。默认取值为10秒,参数最小取值为1秒。

cli-connect-timeout

请求连接超时时间(秒)。默认取值为5秒,参数最小取值为1秒。

cli-retry-count

请求连接重试次数。默认取值为0次,可配置的取值范围为0~5次。

cli-skip-secure-verify

是否跳过https请求证书验证(不建议)。取值范围:

  • true(表示要跳过https请求证书验证,出于安全考虑不建议
  • false(默认值,表示不跳过https请求证书验证)

cli-agree-privacy-statement

是否同意隐私。首次使用KooCLI时,KooCLI会通过交互,提示用户阅读并同意隐私声明。对于不方便交互的场景,如以自动化脚本执行命令,可通过此参数配置同意隐私声明。取值范围:

  • true(表示同意隐私声明)
  • false(默认值,表示不同意隐私声明)

cli-warning

是否提示命令执行过程中的Warning信息。以自动化脚本执行命令时,关闭Warning提示信息,可以避免干扰解析命令执行的输出结果。取值范围:

  • true(默认值,表示提示Warning信息)
  • false(表示不提示Warning信息)

cli-auth-encrypt

配置文件中的认证信息是否加密存储。取值范围:

  • true(默认值,表示加密存储配置文件中的认证信息)
  • false(表示不加密存储配置文件中的认证信息)

cli-sso-start-url

用户门户URL,开通IAM身份中心后生成。

cli-sso-region

开通IAM身份中心实例所在的区域。

cli-sso-account-name

账号名。

cli-sso-permission-set-name

权限集名称。

  • 参数“--cli-custom”的取值可标识向配置项中设置的参数类型:当“--cli-custom=false”时,设置其中的系统参数;当“--cli-custom=true”时,设置其中的custom(即用户自定义)参数。
  • 设置配置项中的系统参数时,若该配置项不存在则新增配置项,否则修改该配置项。
  • 不支持向不存在的配置项中设置custom参数;不支持在同一命令中同时设置系统参数和custom参数。
  • 向配置项中设置系统参数或custom参数,都会使该配置项成为默认配置项

新增或修改配置项的命令为:

hcloud configure set --param1=paramValue1 --param2=paramValue2 ...