Amazon ECS任務定義參數

類型：字串

必要：是

當您註冊任務定義時，您會指定它的系列，這類似於任務定義以修訂版號碼指定的多個版本名稱。在特定系列註冊的第一個任務定義會得到修訂版 1，之後註冊的任何任務定義，則得到連續的修訂版號碼。

類型：字串陣列

必要：否

有效值: EC2 | FARGATE | EXTERNAL

驗證任務定義所依據的啟動類型。這會啟動檢查，以確保任務定義中使用的所有參數都能滿足啟動類型的要求。

類型：字串

必要：否

當您註冊任務定義時，您可以為IAM角色提供任務角色，允許任務許可中的容器代表您呼叫其相關政策中APIs指定的 AWS 。如需詳細資訊，請參閱Amazon ECS任務IAM角色。

當您啟動 Amazon ECS最佳化 Windows Server 時AMI，Windows 上的任務IAM角色需要設定 -EnableTaskIAMRole選項。您的容器還必須執行一些組態程式碼，以使用此功能。如需詳細資訊，請參閱 Amazon EC2 Windows 執行個體額外組態。

類型：字串

必要：有條件

任務執行角色的 Amazon Resource Name （ARN），授予 Amazon ECS容器代理程式代表您撥打電話 AWS API的許可。

類型：字串

必要：否

任務中的容器所使用的 Docker 聯網模式。對於託管在 Amazon EC2 Linux 執行個體上的 Amazon ECS任務，有效值為 none、bridge、 awsvpc和 host。如果未指定網路模式，則預設網路模式為 bridge。對於託管在 Amazon EC2 Windows 執行個體上的 Amazon ECS任務，有效值為 default、 和 awsvpc。如果未指定網路模式，則會使用default網路模式。對於在 Fargate 上託管的 Amazon ECS任務，需要awsvpc網路模式。

如果網路模式設為 none，任務的容器即沒有外部連線，並且無法在容器定義中指定連接埠映射。

如果網路模式為 bridge，任務會使用 Docker 內建的虛擬網路在 Linux 上執行，該網路會在託管任務的每個 Amazon EC2執行個體內執行。Linux 上的內建虛擬網路會使用 bridge Docker 網路驅動程式。

如果網路模式為 host，任務會使用主機的網路，透過直接將容器連接埠映射到託管任務ENI的 Amazon EC2執行個體的 ，繞過 Docker 的內建虛擬網路。動態連接埠映射無法在此網路模式下使用。任務定義中使用此模式的容器必須指定特定 hostPort 數字。主機上的連接埠號碼無法由多個任務使用。因此，您無法在單一 Amazon EC2執行個體上執行相同任務定義的多個任務。

對於 Amazon EC2啟動類型，如果網路模式為 awsvpc，則任務會配置彈性網路介面，而且您必須在建立服務或執行任務定義的任務NetworkConfiguration時指定 。如需詳細資訊，請參閱EC2 啟動類型的 Amazon ECS任務聯網選項。

如果網路模式為 default，任務會使用 Docker 內建的虛擬網路在 Windows 上執行，該網路會在託管任務的每個 Amazon EC2執行個體內執行。Windows 上的內建虛擬網路會使用 nat Docker 網路驅動程式。

對於 Fargate 啟動類型，當網路模式為 時awsvpc，任務會配置彈性網路介面，而且您必須在建立服務或執行任務定義的任務NetworkConfiguration時指定 。如需詳細資訊，請參閱 Fargate Task Networking 。awsvpc 網路模式為容器提供最高的網路效能，因為它們使用 Amazon EC2 網路堆疊。公開的容器連接埠會直接映射至連接的彈性網路介面連接埠。因此，您無法使用動態主機連接埠對應。

host 和 awsvpc 網路模式為容器提供最高的網路效能，因為它們使用 Amazon EC2 網路堆疊。使用 host 和 awsvpc 網路模式，公開的容器連接埠會直接映射到對應的主機連接埠 (適用於 host 網路模式) 或已連接的彈性網路介面連接埠 (適用於 awsvpc 網路模式)。因此，您無法使用動態主機連接埠對應。

如果使用 Fargate 啟動類型，則需要 awsvpc 網路模式。如果使用EC2啟動類型，允許的網路模式取決於基礎EC2執行個體的作業系統。如果是 Linux，則可以使用任何網路模式。如果是 Windows，則會使用 default 和 awsvpc 模式。

