Amazon EC2 的 Amazon ECS 任務定義參數

類型：字串

必要：是

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

類型：字串陣列

必要：否

有效值:EC2

驗證任務定義所依據的容量。這會啟動檢查，確保任務定義中使用的所有參數都能滿足 Amazon EC2 的需求。

類型：字串

必要：否

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

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

類型：字串

必要：有條件

授予 Amazon ECS 容器代理程式許可以代表您進行 AWS API 呼叫的任務執行角色的 Amazon Resource Name (ARN)。

類型：字串

必要：否

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

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

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

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

如果網路模式是 awsvpc，則任務會配置一個彈性網路介面，而當您使用此任務定義建立服務或執行任務時，您必須指定 NetworkConfiguration。如需更多詳細資訊，請參閱 EC2 的 Amazon ECS 任務網路選項。

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

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

允許的網路模式取決於底層 EC2 執行個體的作業系統。如果是 Linux，則可以使用任何網路模式。如果是 Windows，則會使用 default 和 awsvpc 模式。

類型：字串

必要：有條件

預設：LINUX

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

有效值為 LINUX、WINDOWS_SERVER_2025_FULL、WINDOWS_SERVER_2025_CORE、WINDOWS_SERVER_2022_CORE、WINDOWS_SERVER_2022_FULL、WINDOWS_SERVER_2019_FULL、WINDOWS_SERVER_2019_CORE、WINDOWS_SERVER_2016_FULL、WINDOWS_SERVER_2004_CORE 與 WINDOWS_SERVER_20H2_CORE。

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

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

類型：字串

必要：有條件

預設：X86_64

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

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

若有 Linux 任務，可將值設定為 ARM64。如需更多詳細資訊，請參閱 64 位元 ARM 工作負載的 Amazon ECS 任務定義。

類型：字串

必要：有條件

針對任務呈現的 CPU 單位硬性限制。您可以在 JSON 檔案中將 CPU 值指定為以 CPU 為單位或虛擬 CPU (vCPU) 為單位的字串。例如，可指定 1024 個 CPU 單位作為 CPU 值，也可指定 1 vCPU 個 vCPU 作為 CPU 值。註冊任務定義時，vCPU 值會轉換為整數，指出 CPU 單位。

此欄位為選用欄位。如果您的叢集沒有任何一個已註冊的容器執行個體具有可用的請求 CPU 單位，則任務會失敗。支援的值介於 0.125 個 vCPU 與 192 個 vCPU 之間。

類型：字串

必要：有條件

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

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

類型：字串

必要：是

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

類型：字串

必要：是

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

類型：字串

有效值：enabled|disabled

必要：否

指定 Amazon ECS 是否會將容器定義中提供的容器映像標籤解析為映像摘要。此行為預設為 enabled。如果將容器的值設定為 disabled，Amazon ECS 不會將容器映像標籤解析為摘要，但會使用容器定義中指定的原始映像 URI 進行部署。如需有關容器映像解析的詳細資訊，請參閱容器映像解析度。

類型：整數

必要：否

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

您必須指定任務層級的記憶體值或容器層級的記憶體值。如果您同時指定容器層級的 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 run 的 --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 網路模式的任務定義，只指定 containerPort。一律略過 hostPort，且容器連接埠會自動映射至主機上的隨機高連接埠號碼。

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

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

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

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

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

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

類型：RepositoryCredentials 物件

必要：否

私有登錄檔身分驗證的儲存庫憑證。

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

容器重新啟動政策及相關組態參數。在為容器設定重新啟動政策後，Amazon ECS 可以重新啟動容器，無需取代任務。如需更多詳細資訊，請參閱 使用容器重新啟動政策在 Amazon ECS 任務中重新啟動個別容器。

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

類型：整數

必要：否

Amazon ECS 容器代理程式保留給容器的 cpu 數量。在 Linux 上，此參數會映射至 Create a container 區段中的 CpuShares。

Linux 容器會按照與其配置數量相同的比例，與容器執行個體上的其他容器共用未配置的 CPU 單位。例如，若您在單一核心執行個體類型上執行單一容器任務，為該容器指定 512 個 CPU 單位。此外，該任務是在容器執行個體上運行的唯一任務。在此範例中，該容器便可在任何指定的時間內使用完整 1,024 個 CPU 單位。但是，假設您在該容器執行個體上啟動相同任務的另一個複本。每個任務都可以保證在需要的時候取得最少 512 個 CPU 單位。同樣，如果其他容器沒有使用剩餘的 CPU，每個容器都可以浮動到更高的 CPU 用量。但若兩個任務都一直維持在 100% 作用中的狀態，兩者能夠取得的單位數便會限制在 512 個 CPU 單位。

在 Linux 容器執行個體上，容器執行個體的 Docker 常駐程式會使用 CPU 值計算執行中容器的相對 CPU 共用比例。Linux 核心允許的有效 CPU 共用值，最小為 2，最大為 262144。但是，CPU 參數並非必要項目，且您可以在容器定義中使用小於 2 且大於 262144 的 CPU 值。針對小於 2 且大於 262144 的 CPU 值 (包含 null)，行為會隨您的 Amazon ECS 容器代理程式版本而異：

