任务定义参数

类型：字符串

必需：是

当您注册任务定义时，将为其提供一个系列，与任务定义的多个版本的名称类似，它是使用修订号指定的。注册到某个特定系列的第一个任务定义将获得修订 1，而随后注册的任何任务定义将获得后续修订号。

类型：字符串

必需：否

当您注册任务定义时，可以为 IAM 角色提供任务角色，该角色允许任务中的容器代表您调用在其关联策略APIs中指定的 AWS。有关更多信息，请参阅任务的 IAM 角色.

Windows 上任务的 IAM 角色需要在您启动 -EnableTaskIAMRole 时设置 Amazon ECS-optimized Windows Server AMI. 选项。此外，您的容器必须运行一些配置代码才能利用此功能。有关更多信息，请参阅任务的 Windows IAM 角色.

类型：字符串

必需：否

任务执行角色的 Amazon Resource Name (ARN)，该角色授予 Amazon ECS 容器代理代表您进行 AWS API 调用的权限。任务执行 IAM 角色是必需的，具体取决于任务的要求。有关更多信息，请参阅Amazon ECS 任务执行 IAM 角色.

类型：字符串

必需：否

在任务中用于容器的 Docker 联网模式。对于在 Amazon ECS 实例上托管Amazon EC2的任务，有效值为 none、bridge、 awsvpc和 host。 如果未指定网络模式，则默认网络模式为 bridge。

如果网络模式设置为 none，则任务的容器没有外部连接性，且无法在容器定义中指定端口映射。

如果网络模式为 bridge，该任务利用在每个容器实例内运行的 Docker 的内置虚拟网络。

如果网络模式为 host，则任务将绕过 Docker 的内置虚拟网络并将容器端口直接映射到Amazon EC2实例的网络接口。在此模式下，当使用端口映射时，无法在单个容器实例上运行同一任务的多个实例化。

如果网络模式为 awsvpc，则将为任务分配弹性网络接口，且在创建服务或运行具有任务定义的任务时必须指定 NetworkConfiguration 有关更多信息，请参阅Amazon ECS 任务联网. 目前，只有Amazon ECS-optimized AMI、包含 ecs-init 程序包的其他 Amazon Linux 变体或 AWS Fargate 基础设施才支持 awsvpc 网络模式。

host 和 awsvpc 网络模式为容器提供最高的联网性能，因为它们使用 Amazon EC2 网络堆栈，而不是 bridge 模式提供的虚拟化网络堆栈。使用 host 和 awsvpc 网络模式，公开的容器端口将直接映射到相应的主机端口（用于 host 网络模式）或附加的弹性网络接口端口（用于 awsvpc 网络模式），因此您无法利用动态主机端口映射。

Docker for Windows 使用的网络模式（也称为 NAT）不同于 Docker for Linux。在将任务定义注册到 Windows 容器时，您不得指定网络模式。如果使用 AWS 管理控制台将任务定义注册到 Windows 容器，必须选择 default 网络模式。

如果使用 Fargate 启动类型，则需要 awsvpc 网络模式。如果使用 EC2 启动类型，则允许的网络模式取决于底层 EC2 实例的操作系统。对于 Linux，可以使用任何网络模式。对于 Windows，仅允许上面所述的 NAT 模式。

类型：字符串

必需：是

容器的名称。 最多能包含 255 个字母 (大写和小写字母)、数字、连字符和下划线。如果您正在任务定义中将多个容器链接在一起，则可在一个容器的 name 中输入另一个容器的 links 以连接容器。

类型：字符串

必需：是

用于启动容器的映像。此字符串将直接传递给 Docker 守护程序。默认情况下，Docker Hub 注册表中的映像可用。您还可以使用 repository-url/image:tag 或 指定其他存储库repository-url/image@digest。 允许最多 255 个字母 (大写和小写字母)、数字、连字符、下划线、冒号、句点、正斜杠和井号。 此参数将映射到 的 Image 部分创建容器中的 Docker Remote APIIMAGE docker run和 的 参数。

类型：整数

必需：否

要提供给容器MiB的内存量 （以 为单位）。如果您的容器尝试使用超出此处指定的内存，该容器将被终止。为任务中的所有容器预留的内存总量必须低于任务 memory 值（如果指定了一个）。此参数将映射到 的 Memory 部分创建容器中的 Docker Remote API 和 的 --memory docker run 选项。

