
# 设置配置项中的系统参数
设置配置项中的系统参数的示例如下：
- 增加配置项 新增配置项时，以"--cli-profile"声明配置项的名称，示例如下：
  - 新增认证模式为AK/SK的配置项，其中认证参数为访问密钥，即永久AK（cli-access-key）和SK（cli-secret-key）：
    ```
    hcloud configure set --cli-profile=testAKSK --cli-mode=AKSK --cli-region=cn-north-4 --cli-access-key=******** --cli-secret-key=******** --cli-project-id=068119468****************af89d2e --cli-domain-id=094518e46****************cfbc4c0 --cli-read-timeout=10 --cli-connect-timeout=5
    ```
    
  
  - 新增认证模式为AK/SK的配置项，其中认证参数为临时安全凭证，即临时AK（cli-access-key），SK（cli-secret-key）和SecurityToken（cli-security-token）：
    ```
    hcloud configure set --cli-profile=testAKSKST --cli-mode=AKSK --cli-region=cn-north-4 --cli-access-key=******** --cli-secret-key=******** --cli-security-token=******** --cli-project-id=068119468****************af89d2e --cli-domain-id=094518e46****************cfbc4c0 --cli-read-timeout=10 --cli-connect-timeout=5
    ```
    当配置项的认证模式为AK/SK时，若该配置项中同时配置了cli-security-token参数值，则默认其中cli-access-key和cli-secret-key为临时AK/SK，否则为永久AK/SK。
    
  
  - 新增认证模式为ecsAgency的配置项，无需添加认证参数：
    ```
    hcloud configure set --cli-profile=testEcsAgency --cli-mode=ecsAgency --cli-region=cn-north-4 --cli-read-timeout=10 --cli-connect-timeout=5
    ```
    当在被委托的ECS服务器中使用KooCLI调用云服务API时，会根据ECS委托自动获取临时认证信息。
    
  
  - 新增认证模式为AssumeRole的配置项，其中认证参数为委托方的账号名（cli-agency-domain-name）或账号ID（cli-agency-domain-id），委托名称（cli-agency-name），保存被委托方认证信息的配置项（cli-source-profile）：
    1. 先新增保存被委托方认证信息的配置项（非必须，可使用已添加的配置项），其认证模式应为AKSK：
       ```
       hcloud configure set --cli-profile=testAKSK --cli-mode=AKSK --cli-region=cn-north-4 --cli-access-key=******** --cli-secret-key=********
       ```
       
    
    2. 新增认证模式为AssumeRole的配置项。其中，将上一步的配置项作为cli-source-profile：
       ```
       hcloud configure set --cli-profile=testAssumeRole --cli-mode=AssumeRole --cli-region=cn-north-4 --cli-agency-domain-id=13534326******************5cf67b --cli-agency-name=****** --cli-source-profile=testAKSK --cli-read-timeout=10 --cli-connect-timeout=5
       ```
       
    
    
    新增认证模式为AssumeRole的配置项时，cli-agency-domain-id（或cli-agency-domain-name）与cli-agency-name必须同时配置；cli-profile不能与命令中的cli-source-profile取值相同；cli-source-profile指定的配置项必须已存在。
    
  
  - 新增认证模式为SSO的配置项，其中认证参数为用户门户URL（cli-sso-start-url），开通IAM身份中心实例所在的区域（cli-sso-region），账号名（cli-sso-account-name），权限集名称（cli-sso-permission-set-name），其中参数cli-sso-account-name与cli-sso-permission-set-name非必填：
    1. 先新增认证模式为SSO的配置项：
       ```
       hcloud configure set --cli-profile=testSSO --cli-mode=SSO --cli-region=cn-north-4 --cli-sso-start-url=https://idcenter.huaweicloud.com/d-3********6/portal --cli-sso-region=cn-north-4 --cli-sso-account-name=ACCOUNT_01 --cli-sso-permission-set-name=PERMISSION_01
       ```
       
    
    2. 进行SSO登录，若第一步中未配置cli-sso-account-name与cli-sso-permission-set-name参数，登录过程中需按照提示选择账号名与权限集名称：
       ```
       hcloud configure sso --cli-profile=testSSO
       ```
       
     
   
