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

账户设置

Amazon ECS 提供了以下账户设置,这些设置可让您选择使用或退出特定功能。

Amazon 资源名称 (ARN) 和 IDS

资源名称:serviceLongArnFormattaskLongArnFormatcontainerInstanceLongArnFormat

Amazon ECS 正在引入针对 Amazon ECS 服务、任务和容器实例的 Amazon 资源名称 (ARN) 和资源 ID 的新格式。您必须为每种资源类型选择使用新格式,以对该资源类型使用资源标记等功能。有关更多信息,请参阅 Amazon 资源名称 (ARN) 和 ID

AWSVPC 中继

资源名称:awsvpcTrunking

Amazon ECS 支持使用受支持的 Amazon EC2 实例类型来启动具有提高的弹性网络接口 (ENI) 密度的容器实例。当您使用这些实例类型并选择使用 awsvpcTrunking 账户设置时,其他 ENI 将在新启动的容器实例上可用。此配置允许您使用 awsvpc 网络模式在每个容器实例上放置更多任务。通过使用此功能,启用了 awsvpcTrunkingc5.large 实例的 ENI 限制提高了 10。容器实例将具有一个主网络接口,而 Amazon ECS 将创建一个“中继”网络接口并将此接口附加到容器实例。主网络接口或中继网络接口都不会计入 ENI 限制,因此,此配置允许您在容器实例上启动 10 个任务,而不是当前的两个任务。有关更多信息,请参阅弹性网络接口中继

CloudWatch Container Insights

资源名称:containerInsights

CloudWatch Container Insights 从容器化应用程序和微服务中收集、聚合和汇总指标与日志。指标包括资源的使用率,如 CPU、内存、磁盘和网络。Container Insights 还提供诊断信息(如容器重新启动失败),以帮助您查明问题并快速解决问题。您还可以设置 Container Insights 收集的指标的 CloudWatch 警报。有关更多信息,请参阅Amazon ECS CloudWatch Container Insights

选择使用 containerInsights 账户设置后,在选择使用后创建的所有新集群都将启用 Container Insights,除非您在集群创建期间禁用了该功能。可以在创建期间或使用 UpdateClusterSettings API 启用或禁用单个集群。

对于包含使用 EC2 启动类型的的任务或服务的集群,您的容器实例必须运行版本 1.29.0 或更高版本的 Amazon ECS 代理,才可使用 Container Insights。有关更多信息,请参阅 Amazon ECS 容器代理版本

对于每个区域,您可以在账户级别或为特定的 IAM 用户或角色选择使用或选择不使用每个账户设置。可供选择使用或选择不使用的账户设置包括新的 ARN 和资源 ID 格式以及 awsvpc 中继功能。

下面是支持的方案:

  • IAM 用户或角色可以选择使用或选择不使用其个人用户账户。

  • IAM 用户或角色可以为账户上的所有用户设置默认的选择使用或选择不使用设置。

  • 根用户能够选择使用或选择不使用账户上的任何特定 IAM 角色或用户。如果根用户的账户设置发生更改,则会为未选择单独账户设置的所有 IAM 用户和角色设置默认值。

必须为每个账户设置单独选定选择使用和选择不使用选项。资源的 ARN 和资源 ID 格式由创建了资源的 IAM 用户或角色的选择状态定义。

仅在选择使用后启动的资源才能采用新的 ARN 和资源 ID 格式或增加的 ENI 限制。所有现有资源均不受影响。要使 Amazon ECS 服务和任务转换为新 ARN 和资源 ID 格式,必须重新创建该服务或任务。要将容器实例转换为新 ARN 和资源 ID 格式或增加的 ENI 限制,必须耗尽该容器实例,然后向集群注册一个新的容器实例。

注意

对于 Amazon ECS 服务启动的任务,仅在该服务是在 2018 年 11 月 16 日或之后创建的,并且创建该服务的 IAM 用户为任务选择使用新格式时,才能采用新 ARN 和资源 ID 格式。

Amazon 资源名称 (ARN) 和 ID

在创建 Amazon ECS 资源时,将为每个资源分配一个唯一的 Amazon 资源名称 (ARN) 和资源标识符 (ID)。如果您正在通过命令行工具或 Amazon ECS API 使用 Amazon ECS,则某些命令需要资源 ARN 或 ID。例如,如果您正在使用 stop-task AWS CLI 命令来停止任务,则必须在该命令中指定任务 ARN 或 ID。

按区域提供选择使用和选择不使用新 Amazon 资源名称 (ARN) 和资源 ID 的功能。创建的任何新账户将默认选择不使用。

您可以随时选择使用或选择不使用新的 Amazon 资源名称 (ARN) 和资源 ID 格式。在选择使用后,您创建的任何新资源都将使用新格式。

注意

资源 ID 在创建后不会更改。因此,选择使用或选择不使用新格式不会影响现有的资源 ID。

以下各部分介绍 ARN 和资源 ID 格式如何变化。有关转换为新格式的更多信息,请参阅 Amazon Elastic Container Service 常见问题

Amazon 资源名称 (ARN) 格式

一些资源具有容易记住的名称,例如名为 production 的服务。在其他情况下,您必须使用 Amazon 资源名称 (ARN) 格式指定资源。Amazon ECS 任务、服务和容器实例的新 ARN 格式包括集群名称。有关选择使用新 ARN 格式的详细信息,请参阅 修改账户设置

注意

新 ARN 格式在 GovCloud(美国东部)区域中不可用。

下表显示了每个资源类型的当前(旧)格式和新格式。

资源类型

ARN

容器实例

旧:arn:aws:ecs:region:aws_account_id:container-instance/container-instance-id

新:arn:aws:ecs:region:aws_account_id:container-instance/cluster-name/container-instance-id

Amazon ECS 服务

旧:arn:aws:ecs:region:aws_account_id:service/service-name

新:arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name

Amazon ECS 任务

旧:arn:aws:ecs:region:aws_account_id:task/task-id

新:arn:aws:ecs:region:aws_account_id:task/cluster-name/task-id

资源 ID 长度

资源 ID 采用字母和数字的唯一组合形式。新资源 ID 格式包括 Amazon ECS 任务和容器实例的更短 ID。旧资源 ID 格式的长度为 36 个字符。新 ID 采用 32 个字符的格式,不包含任何连字符。有关选择使用新资源 ID 格式的详细信息,请参阅 修改账户设置

注意

新资源 ID 格式在 GovCloud(美国东部)区域中不可用。