如果使用的是 Fargate 启动类型，则此参数是可选参数。

如果使用的是 EC2 启动类型，则必须指定任务级内存值或容器级内存值。如果同时指定容器级 memory 和 memoryReservation 值memory，则 必须大于 memoryReservation。 如果指定 memoryReservation，则将从容器所在的容器实例的可用内存资源中减去该值。否则，将使用 memory 的值。

Docker 守护程序为容器预留至少 4 MiB 个内存，因此，您不应为容器指定小于 4 MiB 个内存。

类型：整数

必需：否

要为容器预留MiB的内存的软限制（在 中）。当系统内存处于争用状态时，Docker 会尝试将容器内存保持在此软限制内；不过，您的容器可以在需要时使用更多内存，最大量可达 memory 参数指定的硬限制（如果适用），或容器实例上的所有可用内存（以先达到者为准）。此参数将映射到 的 MemoryReservation 部分创建容器中的 Docker Remote API 和 的 --memory-reservation docker run 选项。

如果未指定任务级内存值，则必须为容器定义中的一个或两个 memory 或 memoryReservation 指定非零整数。如果同时指定两者memory，则 必须大于 memoryReservation。 如果指定 memoryReservation，则将从容器所在的容器实例的可用内存资源中减去该值。否则，将使用 memory 的值。

例如，如果您MiB的容器通常使用 128 个内存，但有时会在短时间内突增到 256 个MiB内存，则可以将 设置为 memoryReservation 128 个 MiB，将memory硬限制设置为 300 个 MiB。 此配置将允许容器仅MiB从容器实例上的其余资源预留 128 内存，但还允许容器在需要时使用更多内存资源。

Docker 守护程序为容器预留至少 4 MiB 个内存，因此，您不应为容器指定小于 4 MiB 个内存。

类型：对象数组

必需：否

端口映射可让容器访问主机容器实例上的端口以发送或接收流量。

对于使用 awsvpc 网络模式的任务定义，您应仅指定 containerPort。 hostPort 可以留空或值必须与 相同containerPort。

Windows 上的端口映射使用NetNAT网关地址而不是 localhost。 Windows 上的端口映射没有回环，因此您无法从主机本身访问容器的映射端口。

此参数将映射到 的 PortBindings 部分创建容器中的 Docker Remote API 和 的 --publish docker run 选项。 如果任务定义的网络模式设置为 host，则主机端口必须是未定义的，或者必须与端口映射中的容器端口匹配。

如果您指定的是主机端口，请使用以下语法：

"portMappings": [
    {
        "containerPort": integer,
        "hostPort": integer
    }
    ...
]

如果您需要自动分配的主机端口，请使用以下语法：

"portMappings": [
    {
        "containerPort": integer
    }
    ...
]

容器的运行状况检查命令和关联的配置参数。此参数映射到 HealthCheck 的 创建容器 部分中的 Docker Remote API，以及 HEALTHCHECKdocker run 的 . 参数。

您可以使用 DescribeTasks API 操作或在 控制台中查看任务详细信息时，查看单个容器和任务的运行状况。

下面介绍了容器的 healthStatus 可能值：

下面介绍了任务的 healthStatus 可能值。非基本容器的容器运行状况检查状态不会影响任务的运行状况。

如果任务是手动运行的，而不是作为服务的一部分运行，则该任务将继续其生命周期，而无论其运行状况如何。对于属于服务的任务，如果任务报告为运行状况不佳，则该任务将停止，服务计划程序将替换它。

以下是有关容器运行状况检查支持的注意事项：

类型：整数

必需：否

cpu 容器代理将为容器预留的 Amazon ECS 单元的数量。此参数将映射到 的 CpuShares 部分创建容器中的 Docker Remote API 和 的 --cpu-shares docker run 选项。

此字段对于使用 Fargate 启动类型的任务为可选，而且唯一的要求是任务内为所有容器保留的 CPU 总量低于任务级 cpu 值。