類型：字串

必要：有條件

預設： LINUX

在 Fargate 上託管的 Amazon ECS任務需要此參數。

在註冊任務定義時，您會指定作業系統系列。

在 Fargate 上託管的 Amazon WINDOWS_SERVER_2019_FULLECS任務的有效值為 LINUX、WINDOWS_SERVER_2019_CORE、、 WINDOWS_SERVER_2022_FULL和 WINDOWS_SERVER_2022_CORE。

在 上託管的 Amazon ECS任務的有效值EC2為 LINUX、WINDOWS_SERVER_2022_CORE、WINDOWS_SERVER_2019_FULL、 WINDOWS_SERVER_2022_FULL和 WINDOWS_SERVER_2019_CORE、WINDOWS_SERVER_2016_FULL、 WINDOWS_SERVER_2004_CORE和 WINDOWS_SERVER_20H2_CORE。

服務中使用的所有任務定義都必須與此參數具有相同的值。

如果任務定義為服務的一部分，此值必須與服務 platformFamily 值相符。

類型：字串

必要：有條件

預設：X86_64

在 Fargate 上託管的 Amazon ECS任務需要此參數。如果參數保留為 null，則會在 Fargate 上託管的任務啟動時自動指派預設值。

當您註冊任務定義時，您可以指定 CPU 架構。有效值為 X86_64 和 ARM64。

服務中使用的所有任務定義都必須與此參數具有相同的值。

當您有 Fargate 啟動類型或EC2啟動類型的 Linux 任務時，您可以將 值設定為 ARM64。如需詳細資訊，請參閱適用於 64 位元ARM工作負載的 Amazon ECS任務定義。

類型：字串

必要：有條件

任務要呈現的CPU單位硬限制。您可以將JSON檔案中CPU的值指定為單位CPU或虛擬 CPUs（） 的字串vCPUs。例如，您可以指定單位或 1024CPU1 vCPU中的CPU值vCPUs。註冊任務定義時，vCPU 值會轉換為整數，表示CPU單位。

對於在 EC2或外部執行個體上執行的任務，此欄位為選用。如果您的叢集沒有任何已註冊的容器執行個體，且具有可用的請求CPU單位，則任務會失敗。在 EC2或外部執行個體上執行之任務的支援值介於 0.125 vCPUs 和 10 之間vCPUs。

對於在 Fargate 上 (Linux 和 Windows 容器皆可) 執行的任務，此欄位為必填欄位，而且您必須使用下列其中一個值，以決定 memory 參數的受支援值範圍。下表顯示任務層級CPU和記憶體的有效組合。

類型：字串

必要：有條件

要呈現給任務的記憶體硬限制。您可以在任務定義中將記憶體值指定為以 MB （MiB或 gigabyte （GB） 為單位的字串。例如，您可以指定 MiB 3072 或 GB 3 GB中的記憶體值。註冊任務定義時，GB 值會轉換為整數，指出 MiB。

對於託管在 Amazon EC2執行個體上的任務，此欄位是選用的，並且可以使用任何值。如果指定任務層級的記憶體值，則容器層級的記憶體值是選用的。如果您的叢集沒有任何一個已註冊的容器執行個體具有可用的請求記憶體，則任務會失敗。您可以盡可能為特定執行個體類型的任務提供最多的記憶體，以將資源使用率最大化。如需詳細資訊，請參閱保留 Amazon ECS Linux 容器執行個體記憶體。

對於在 Fargate 上 (Linux 和 Windows 皆可) 託管的任務，此欄位為必填欄位，而且您必須使用下列其中一個值，以決定 cpu 參數的受支援值的範圍：

類型：字串

必要：是

容器的名稱。可以包含最多可達 255 個字元 (大小寫)、數字、連字號和底線。如果您在任務定義中連結多個容器，則一個容器的 name 可以輸入另一個容器的 links。這是為了連結容器。

類型：字串

必要：是

用來啟動容器的映像。此字串會直接傳遞至 Docker 常駐程式。根據預設， 中的映像 Docker Hub 有可用的登錄檔。您也可以使用 repository-url/image:tag 或 repository-url/image@digest 指定其他存放庫。允許最多 255 個字元 (大小寫)、數字、連字號、底線、等號、句號、正斜線、井號。此參數會在 docker create-container 命令和 docker 執行命令的IMAGE參數Image中映射至 。

