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 ECS CLI. To obtain 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]
选项
| 名称 | 描述 |
|---|---|
|
|
指定此 ECS 配置文件的名称。这是可使用 类型：字符串 必需：是 |
|
|
指定要使用的 AWS 访问密钥。如果在运行 ecs-cli configure profile 时设置 类型：字符串 必需：是 |
|
|
指定要使用的 AWS 私有密钥。如果在运行 ecs-cli configure profile 时设置 类型：字符串 必需：是 |
--session-token
|
指定要使用的 AWS 会话令牌。如果在运行 ecs-cli configure profile 时设置 类型：字符串 必需：否 |
|
|
显示指定命令的帮助文本。 必需：否 |
示例
示例 1
此示例将 Amazon ECS CLI 配置为创建和使用名为 default 的配置文件与一组访问密钥。
ecs-cli configure profile --profile-namedefault--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-namedefault--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.