在 Windows 容器執行個體上，CPU 配額會強制為絕對配額。Windows 容器只能存取任務定義中定義的指定 CPU 數量。Null 或零的 CPU 值會以 0 形式傳遞給 Docker。然後 Windows 將此值解讀為一個 CPU 的 1%。

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

類型：ResourceRequirement 物件

必要：否

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

類型：ResourceRequirement 物件

必要：否

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

類型：布林值

必要：否

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

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

"essential": true|false

類型：字串陣列

必要：否

傳遞至容器的進入點。

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

類型：字串陣列

必要：否

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

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

類型：字串

必要：否

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

"workingDirectory": "string"

類型：物件陣列

必要：否

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

啟用 FIPS 後，不支援具有句點 (.) 的儲存貯體名稱 (例如 amzn-s3-demo-bucket1.name.example)。儲存貯體名稱包含句點 (.) 會導致任務無法啟動，因為代理程式無法從 Amazon S3 提取環境變數檔案。

這不適用於 Windows 容器。

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

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

類型：物件陣列

必要：否

傳遞至容器的環境變數。此參數會映射至 docker create-container 命令中的 Env 參數，以及 docker run 命令的 --env 選項。

"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 建構模組與 Docker 連結中的 name:alias 類似。最多可輸入 255 個字母 (大小寫)、數字、連字號與底線。

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

類型：字串

必要：否

您容器要使用的主機名稱。此參數會映射至 docker create-container 中的 Hostname，以及 docker run 的 --hostname 選項。

"hostname": "string"

類型：字串陣列

必要：否

提供給容器的 DNS 伺服器清單。

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

類型：字串陣列

必要：否

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

提供給容器的 DNS 搜尋網域清單。此參數會映射至 docker create-container 命令中的 DnsSearch，以及 docker run 的 --dns-search 選項。

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

類型：物件陣列

必要：否

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

此參數會映射至 docker create-container 命令中的 ExtraHosts，以及 docker run 的 --add-host 選項。

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

類型：布林值

必要：否

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

預設值為 false。

"readonlyRootFilesystem": true|false

類型：物件陣列

必要：否

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

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

類型：物件陣列

必要：否

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

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

類型：LogConfiguration 物件

必要：否

容器的日誌組態規格。

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

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

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

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

類型：FirelensConfiguration 物件

必要：否

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

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

類型：字串陣列

必要：否

SSM 或 Amazon S3 中的 ARN 清單，用於為 Active Directory 身分驗證設定容器的憑證規格 (CredSpec) 檔案。建議您使用此參數而不是 dockerSecurityOptions. ARN 的上限為 1。

每個 ARN 有兩種格式。

在這兩種格式中，以 SSM 或 Amazon S3 中的 ARN 替換 MyARN。

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

類型：布林值

必要：否

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

此參數會映射至 docker create-container 命令中的 Privileged，以及 docker run 的 --privileged 選項。

預設值為 false。

"privileged": true|false

類型：字串

必要：否

要在容器內使用的使用者。此參數會映射至 docker create-container 命令中的 User，以及 docker run 的 --user 選項。

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

"user": "string"

類型：字串陣列

有效值：「沒有新的權限」|「AppArmor：描述檔」|「標籤：值」|「憑證規格：憑證規格路徑」

必要：否

提供多個安全系統自訂組態的字串清單。

對於 Linux 任務，此參數可用於引用 SELinux 與 AppArmor 多層級安全系統的自訂標籤。

此參數可在設定 Active Directory 身分驗證的容器時用於引用憑證規格檔案。如需詳細資訊，請參閱了解如何在 Amazon ECS 上為 EC2 Windows 容器使用 gMSA及在 Amazon ECS 上為 EC2 Linux 容器使用 gMSA。

此參數會映射至 docker create-container 命令中的 SecurityOpt，以及 docker run 的 --security-opt 選項。

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

類型：物件陣列

必要：否

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

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

"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 run 的 --label 選項。

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

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

類型：LinuxParameters 物件

必要：否

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

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

類型：ContainerDependency 物件陣列

必要：否

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

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

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

類型：整數

必要：否

範例值：120

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

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

最高值為 120 秒。

類型：整數

必要：否

範例值：120

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

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

類型：SystemControl 物件

必要：否

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

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

如果您為任務中的容器設定要使用的 IPC 資源命名空間，以下各項條件套用到您的系統控制。如需更多詳細資訊，請參閱 IPC 模式。

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

類型：布林值

必要：否

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

預設值為 false。

類型：布林值

必要：否

當此參數為 true 時，會配置 TTY。此參數會映射至 docker create-container 命令中的 Tty，以及 docker run 的 --tty 選項。

預設值為 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 AMI。

"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 檔案系統時指定。

類型：字串

必要：否

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

類型：字串

必要：否

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

類型：字串

必要：否

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

如果是使用 host IPC 模式，這會提高將不需要的 IPC 命名空間公開的風險。

如果是使用 systemControls 來為任務中的容器設定命名空間核心參數，以下各項會套用到您的 IPC 資源命名空間。

類型：字串

有效值: host | task

必要：否

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

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

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

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

如果是使用 host PID 模式，這會提高將不需要的程序命名空間公開的風險。

類型：布林值

有效值: true | false

必要：否

如果此參數設定為 true，在任務的承載中，Amazon ECS 接受來自任務容器的故障注入請求。根據預設，此參數會設定為 false。