配置接口调用凭证

本文介绍如何使用profile，配置火山引擎CLI工具调用接口的AK/SK、地域、网关地址等接口调用凭证信息。

操作步骤

1. 登录您的服务器。

2. 执行如下命令，新建配置（profile），预设调用接口的凭证信息。

   Windows操作系统请在命令提示符中执行命令；MacOS请在终端中执行命令。

   volcengine-cli configure set --profile [配置名] --region [地域] --endpoint open.volcengineapi.com --access-key [your ak] --secret-key [your sk]
   

   参数说明：

   您还可以使用volcengine-cli configure set -h命令，获取更多参数信息。

   参数名	是否必选	含义	示例
   profile	是	配置名称。若该参数指定的配置已存在，则该命令会修改已有配置；否则会按照命令中包含的参数新建配置。	ecsapi-config
   region	是	地域ID，可填写地域和可用区中的RegionID。	cn-beijing
   access-key	是	访问密钥ID(Access Key ID)，获取操作可查看Access Key（密钥）管理。	AKLTMDQwMmJmZjhiNmU2NGY0NzgyYTUzZmIxZDM********
   secret-key	是	与访问密钥 ID 相应的密钥（Secret Access Key），获取操作可查看Access Key（密钥）管理。	TkROaFpETTJNbVU0WW1GaE5HWTFOV0lUWTFZVFF3TlRj********
   endpoint	是	网关地址，调用ECS接口固定为open.volcengineapi.com。	open.volcengineapi.com
   session-token	否	角色扮演的安全令牌。参数值可通过AssumeRole接口获取。 说明 使用角色扮演调用接口时，需传入本参数。	STSeyJBY2NvdW50SW**klkZW50aXR5VHlwZSI6Rpd********
   disable-ssl	否	是否禁用SSL。取值： false（默认）：不禁用。 true：禁用。	false

configure命令其他操作

• 修改已有配置。
  可指定已有修改的配置名（profile），传入新的配置信息，完成修改。

  volcengine-cli configure set --profile [配置名] --region [地区] --access-key [用户的AK] --secret-key [用户的SK] --endpoint [地区对应的endpoint] --disable-ssl [是否禁用SSL]
  

• 查看指定配置信息。

  volcengine-cli configure get --profile [配置名]
  

• 查看所有配置详情。

  volcengine-cli configure list
  

• 切换当前使用的配置。
  指定新配置名，volcengine-cli将尝试切换为该配置。若配置不存在，将不会切换，且提示您”configuration profile [配置名] not found“。

  说明

  请确保volcengine-cli版本不低于1.0.16。

  volcengine-cli configure profile --profile [配置名]