Linux 容器会按照与其分配的量相同的比例，与容器实例上的其他容器共享未分配的 CPU 单元。例如，如果您在单核实例类型上运行一个单容器任务，同时为该容器指定 512 个 CPU 单元，而且这是在容器实例上运行的唯一任务，则该容器可在任何给定间使用完整的 1024 个 CPU 单元份额。但是，如果您在该容器实例上启动了同一任务的另一个副本，则保证为每个任务提供最少 512 个 CPU 单元（如果需要），而且每个容器的 CPU 使用量会上浮到更高的值（如果另一容器未在使用它），但如果两个任务都始终处于完全活动状态，则它们将限于 512 个 CPU 单元。

在 Linux 容器实例上，容器实例上的 Docker 守护程序使用 CPU 值来计算正在运行的容器的相对 CPU 共享比例。有关更多信息，请参阅 Docker 文档中的 CPU 共享约束。Linux 内核允许的最小有效 CPU 共享值为 2。不过，CPU 参数不是必需的，您可以在容器定义中使用小于 2 的 CPU 值。对于小于 2 的 CPU 值（包括 null），此行为因您的 Amazon ECS 容器代理版本而异：

在 Windows 容器实例上，此 CPU 限制将作为绝对限制或配额强制实施。Windows 容器只能访问任务定义中定义的指定数量的 CPU。Null 或零 CPU 值作为 0 传递给 Docker，Windows 将其解释为一个 CPU 的 1%。

类型：ResourceRequirement对象

必需：否

GPUs 容器代理将为容器预留的物理 Amazon ECS 的数量。为任务中的所有容器GPUs预留的数量不应超过启动任务的容器实例GPUs上的可用数量。有关更多信息，请参阅在 GPUs 上使用 Amazon ECS.

类型：布尔值

必需：否

如果将容器的 essential 参数标记为 true，并且该容器出于任何原因发生故障或停止，则属于此任务的所有其他容器将停止。如果将容器的 essential 参数标记为 false，则容器发生故障不会影响任务中的剩余容器。如果省略此参数，则假定容器是主要容器。

所有任务都必须具有至少一个主要容器。如果您有一个由多个容器组成的应用程序，则应将用于相同目的的容器分成多个组件，然后将不同的组件分为多个任务定义。有关更多信息，请参阅应用程序架构.

"essential": true|false

类型：字符串数组

必需：否

传递给容器的入口点。此参数将映射到 的 Entrypoint 部分创建容器中的 Docker Remote API 和 的 --entrypoint docker run 选项。 有关 Docker ENTRYPOINT 参数的更多信息，请转到 https://docs.docker.com/engine/reference/builder/#entrypoint。

"entryPoint": ["string", ...]

类型：字符串数组

必需：否

传递给容器的命令。此参数将映射到 的 Cmd 部分创建容器中的 Docker Remote API 和 COMMAND 参数。 docker run 有关 Docker CMD 参数的更多信息，请转到 https://docs.docker.com/engine/reference/builder/#cmd。如果有多个参数，则每个参数应该是数组中的分隔字符串。

"command": ["string", ...]

类型：字符串

必需：否

容器中用于运行命令的工作目录。此参数将映射到 的 WorkingDir 部分创建容器中的 Docker Remote API 和 的 --workdir docker run 选项。

"workingDirectory": "string"

类型：对象数组

必需：否

包含要传递到容器的环境变量的文件列表。此参数可将 --env-file 选项映射到 docker run.

您最多可以指定十个环境文件。文件必须具有 .env 文件扩展名。环境文件中的每一行都应包含 VARIABLE=VALUE 格式的环境变量。以开头的行 # 被视为注释并会被忽略。有关环境变量文件语法的更多信息，请参阅在文件中声明默认环境变量.

如果在容器定义中指定了单个环境变量，则这些变量的优先级高于环境文件中包含的变量。如果指定了多个包含相同变量的环境文件，则会按从上到下的顺序处理这些文件。建议使用唯一的变量名称。有关更多信息，请参阅指定环境变量.

此字段对使用 Fargate 启动类型的任务中的容器无效。

类型：对象数组

必需：否

要传递给容器的环境变量。此参数将映射到 的 Env 部分创建容器中的 Docker Remote API 和 的 --env docker run 选项。

"environment" : [
    { "name" : "string", "value" : "string" },
    { "name" : "string", "value" : "string" }
]

类型：对象数组

必需：否

一个表示用于对您的容器开放的密钥的对象。有关更多信息，请参阅指定敏感数据.

"secrets": [
    {
        "name": "environment_variable_name",
        "valueFrom": "arn:aws:ssm:region:aws_account_id:parameter/parameter_name"
    }
]

