指定された CPU またはメモリの値が無効

Amazon ECS API または を使用してタスク定義を登録する場合 AWS CLI、無効な cpuまたは memory値を指定すると、次のエラーが返されます。

An error occurred (ClientException) when calling the RegisterTaskDefinition operation: Invalid 'cpu' setting for task. For more information, see the Troubleshooting section of the Amazon ECS Developer Guide.

注記

Terraform を使用する場合、次のエラーが返される可能性があります。

Error: ClientException: No Fargate configuration exists for given values.

この問題を解決するには、タスク定義でタスクの CPU とメモリにサポートされている値を指定する必要があります。cpu 値は、タスク定義で CPU ユニットまたは vCPUsで表現できます。タスク定義が登録されたときの CPU ユニットを示す整数に変換されます。memory 値は、タスク定義で MiB または GB で表すことができます。これは、タスク定義が登録されたときの MiB を示す整数に変換されます。

requiresCompatibilitiesパラメータのみをEC2指定するタスク定義では、サポートされる CPU 値は、256CPU 単位 (0.25vCPUs) と16384CPU 単位 (16vCPUs)の間です。メモリ値は整数でなければならず、制限は使用する基盤となる Amazon EC2 インスタンスで使用可能なメモリの量によって異なります。

requiresCompatibilities パラメータFARGATEに を指定するタスク定義では ( EC2も指定されている場合でも）、次の表のいずれかの値を使用する必要があります。これらの値によって、CPU およびメモリパラメータでサポートされる値の範囲が決まります。

Fargate でホストされるタスクの場合、次の表に有効な CPU とメモリの組み合わせを示します。JSON ファイルのメモリ値は MiB 単位で指定されます。この値に 1024 を掛けると、GB 値を MiB に変換できます。例えば、1 GB = 1024 MiB です。

CPU の値	メモリの値	AWS Fargate でサポートされるオペレーティングシステム
256 (.25 vCPU)	512 MiB、1 GB、2 GB	Linux
512 (.5 vCPU)	1 GB、2 GB、3 GB、4 GB	Linux
1,024 (1 vCPU)	2 GB、3 GB、4 GB、5 GB、6 GB、7 GB、8 GB	Linux、Windows
2,048 (2 vCPU)	4 GB ～ 16 GB (1 GB のインクリメント)	Linux、Windows
4,096 (4 vCPU)	8 GB ～ 30 GB (1 GB のインクリメント)	Linux、Windows
8192 (8 vCPU) 注記 このオプションには Linux プラットフォーム 1.4.0 以降が必要です。	16 GB～60 GB (4 GB のインクリメント)	Linux
16384 (16vCPU) 注記 このオプションには Linux プラットフォーム 1.4.0 以降が必要です。	32 GB～120 GB (8 GB のインクリメント)	Linux

Amazon EC2 でホストされているタスクの場合、サポートされているタスク CPU 値は 0.25 vCPUsから 192 vCPUs。

注記

タスクレベル CPU およびメモリのパラメータは Windows コンテナでは無視されます。