類型：整數

必要：否

提供給容器使用的記憶體數量 (MiB)。如果您的容器嘗試使用超過此處指定的記憶體，容器便會終止。為任務中所有容器預留的記憶體總量必須低於任務 memory 值 (如果已指定一個)。此參數會在 docker create-container 命令Memory中映射至 ，以及用於執行 docker --memory的選項。

如果使用 Fargate 啟動類型，這是選用參數。

如果您使用的是EC2啟動類型，則必須指定任務層級記憶體值或容器層級記憶體值。如果您同時指定容器層級的 memory 和 memoryReservation 值,則 memory 值必須大於 memoryReservation 值。如果指定 memoryReservation，則會從放置容器的容器執行個體可用記憶體資源中減去該值。否則，即使用 memory 的值。

Docker 20.10.0 或更新版本的常駐程式會為容器保留最低 6 MiB 的記憶體。因此，不要為容器指定少於 6 MiB 的記憶體。

Docker 19.03.13-ce 或更舊版本的常駐程式會為容器保留最低 4 MiB 的記憶體。因此，不要為容器指定少於 4 MiB 的記憶體。

類型：整數

必要：否

為容器保留的記憶體軟性限制 (MiB)。當系統記憶體處於爭用狀態時，Docker 會嘗試將容器記憶體保持在此軟限制。但是，您的容器可以在需要時使用更多記憶體。容器可以使用最多達到以 memory 參數指定的硬性限制 (如適用)，或容器執行個體上的所有可用記憶體，以先達到者為準。此參數會在 docker create-container 命令MemoryReservation中映射至 ，以及用於 docker 執行--memory-reservation的選項。

如果未指定任務層級的記憶體值，您必須為容器定義中的 memory 或 memoryReservation 之一或兩者指定非零整數。若您同時指定兩者，memory 必須大於 memoryReservation。如果指定 memoryReservation，則會從放置容器的容器執行個體可用記憶體資源中減去該值。否則，即使用 memory 的值。

例如，若您的容器通常會使用 128 MiB 的記憶體，但會偶爾短期爆量到 256 MiB 的記憶體。您可以將 memoryReservation 設為 128 MiB，並將 memory 硬性限制設為 300 MiB。此組態讓容器只從容器執行個體的剩餘資源中保留 128 MiB 的記憶體。同時，其還允許容器在需要時使用更多的記憶體資源。

Docker 20.10.0 或更新版本的常駐程式會為容器保留最低 6 MiB 的記憶體。因此，不要為容器指定少於 6 MiB 的記憶體。

Docker 19.03.13-ce 或更舊版本的常駐程式會為容器保留最低 4 MiB 的記憶體。因此，不要為容器指定少於 4 MiB 的記憶體。

類型：物件陣列

必要：否

連接埠映射會將容器的網路連接埠公開到外部世界。這可讓用戶端存取您的應用程式。它也用於相同任務中的容器間通訊。

對於使用awsvpc網路模式的任務定義 （Fargate 和EC2啟動類型），請僅指定 containerPort。hostPort 一律會忽略 ，容器連接埠會自動對應至主機上的隨機高編號連接埠。

Windows 上的連接埠映射會使用 NetNAT 閘道地址，而非 localhost。Windows 沒有連接埠映射回送，所以您無法從主機本身存取容器的映射連接埠。

此參數的大多數欄位 （包括 containerPort、hostPort、protocol） 都會映射至 docker create-container 命令PortBindings中的 ，以及 Docker 執行--publish的選項。若任務定義的網路模式設定為 host，則主機連接埠必須為未定義，或符合連接埠映射中的容器連接埠。

若您指定主機連接埠，請使用以下語法。

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

若您希望取得自動指派的主機連接埠，請使用以下語法。

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

類型：RepositoryCredentials 物件

必要：否

私有登錄檔身分驗證的儲存庫登入資料。

如需詳細資訊，請參閱在 Amazon 中使用非AWS 容器映像 ECS。

容器重新啟動政策和相關聯的組態參數。當您為容器設定重新啟動政策時，Amazon ECS可以重新啟動容器，而不需要取代任務。如需詳細資訊，請參閱使用容器重新啟動政策重新啟動 Amazon ECS任務中的個別容器。

用於容器的容器運作狀態檢查命令和相關的設定參數。如需詳細資訊，請參閱使用容器運作狀態檢查來判斷 Amazon ECS任務運作狀態。

類型：整數

必要：否

Amazon ECS容器代理程式為容器保留的cpu單位數量。在 Linux 上，此參數會在建立容器區段CpuShares中映射至 。

針對使用 Fargate 啟動類型的任務，此欄位為選用。為任務內所有容器CPU預留的總量必須低於任務層級cpu值。

Linux 容器與容器執行個體上的其他容器共用未配置的CPU單位，其比率與其配置的數量相同。例如，假設您在單一核心執行個體類型上執行單一容器任務，並為該容器指定 512 個CPU單位。此外，該任務是在容器執行個體上運行的唯一任務。在此範例中，容器可以隨時使用完整的 1，024 CPU單位共用。但是，假設您在該容器執行個體上啟動相同任務的另一個複本。需要時，保證每個任務至少 512 個CPU單位。同樣地，如果其他容器未使用剩餘的 CPU，則每個容器都可以浮動至更高的CPU用量。不過，如果這兩個任務一直都是 100% 作用中，則限制為 512 個CPU單位。

開啟 Linux 容器執行個體，Docker 容器執行個體上的常駐程式會使用 CPU值來計算執行容器的相對CPU共用比率。Linux 核心允許的最小有效CPU共用值為 2，Linux 核心允許的最大有效CPU共用值為 262144。不過， 參數CPU並非必要，您可以在容器定義中使用低於 2 和高於 262144 CPU的值。對於低於兩個 （包括 null） 和高於 262144 CPU的值，該行為會根據您的 Amazon ECS容器代理程式版本而有所不同：

開啟 Windows 容器執行個體，CPU配額會強制執行為絕對配額。Windows 容器只能存取任務定義中CPU定義的指定數量 。null 或零CPU值會傳遞至 Docker 作為 0。Windows 然後將此值解譯為一個 的 1%CPU。

如需更多範例，請參閱 Amazon 如何ECS管理和CPU記憶體資源。

類型：ResourceRequirement 物件

必要：否

Amazon ECS容器代理程式保留給容器GPUs的實體數量。為任務中所有容器GPUs預留的 數目不得超過任務啟動時容器執行個體GPUs上可用的 數目。如需詳細資訊，請參閱GPU 工作負載的 Amazon ECS任務定義。

類型：ResourceRequirement 物件

必要：否

對於 InferenceAccelerator 類型，value 符合任務定義中指定之 InferenceAccelerator 的 deviceName。如需詳細資訊，請參閱Elastic Inference 加速器名稱。

類型：布林值

必要：否

假設容器的 essential 參數標記為 true，並且該容器因為任何理由失敗或停止。然後，會停止屬於該任務一部分的所有其他容器。若容器的 essential 參數標記為 false，則其失敗將不會影響任務中其餘的容器。若省略此參數，則容器會假設為「基本」。

所有任務都必須至少有一個基本容器。假設您有一個由多個容器組成的應用程式。然後，將用於一般用途的容器分組為元件，並把不同的元件分到多個任務定義。如需詳細資訊，請參閱為 Amazon 建構您的應用程式 ECS。

"essential": true|false

類型：字串陣列

必要：否

傳遞至容器的進入點。

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

類型：字串陣列

必要：否

傳遞至容器的命令。此參數會在 create-container 命令Cmd中映射至 ，並將要執行的COMMAND參數映射至 。如果有多個引數，確保每個引數在陣列中是分開的字串。

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

類型：字串

必要：否

容器內要執行命令的工作目錄。此參數會在 Docker Remote 的建立容器區段WorkingDir中映射至 ，並將 --workdir選項映射至 docker run。 API

"workingDirectory": "string"

類型：物件陣列

必要：否

內含要傳遞至容器之環境變數的檔案清單。此參數會映射至 --env-file選項至 docker 執行命令。

