Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

ecs-cli configure profile

描述

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

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

  • 您可以设置 AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYAWS_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]

选项

名称 描述

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

本页内容: