登录控制台
Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档 » Amazon ECS » 开发人员指南 » 使用 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。

重要

所介绍的某些功能仅可用于最新版本的 Amazon ECS CLI。有关获取最新版本的更多信息，请参阅 安装 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

显示指定命令的帮助文本。

必需：否

示例

示例 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.