类型：布尔值

必需：否

当此参数设置为 true 时，容器内禁用联网。此参数将映射到 NetworkDisabled 的创建容器部分中的 Docker Remote API.

"disableNetworking": true|false

类型：字符串数组

必需：否

link 参数允许容器相互进行通信，而无需端口映射。仅当任务定义的网络模式设置为 时才支持bridge。 name:internalName 构造类似于 Docker 链接name:alias中的 。 最多能包含 255 个字母 (大写和小写字母)、数字、连字符和下划线。有关链接 Docker 容器的更多信息，请转到 https://docs.docker.com/engine/userguide/networking/default_network/dockerlinks/. 此参数将映射到 的 Links 部分创建容器中的 Docker Remote API 和 的 --link docker run 选项。

"links": ["name:internalName", ...]

类型：字符串

必需：否

要对您的容器使用的主机名。此参数将映射到 的 Hostname 部分创建容器中的 Docker Remote API 和 的 --hostname docker run 选项。

"hostname": "string"

类型：字符串数组

必需：否

提供给容器的 DNS 服务器的列表。此参数将映射到 的 Dns 部分创建容器中的 Docker Remote API 和 的 --dns docker run 选项。

"dnsServers": ["string", ...]

类型：字符串数组

必需：否

模式：^[a-zA-Z0-9-.]{0,253}[a-zA-Z0-9]$

提供给容器的 DNS 搜索域的列表。此参数将映射到 的 DnsSearch 部分创建容器中的 Docker Remote API 和 的 --dns-search docker run 选项。

"dnsSearchDomains": ["string", ...]

类型：对象数组

必需：否

要追加到容器上的 /etc/hosts 文件的主机名和 IP 地址映射的列表。

此参数将映射到 的 ExtraHosts 部分创建容器中的 Docker Remote API 和 的 --add-host docker run 选项。

"extraHosts": [
      {
        "hostname": "string",
        "ipAddress": "string"
      }
      ...
    ]

类型：布尔值

必需：否

当此参数为 true 时，将对此容器提供对其根文件系统的只读访问权。此参数将映射到 的 ReadonlyRootfs 部分创建容器中的 Docker Remote API 和 的 --read-only docker run 选项。

"readonlyRootFilesystem": true|false

Type: Object Array

Required: No

The mount points for data volumes in your container.

This parameter maps to Volumes in the 创建容器 section of the Docker Remote API and the --volume option to docker run.

Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers cannot mount directories on a different drive, and mount point cannot be across drives.

类型：对象数组

必需：否

要从其他容器挂载的数据卷。此参数将映射到 的 VolumesFrom 部分创建容器中的 Docker Remote API 和 的 --volumes-from docker run 选项。

"volumesFrom": [
                {
                  "sourceContainer": "string",
                  "readOnly": true|false
                }
              ]

类型：LogConfiguration对象

必需：否

容器的日志配置规范。

有关使用日志配置的示例任务定义，请参阅示例任务定义.

此参数将映射到 的 LogConfig 部分创建容器中的 Docker Remote API 和 的 --log-driver docker run 选项。 默认情况下，容器使用与 Docker 守护程序相同的日志记录驱动程序；但是，容器可以通过在容器定义中使用此参数指定日志驱动程序来使用不同于 Docker 守护程序的日志记录驱动程序。要对容器使用不同的日志记录驱动程序，必须在容器实例上正确配置日志系统（或者在不同的日志服务器上使用远程日志记录选项）。有关不同支持的日志驱动程序选项的更多信息，请参阅 Docker 文档中的配置日志记录驱动程序。

指定容器的日志配置时，应注意以下事项：

"logConfiguration": {
      "logDriver": "awslogs","fluentd","gelf","json-file","journald","logentries","splunk","syslog","awsfirelens",
      "options": {"string": "string"
        ...},
	"secretOptions": [{
		"name": "string",
		"valueFrom": "string"
	}]
}

类型：FirelensConfiguration对象

必需：否

容器FireLens的配置。这用于为容器日志指定和配置日志路由器。有关更多信息，请参阅自定义日志路由.

{
    "firelensConfiguration": {
        "type": "fluentd",
        "options": {
            "KeyName": ""
        }
    }
}

类型：布尔值

