登录控制台
Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档 » Amazon EC2 Container Service » 开发人员指南 » 使用 Amazon ECS 命令行界面 » Amazon ECS 命令行参考 » ecs-cli configure » ecs-cli configure profile
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

ecs-cli configure profile

在指定的 Amazon ECS 配置文件（存储在 ~/.ecs/credentials 文件中）中配置您的 AWS 凭证。如果创建多个配置文件，则可使用 ecs-cli configure profile default 命令更改默认情况下使用的配置文件。有关更多信息，请参阅ecs-cli configure profile default。

重要

Some features described may only be available with the latest version of the Amazon ECS CLI. For more information about obtaining the latest version, see 安装 Amazon ECS CLI.

您可以通过多种方式配置 AWS 凭证：

  • 您可以设置 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 和 AWS_SESSION_TOKEN 环境变量。当您运行 ecs-cli configure profile 时，这些变量的值将存储在 Amazon ECS CLI 配置文件中。

  • 您可以使用 --access-key、--secret-key 和 --session-token 选项直接在命令行上传递凭证。

  • 您可以使用 --profile-name 标记提供新的配置文件名称。如果未提供配置文件名称，则配置文件名为 default。

  • 配置的第一个配置文件将设置为默认配置文件。除非使用 --ecs-profile 标记，否则 Amazon ECS CLI 将使用此配置文件中指定的凭证。

使用多个配置文件

使用多个配置文件时应注意以下事项：

  • 可以配置多个配置文件，但始终有一个配置文件为默认配置文件。在运行需要凭证的 Amazon ECS CLI 命令时使用此配置文件。

  • 创建的第一个配置文件将设置为默认配置文件。

  • 要更改默认配置文件，请使用 ecs-cli configure profile default 命令。有关更多信息，请参阅ecs-cli configure profile default。

  • 可使用 --ecs-profile 标记在命令中引用非默认配置文件。

语法

ecs-cli configure profile --profile-name profile_name --access-key aws_access_key_id --secret-key aws_secret_access_key [--session-token token] [--help]

选项

名称 说明

--profile-name profile_name

指定此 ECS 配置文件的名称。这是可使用 --ecs-profile 标记在命令中引用的名称。如果忽略此选项，此名称将设置为 default。

类型：字符串

必需：是

--access-key aws_access_key_id

指定要使用的 AWS 访问密钥。如果在运行 ecs-cli configure profile 时设置 AWS_ACCESS_KEY_ID 环境变量，则 AWS 访问密钥 ID 将设置为该环境变量的值。

类型：字符串

必需：是

--secret-key aws_secret_access_key

指定要使用的 AWS 私有密钥。如果在运行 ecs-cli configure profile 时设置 AWS_SECRET_ACCESS_KEY 环境变量，则 AWS 秘密访问密钥将设置为该环境变量的值。

类型：字符串

必需：是
--session-token token

指定要使用的 AWS 会话令牌。如果在运行 ecs-cli configure profile 时设置 AWS_SESSION_TOKEN 环境变量，则 AWS 会话令牌将设置为该环境变量的值。有关使用会话令牌进行临时访问的更多信息，请参阅请求临时安全凭证。

类型：字符串

必需：否

--help, -h

Shows the help text for the specified command.

Required: No

示例

示例 1

此示例将 Amazon ECS CLI 配置为创建和使用名为 default 的配置文件与一组访问密钥。 

ecs-cli configure profile --profile-name default --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY

输出:

INFO[0000] Saved ECS CLI profile configuration default.

示例 2

此示例将 Amazon ECS CLI 配置为创建和使用名为 default 的配置文件以及一组访问密钥和一个 AWS 会话令牌。 

ecs-cli configure profile --profile-name default --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY --session-token $AWS_SESSION_TOKEN

输出:

INFO[0000] Saved ECS CLI profile configuration default.