使用EC2啟動類型在主機上FIPS啟用 時，不支援具有句點 （.） 的儲存貯體名稱 （例如 amzn-s3-demo-bucket1.name.example）。儲存貯體名稱中有句點 （.） 會阻止任務啟動，因為代理程式無法從 Amazon S3 提取環境變數檔案。

這不適用於 Windows Fargate 上的容器和 Windows 容器

您最多可以指定 10 個環境檔案。檔案副檔名必須是 .env。環境檔案中的每一行都包含 VARIABLE=VALUE 格式的環境變數。以 # 開頭的行會被視為註解，而忽略。

如果在容器定義中指定了個別環境變數，它們的優先順序高於環境檔案中包含的變數。如果指定了內含相同變數的多個環境檔案，則處理順序為由上而下。建議您使用唯一的變數名稱。如需詳細資訊，請參閱將個別環境變數傳遞至 Amazon ECS容器。

類型：物件陣列

必要：否

傳遞至容器的環境變數。此參數會在 docker create-container 命令Env中映射至 ，並將 --env選項映射至 docker 執行命令。

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

類型：物件陣列

必要：否

代表公開到容器之秘密的物件。如需詳細資訊，請參閱將敏感資料傳遞至 Amazon ECS容器。

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

類型：布林值

必要：否

當此參數為 true 時，聯網便會在容器中關閉。

預設值為 false。

"disableNetworking": true|false

類型：字串陣列

必要：否

link 參數可讓容器彼此通訊，而無需連接埠映射。只有在任務定義的網路模式設定為 bridge 時才支援此參數。建構類似於 name:internalName name:alias中的 Docker 連結。最多允許 255 個字母 （大寫和小寫）、數字、連字號和底線。

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

類型：字串

必要：否

您容器要使用的主機名稱。此參數會映射至 Docker 建立容器Hostname中的 ，以及 Docker 執行--hostname的選項。

"hostname": "string"

類型：字串陣列

必要：否

呈現至容器的DNS伺服器清單。

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

類型：字串陣列

必要：否

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

向容器顯示的DNS搜尋網域清單。此參數會在 docker create-container 命令DnsSearch中映射到 ，以--dns-search選擇執行 docker。

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

類型：物件陣列

必要：否

要附加到容器上 /etc/hosts 檔案的主機名稱和 IP 地址映射清單。

此參數會在 docker create-container 命令ExtraHosts中映射至 ，並映射至 docker 執行--add-host的選項。

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

類型：布林值

必要：否

此參數為 true 時，容器會取得根檔案系統的唯讀存取權。此參數會在 docker create-container 命令ReadonlyRootfs中映射到 ，以--read-only選擇執行 docker。

預設值為 false。

"readonlyRootFilesystem": true|false

類型：物件陣列

必要：否

容器中資料磁碟區的掛載點。此參數會映射至 creat-container Docker Volumes中的 ，API以及 Docker 執行--volume的選項。

Windows 容器可在 $env:ProgramData 所在的相同磁碟上掛載整個目錄。Windows 容器無法將目錄掛載到不同的磁碟機上，且掛載點也無法跨磁碟機使用。您必須指定掛載點，才能將 Amazon EBS磁碟區直接連接至 Amazon ECS任務。

類型：物件陣列

必要：否

要從其他容器掛載的資料磁碟區。此參數會在 docker create-container 命令VolumesFrom中映射至 ，以及用於執行 docker --volumes-from的選項。

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

類型：LogConfiguration物件

必要：否

容器的日誌組態規格。

例如，使用日誌組態的任務定義，請參閱Amazon ECS任務定義範例。

此參數會在 docker create-container 命令LogConfig中映射至 ，並映射至 docker 執行--log-driver的選項。根據預設，容器使用與 相同的記錄驅動程式 Docker 常駐程式使用。不過，容器可能會使用與 不同的記錄驅動程式 Docker 常駐程式，方法是在容器定義中指定具有此參數的日誌驅動程式。若要讓容器使用不同的日誌驅動程式，必須在容器執行個體上適當設定日誌系統 (或在不同的日誌伺服器上使用遠端記錄選項)。

指定容器的日誌組態時，請考量下列事項：

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

類型：FirelensConfiguration物件

必要：否

容器的 FireLens 組態。這是用來指定及設定容器日誌的日誌路由器。如需詳細資訊，請參閱將 Amazon ECS日誌傳送至 AWS 服務或 AWS Partner。

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