必需：否

当该参数为 true 时，将对此容器提供对主机容器实例的提升的特权（类似于 root 用户）。

此参数将映射到 的 Privileged 部分创建容器中的 Docker Remote API 和 的 --privileged docker run 选项。

"privileged": true|false

类型：字符串

必需：否

要在容器内使用的用户。此参数将映射到 的 User 部分创建容器中的 Docker Remote API 和 的 --user docker run 选项。

您可以使用以下格式指定 user 如果指定 UID 或 GID，您必须将其指定为一个正整数。

"user": "string"

类型：字符串数组

有效值："no-new-privileges" | "apparmor：PROFILE" | "label：value" | "credentialspec：CredentialSpecFilePath"

必需：否

为 SELinux 和AppArmor多级安全系统提供自定义标签的字符串列表。有关有效值的更多信息，请参阅 Docker 运行安全配置. 此字段对使用 Fargate 启动类型的任务中的容器无效。

对于 Windows 容器，此参数可用于在为 Active Directory 身份验证配置容器时引用凭证规范文件。有关更多信息，请参阅Windows容器使用gMSA.

此参数将映射到 的 SecurityOpt 部分创建容器中的 Docker Remote API 和 的 --security-opt docker 选项。

"dockerSecurityOptions": ["string", ...]

类型：对象数组

必需：否

要为容器定义的ulimit值的列表。此值将覆盖操作系统的默认资源限制设置。此参数将映射到 的 Ulimits 部分创建容器中的 Docker Remote API 和 的 --ulimit docker run 选项。

Fargate 上托管的 Amazon ECS 任务使用由操作系统设置的默认资源限制值，但 nofile 资源限制参数除外，Fargate 覆盖该参数。nofile 资源限制对容器可以使用的打开文件数量设置限制。默认的 nofile 软限制为 1024，硬限制为 4096。 有关更多信息，请参阅任务资源限制。

此参数要求您容器实例上的 Docker Remote API 版本为 1.18 或更高。

"ulimits": [
      {
        "name": "core"|"cpu"|"data"|"fsize"|"locks"|"memlock"|"msgqueue"|"nice"|"nofile"|"nproc"|"rss"|"rtprio"|"rttime"|"sigpending"|"stack",
        "softLimit": integer,
        "hardLimit": integer
      }
      ...
    ]

类型：字符串到字符串映射

必需：否

要添加到容器的标签的键值映射。此参数将映射到 的 Labels 部分创建容器中的 Docker Remote API 和 的 --label docker run 选项。

此参数要求您容器实例上的 Docker Remote API 版本为 1.18 或更高。

"dockerLabels": {"string": "string"
      ...}

类型：LinuxParameters对象

必需：否

应用于容器的特定于 Linux 的选项，例如 KernelCapabilities 。

"linuxParameters": {
      "capabilities": {
        "add": ["string", ...],
        "drop": ["string", ...]
        }
      }

类型：ContainerDependency对象数组

必需：否

针对容器启动和关闭定义的依赖项。一个容器可以包含多个依赖项。当针对容器启动定义依赖项时，对于容器关闭，将反转此项。有关示例，请参阅示例：容器从属性.

对于在 Amazon ECS 实例上托管Amazon EC2的任务，实例至少需要容器代理1.26.0的 版本才能启用容器依赖项。但是，我们建议使用最新的容器代理版本。有关检查您的代理版本并更新到最新版本的信息，请参阅更新 Amazon ECS 容器代理. 如果您使用的是 Amazon ECS-optimized Amazon Linux AMI，则您的实例至少需要 1.26.0-1 版本的 ecs-init 程序包。如果您的容器实例是从 版本 20190301 或更高版本启动的，则它们包含所需版本的容器代理和 ecs-init。 有关更多信息，请参阅Amazon ECS-optimized AMIs。

对于托管在 上的Amazon ECS任务Fargate，此参数要求任务或服务使用 平台版本 1.3.0 或更高版本。

"dependsOn": [
    {
        "containerName": "string",
        "condition": "string"
    }
]

类型：整数

必需：否

示例值：120

在放弃解析容器的依赖项之前要等待的持续时间（以秒为单位）。

例如，您在任务定义中指定两个容器，并且containerA其依赖项是containerB达到 COMPLETE、 SUCCESS或 HEALTHY 状态。如果为 指定了startTimeout值containerB，并且它在该时间内未达到所需的状态，则 containerA 将放弃且不开始。