- 切换[默认配置项](https://support.huaweicloud.com/productdesc-hcli/hcli_01_002.html)
  用户已配置多个配置项时，可执行如下命令切换默认配置项：
  ```
  hcloud configure set --cli-profile=test
  ```
  
- 切换语言
  语言切换后，将作用于所有配置项。切换语言的命令为：
  ```
  hcloud configure set --cli-lang=en
  ```
  
- 切换本地数据的加密算法
  用户添加配置项后，以此算法在本地加密保存取值的认证信息及custom参数。加密算法切换后，将作用于所有配置项。切换加密算法的命令为：
  ```
  hcloud configure set --cli-local-dea=gm
  ```
  
- 切换在线/离线模式 在线/离线模式切换后，将作用于所有配置项。切换为离线模式的命令为：
  ```
  hcloud configure set --cli-offline=true
  ```
  
- 修改是否提示Warning信息 是否提示Warning信息修改后，将作用于所有配置项。以自动化脚本执行命令时，关闭Warning提示信息，可以避免干扰解析命令执行的输出结果。关闭Warning信息的命令为：
  ```
  hcloud configure set --cli-warning=false
  ```
  
- 修改是否同意隐私声明 是否同意隐私声明修改后，将作用于所有配置项。首次使用KooCLI时，KooCLI会通过交互，提示用户阅读并同意隐私声明。对于不方便交互的场景，如以自动化脚本执行命令，可通过如下命令配置同意隐私声明：
  ```
  hcloud configure set --cli-agree-privacy-statement=true
  ```
  
- 修改是否加密存储配置文件中的认证信息 是否加密存储配置文件中的认证信息修改后，将作用于所有配置项。可通过如下命令配置不加密存储配置文件中的认证信息：
  ```
  hcloud configure set --cli-auth-encrypt=false
  ```
  
- 修改指定配置项的认证模式
  同一配置项可同时配置多种认证模式相关的参数。通过如下命令可指定该配置项的认证模式：
  ```
  hcloud configure set --cli-profile=test --cli-mode=AKSK
  ```
  
- 修改指定配置项的区域
  ```
  hcloud configure set --cli-profile=test --cli-region=cn-north-4
  ```
  
- 修改指定配置项的[AK/SK](https://support.huaweicloud.com/usermanual-hcli/hcli_09_001.html)
  AK和SK必须一起修改：
  ```
  hcloud configure set --cli-profile=test --cli-access-key=******** --cli-secret-key=********
  ```
  
- 修改指定配置项的项目ID 部分云服务的API需要指定项目ID，用户可先[获取项目ID](https://support.huaweicloud.com/usermanual-hcli/hcli_09_002.html)，再将常用的项目ID添加到配置项中：
  ```
  hcloud configure set --cli-profile=test --cli-project-id=068119468****************af89d2e
  ```
  

- 修改指定配置项的请求连接超时时间
  ```
  hcloud configure set --cli-profile=test --cli-connect-timeout=5
  ```
  
- 修改指定配置项的I/O超时时间
  ```
  hcloud configure set --cli-profile=test --cli-read-timeout=10
  ```
  
- 修改指定配置项的请求连接重试次数
  ```
  hcloud configure set --cli-profile=test --cli-retry-count=3
  ```
  ![](https://support.huaweicloud.com/usermanual-hcli/public_sys-resources/caution_3.0-zh-cn.png)
  需要注意的是，因为使用"--cli-retry-count"设置重试次数可能会导致调用接口幂等性的问题，有重复调用的风险。对于创建类的接口，请您谨慎使用。
  

- 修改指定配置项的跳过https请求证书验证选项的值
  ```
  hcloud configure set --cli-profile=test --cli-skip-secure-verify=true
  ```
  
![](https://support.huaweicloud.com/usermanual-hcli/public_sys-resources/note_3.0-zh-cn.png)
注：配置项可以一次修改多个参数，例如同时修改[cli-project-id](https://support.huaweicloud.com/usermanual-hcli/hcli_09_002.html)和[cli-region](https://support.huaweicloud.com/usermanual-hcli/hcli_09_003.html)，命令如下：
hcloud configure set --cli-profile=test --cli-project-id=0681194\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*f89d2e --cli-region=cn-north-4