類型：字串陣列

必要：否

憑證規格 （CredSpec） 檔案ARNs的 SSM或 Amazon S3 清單，可設定容器進行 Active Directory 身分驗證。建議您使用此參數而不是 dockerSecurityOptions. 的最大數量ARNs為 1。

每個 有兩種格式ARN。

在這兩種格式中，MyARN使用 ARN SSM或 Amazon S3 中的 取代 。

credspec 必須在 Secrets Manager ARN中提供 的秘密，其中包含使用者名稱、密碼和要連線的網域。為了提高安全性，執行個體不會加入網域以進行無網域驗證。執行個體上的其他應用程式無法使用無網域憑證。您可以使用此參數在相同的執行個體上執行任務，即使是任務需要加入不同的網域。如需詳細資訊，請參閱使用 gMSAs for Windows Containers 和使用 gMSAs for Linux Containers 。

類型：布林值

必要：否

此參數為 true 時，容器便會取得主機容器執行個體的更高權限 (類似 root 使用者)。建議不要使用 privileged 執行容器。在大多數情況下，可以使用特定參數，而不是使用 privileged 來指定所需的確切權限。

此參數會在 docker create-container 命令Privileged中映射至 ，並映射至 docker 執行--privileged的選項。

預設值為 false。

"privileged": true|false

類型：字串

必要：否

要在容器內使用的使用者。此參數在 docker create-container 命令User中映射到 ，並映射到 docker 執行--user的選項。

您可以使用下列格式指定 user。如果指定 UID或 GID，您必須將其指定為正整數。

"user": "string"

類型：字串陣列

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

必要：否

提供多個安全系統自訂組態的字串清單。此欄位對使用 Fargate 啟動類型之任務中的容器無效。

用於 Linux 上的任務EC2，此參數可用於參考 的自訂標籤 SELinux 以及 AppArmor 多層安全系統。

對於 上的任何任務EC2，此參數可用於參考憑證規格檔案，以設定容器進行 Active Directory 身分驗證。如需詳細資訊，請參閱 了解如何使用 gMSAs Amazon 的 EC2 Windows 容器 ECS 和 使用 gMSA 適用於 EC2 Linux Amazon 上的容器 ECS。

此參數會在 docker create-container 命令SecurityOpt中映射至 ，並映射至 docker 執行--security-opt的選項。

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

類型：物件陣列

必要：否

要為容器定義的 ulimit 值清單。此值覆寫作業系統的預設資源配額設定。此參數會在 docker create-container 命令Ulimits中映射至 ，以及用於執行 docker --ulimit的選項。

託管在 Fargate 上的 Amazon ECS任務會使用作業系統設定的預設資源限制值，但nofile資源限制參數除外。nofile 資源限制會對容器可使用的開放檔案數量設限。在 Fargate 上，預設的 nofile 軟限制為 65535，硬限制為 65535。您可以將兩個限制的值設定為 1048576。如需詳細資訊，請參閱任務資源限制。

此參數需要容器執行個體上 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
      }
      ...
    ]

類型：字串到字串映射

必要：否

要新增到容器的標籤索引鍵/值映射。此參數會在 docker create-container 命令Labels中映射至 ，以及用於執行 docker --label的選項。

此參數需要容器執行個體上 Docker Remote API或更新版本的 1.18 版。

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

類型：LinuxParameters 物件

必要：否

Linux套用至容器的特定選項，例如 KernelCapabilities。

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

類型：ContainerDependency 物件陣列

必要：否

針對容器啟動和關閉而定義的相依性。容器可包含多個相依性。針對容器啟動而定義相依性時，它會保留給容器關閉。如需範例，請參閱容器相依性。

對於託管在 Amazon EC2執行個體上的 Amazon ECS任務，執行個體至少需要 1.26.0 版本的容器代理程式才能啟用容器相依性。不過，我們建議您使用最新版的容器代理程式。如需檢查代理程式版本及更新至最新版本的資訊，請參閱「更新 Amazon ECS容器代理程式」。如果您使用的是 Amazon ECS最佳化的 Amazon Linux AMI，執行個體至少需要 1.26.0-1 版本的ecs-init套件。如果您的容器執行個體是從 20190301 版或更新版本啟動，它們會包含所需的容器代理程式和 ecs-init 版本。如需詳細資訊，請參閱Amazon ECS最佳化 Linux AMIs。