对于在 上托管Amazon ECS的任务Fargate，此参数要求任务或服务使用 平台版本 1.3.0 或更高版本。使用平台版本 时1.4.0，如果未指定此参数，则使用默认值 60 秒。

类型：整数

必需：否

示例值：120

容器由于未自行正常退出而被强制终止前要等待的持续时间（以秒为单位）。

对于使用 Fargate 启动类型的任务，任务或服务需要使用 1.3.0 版或更高版本的平台。最大停止超时值为 120 秒，如果未指定此参数，则使用默认值 30 秒。

对于使用 EC2 启动类型的任务，如果未指定 stopTimeout 参数，则默认情况下使用为 Amazon ECS 容器代理配置变量 ECS_CONTAINER_STOP_TIMEOUT 设置的值。如果既没有设置 stopTimeout 参数，也没有设置 ECS_CONTAINER_STOP_TIMEOUT 代理配置变量，那么，对于 Linux 容器，使用默认值 30 秒；对于 Windows 容器，使用默认值 30 秒。容器实例需要至少 1.26.0 版的容器代理才能启用容器停止超时值。但是，我们建议使用最新的容器代理版本。有关检查您的代理版本并更新到最新版本的信息，请参阅更新 Amazon ECS 容器代理. 如果您使用 Amazon ECS-optimized Amazon Linux AMI，您的实例至少需要 1.26.0-1 版的 ecs-init 程序包。如果您的容器实例是从 版本 20190301 或更高版本启动的，则它们包含所需版本的容器代理和 ecs-init。 有关更多信息，请参阅Amazon ECS-optimized AMIs。

类型：SystemControl对象

必需：否

要在容器中设置的具有命名空间的内核参数的列表。此参数将映射到 的 Sysctls 部分创建容器中的 Docker Remote API 和 的 --sysctl docker run 选项。

不建议在使用了 systemControls 或 awsvpc 网络模式的单个任务中为多个容器指定与网络相关的 host 参数，原因如下：

如果您要设置 IPC 资源命名空间以用于任务中的容器，则以下内容将适用于您的系统控制。有关更多信息，请参阅IPC 模式.

"systemControls": [
    {
         "namespace":"string",
         "value":"string"
    }
]

类型：布尔值

必需：否

当此参数为 true 时，您可以部署需要分配 stdin 或 tty 的容器化的应用程序。此参数将映射到 的 OpenStdin 部分创建容器中的 Docker Remote API 和 的 --interactive docker run 选项。

类型：布尔值

必需：否

当此参数为 true 时，则分配 TTY。此参数将映射到 的 Tty 部分创建容器中的 Docker Remote API 和 的 --tty docker run 选项。

类型：字符串

必需：否

卷的名称。最多能包含 255 个字母 (大写和小写字母)、数字、连字符和下划线。此名称已在容器定义 mountPoints 对象的 sourceVolume 参数中引用。

必需：否

使用绑定装载时将指定此参数。要使用 Docker 卷，请改为指定 dockerVolumeConfiguration。host 参数的内容确定您的绑定装载数据卷是否一直保存在主机容器实例上以及存储它的位置上。如果 host 参数为空，则 Docker 守护程序将为您的数据卷分配一个主机路径，但不保证数据在与其关联的容器停止运行后将保留。

当使用 EC2 或 Fargate 启动类型时，支持绑定装载主机卷。

Windows 容器可在 $env:ProgramData 所在的驱动器上装载整个目录。

类型：对象

必需：否

使用 Docker 卷时将指定此参数。只有在 EC2 实例上运行任务时才支持 Docker 卷。Windows 容器仅支持使用 驱动程序。要使用绑定挂载，请改为指定 host。

类型：对象

必需：否

使用 Amazon EFS 卷时将指定此参数。

类型：对象

必需：是

当您使用 Amazon FSx for Windows File Server 文件系统进行任务存储时，指定此参数。

类型：字符串

必需：否

应用于约束的集群查询语言表达式。有关更多信息，请参阅集群查询语言.

类型：字符串

必需：是

约束类型。使用 memberOf 将选择限制为一组有效的候选。

类型：字符串数组

必需：否

有效值： EC2 | FARGATE

任务使用的启动类型。这将启用检查以确保任务定义中使用的所有参数均符合启动类型的要求。

有效值为 FARGATE 和 EC2。 有关启动类型的更多信息，请参阅Amazon ECS 启动类型。

类型：字符串

必需：有条件

要为任务提供的 CPU 单位的硬限制。它在任务定义1024中可表示为使用 CPU 单元（例如 ）的整数vCPUs或使用 的字符串1 vCPU（例如 1 vcpu 或 ）。注册任务定义时，vCPU 值将转换为指示 CPU 单元的整数。

对于在 Amazon EC2 实例上托管的任务，此字段是可选的。如果您的集群没有任何带可用的已请求 CPU 单位的已注册容器实例，则该任务将失败。支持的值介于 128 CPU 单元 （0.125 vCPUs） 和 10240 CPU 单元 （10 ） 之间vCPUs。

对于在 上托管的任务Fargate，此字段为必填字段，并且您必须使用以下值之一，这决定了 memory 参数支持的值的范围：

类型：字符串

必需：有条件

要MiB提供给任务的内存的硬限制（在 中）。它在任务定义中可表示为整数（使用 时MiB，例如 1024）或字符串（使用 GB 时1GB，例如 1 GB 或 ）。注册任务定义时，GB 值将转换为指示 的整数MiB。

对于托管在 <ph113/> 实例上的任务，此字段是可选的，并且可使用任何值。Amazon EC2如果指定了任务级内存值，则容器级内存值是可选的。如果您的集群没有任何带可用的已请求内存的已注册容器实例，则该任务将失败。如果您尝试通过为任务提供尽可能多的用于特定实例类型的内存来最大程度地利用资源，请参阅容器实例内存管理.

对于在 上托管的任务Fargate，此字段为必填字段，并且您必须使用以下值之一，这决定了 cpu 参数支持的值的范围：

类型：ProxyConfiguration对象

必需：否

App Mesh 代理的配置详细信息。

对于使用 EC2 启动类型的任务，容器实例需要至少 1.26.0 版的容器代理和至少 1.26.0-1 版的 ecs-init 程序包才能启用代理配置。如果您的容器实例是从Amazon ECS经 优化的 AMI 版本 20190301 或更高版本启动的，则它们包含所需版本的容器代理和 ecs-init。 有关更多信息，请参阅Amazon ECS-optimized AMIs。

对于使用 Fargate 启动类型的任务，此功能需要任务或服务使用平台版本 1.3.0 或更高版本。

"proxyConfiguration": {
    "type": "APPMESH",
    "containerName": "string",
    "properties": [
        {
           "name": "string",
           "value": "string"
        }
    ]
}

类型：字符串

必需：否

用于任务中的容器的 IPC 资源命名空间。有效值为 host、 task或 none。 如果指定host了 ，则在同一容器实例上指定host了 IPC 模式的任务中的所有容器将与主机Amazon EC2实例共享相同的 IPC 资源。如果指定了 task，则指定任务中的所有容器将共享相同的 IPC 资源。如果指定了 none，则任务的容器中的 IPC 资源是私有的，不与任务中或容器实例上的其他容器共享。如果未指定任何值，则 IPC 资源命名空间共享取决于容器实例上的 Docker 守护程序设置。有关更多信息，请参阅 Docker 运行参考 中的 IPC 设置.

如果使用了 host IPC 模式，请注意，发生非预期的 IPC 命名空间公开的风险会提高。有关更多信息，请参阅 Docker 安全性.

如果您使用 systemControls 为任务中的容器设置具有命名空间的内核参数，则以下内容将适用于您的 IPC 资源命名空间。有关更多信息，请参阅系统控制.

类型：字符串

必需：否

用于任务中的容器的过程命名空间。有效值为 host 或 task。 如果指定host了 ，则在同一容器实例上指定host了 PID 模式的任务中的所有容器将与主机Amazon EC2实例共享相同的进程命名空间。如果指定了 task，则指定任务中的所有容器将共享相同的过程命名空间。如果未指定任何值，则默认值为私有命名空间。有关更多信息，请参阅 Docker 运行参考 中的 PID 设置.

如果使用了 host PID 模式，请注意，发生非预期的过程命名空间公开的风险会提高。有关更多信息，请参阅 Docker 安全性.