對於託管在 Fargate 上的 Amazon ECS任務，此參數要求任務或服務使用平台版本 1.3.0 或更新版本 （Linux） 或 1.0.0（Windows).

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

類型：整數

必要：否

範例值：120

解析容器的相依性時在放棄之前等待的持續時間 (以秒為單位)。

例如，您在任務定義中指定兩個容器，其中的 containerA 對達到 COMPLETE、SUCCESS 或 HEALTHY 狀態的 containerB 有相依性。如果為 containerB 指定 startTimeout 值，但在該時間內沒有達到所需狀態，則 containerA 不會啟動。

對於託管在 Fargate 上的 Amazon ECS任務，此參數要求任務或服務使用平台版本 1.3.0 或更新版本 （Linux）。 最大值為 120 秒。

類型：整數

必要：否

範例值：120

當容器本身未正常結束時，強制終止容器之前的等待期間 (以秒為單位)。

對於託管在 Fargate 上的 Amazon ECS任務，此參數要求任務或服務使用平台版本 1.3.0 或更新版本 （Linux）。 如果未指定 參數，則會使用預設值 30 秒。Fargate 的最大值為 120 秒。

對於使用EC2啟動類型的任務，如果未指定 stopTimeout 參數，ECS_CONTAINER_STOP_TIMEOUT則會使用 Amazon ECS容器代理程式組態變數的值集。如果未設定 stopTimeout 參數或ECS_CONTAINER_STOP_TIMEOUT代理程式組態變數，則 的預設值為 30 秒 Linux 容器和 30 秒 Windows 會使用容器。容器執行個體至少需要 1.26.0 版的容器代理程式，才能啟用容器停止逾時值。不過，我們建議您使用最新版的容器代理程式。如需如何檢查代理程式版本及更新至最新版本的資訊，請參閱「更新 Amazon ECS容器代理程式」。如果您使用的是 Amazon ECS最佳化的 Amazon Linux AMI，您的執行個體至少需要 1.26.0-1 版的ecs-init套件。如果您的容器執行個體是從 20190301 版或更新版本啟動，它們會包含所需的容器代理程式和 ecs-init 版本。如需詳細資訊，請參閱Amazon ECS最佳化 Linux AMIs。

類型：SystemControl 物件

必要：否

要在容器中設定的命名空間核心參數清單。此參數會在 docker create-container 命令Sysctls中映射至 ，以及用於執行 docker --sysctl的選項。例如，您可以規劃 net.ipv4.tcp_keepalive_time 設定以維持壽命較長的連線。

不建議您指定單一任務中多個容器的網路相關 systemControls 參數，而單一任務也使用 awsvpc 或 host 網路模式。執行此操作的缺點如下：

如果您要將IPC資源命名空間設定為用於任務中的容器，則下列條件適用於您的系統控制項。如需詳細資訊，請參閱IPC 模式。

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

類型：布林值

必要：否

此參數為 true 時，您可部署需要配置 stdin 或 tty 的容器化應用程式。此參數會在 docker create-container 命令OpenStdin中映射至 ，以及用於執行 docker --interactive的選項。

預設值為 false。

類型：布林值

必要：否

當此參數為 時true，TTY會配置 。此參數在 docker create-container 命令Tty中映射至 ，且--tty選項 todocker 執行。

預設值為 false。

類型：字串

必要：是

彈性推論加速器裝置名稱。deviceName 也必須在容器定義中參照，請參閱 Elastic Inference accelerator。

類型：字串

必要：是

要使用的彈性推論加速器。

類型：字串

必要：否

限制所套用的叢集查詢語言運算式。如需詳細資訊，請參閱建立運算式以定義 Amazon ECS任務的容器執行個體。

類型：字串

必要：是

限制類型。使用 memberOf，以將選擇限制於特定群組或有效的待選項目。

類型：ProxyConfiguration 物件

必要：否

App Mesh 代理的組態詳細資訊。

對於使用EC2啟動類型的任務，容器執行個體至少需要 1.26.0 版的容器代理程式，以及至少 1.26.0-1 版的ecs-init套件，才能啟用代理組態。如果您的容器執行個體是從 Amazon ECS最佳化AMI版本 20190301 或更新版本啟動，則會包含容器代理程式和 的必要版本ecs-init。如需詳細資訊，請參閱Amazon ECS最佳化 Linux AMIs。

對於使用 Fargate 啟動類型的任務，此功能要求任務或服務必須使用平台版本 1.3.0 或更新版本。

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

類型：字串

必要：否

磁碟區名稱。最多允許 255 個字母 （大寫和小寫）、數字、連字號 （-） 和底線 （_）。此名稱會在容器定義mountPoints物件的 sourceVolume 參數中參考。

必要：否

參數host用於將繫結掛載的生命週期與主機 Amazon EC2執行個體，而不是任務及其存放位置綁定。如果 host 參數是空的，則 Docker 常駐程式會為您的資料磁碟區指派主機路徑，但其相關聯的容器停止執行後，不保證會保留資料。

Windows 容器可在 $env:ProgramData 所在的相同磁碟上掛載整個目錄。

類型：布林值

必要：否

指定磁碟區是否可在啟動時設定。設定為 時true，您可以在執行獨立任務或建立或更新服務時設定磁碟區。設定為 時true，您將無法在任務定義中提供另一個磁碟區組態。此參數必須設定為 true，以設定要連接至任務的 Amazon EBS磁碟區。configuredAtLaunch 將磁碟區組態設定為啟動階段true並延後啟動階段，可讓您建立任務定義，而這些定義不會限制為磁碟區類型或特定磁碟區設定。這樣做可讓任務定義在不同執行環境中重複使用。如需詳細資訊，請參閱 Amazon EBS磁碟區 。

類型：DockerVolumeConfiguration物件

必要：否

此參數只有使用 Docker 磁碟區時才會指定。只有在EC2執行個體上執行任務時，才支援 Docker 磁碟區。Windows 容器僅支援使用local驅動程式。若要使用綁定掛載，請指定 host。

類型：EFSVolumeConfiguration物件

必要：否

使用 Amazon EFS磁碟區時指定此參數。

類型：FSxWindowsFileServerVolumeConfiguration物件

必要：是

當您使用 Amazon FSx for Windows File Server 檔案系統儲存任務時，會指定此參數。

類型：字串

必要：否

組成標籤的鍵值組的一部分。索引鍵是一般標籤，作用就像更特定標籤值的類別。

類型：字串

必要：否

組成標籤的鍵值組的選用部分。值就像標籤類別 (索引鍵) 內的描述項。

類型：EphemeralStorage 物件

必要：否

為任務配置的暫時性儲存量 (以 GB 為單位)。對於託管於 AWS Fargate的任務，此參數可用來擴充可用的暫時性儲存總量 (超過預設數量)。如需詳細資訊，請參閱搭配 Amazon 使用繫結掛載 ECS。

類型：字串

必要：否

用於任務中容器IPC的資源命名空間。有效值為 host、task 或 none。如果host已指定 ，則位於在相同容器執行個體上指定hostIPC模式之任務中的所有容器都會與主機 Amazon EC2執行個體共用相同的IPC資源。如果已指定 task ，則指定任務中的所有容器都會共用相同的IPC資源。如果 none 已指定，則任務容器中IPC的資源為私有，不會與任務或容器執行個體中的其他容器共用。如果未指定任何值，則IPC資源命名空間共用取決於容器執行個體上的 Docker 常駐程式設定。

如果使用 host IPC 模式，則可能會有不必要的IPC命名空間暴露風險增加。

如果您要設定systemControls用於任務中容器的命名空間核心參數，則以下內容適用於您的IPC資源命名空間。

類型：字串

有效值: host | task

必要：否

要用於任務中容器的程序命名空間。有效值為 host 或 task。在 Linux 容器的 Fargate 上，唯一有效的值為 task。例如，監控附屬可能需要 pidMode 存取相同任務中執行之其他容器的相關資訊。

如果host已指定 ，在相同容器執行個體上指定 host PID 模式的任務中的所有容器都會與主機 Amazon EC2執行個體共用相同的程序命名空間。

如果已指定 task，則指定任務內的所有容器會共用相同的程序命名空間。

如果未指定任何值，每個容器的預設值會是私有命名空間。

如果使用 host PID 模式，則可能會有不必要的程序命名空間暴露的風險增加。