Windows批处理中AWS CLI注册ECS任务定义端口映射类型错误解决

问题根源 #

你之前使用的portMappings={containerPort=7000,hostPort=7000}是非标准JSON格式，AWS CLI会将这种键值对格式下的数字解析为字符串类型，而ECS任务定义要求containerPort和hostPort必须是整数类型，因此触发类型不匹配错误。

正确实现方式 #

方式1：命令行直接传入标准JSON（处理Windows转义） #

在Windows批处理中，需对JSON内部的双引号进行转义，确保AWS CLI能正确识别整数类型的端口值。示例命令如下：

aws ecs register-task-definition ^
  --family your-task-family ^
  --container-definitions "[{\"name\": \"your-container-name\", \"image\": \"your-image:tag\", \"portMappings\": [{\"containerPort\": 7000, \"hostPort\": 7000}]}]"

• 用\"转义JSON内部的双引号，避免被Windows批处理解析为命令行参数边界
• portMappings为数组结构（用[]包裹），每个端口映射是独立的JSON对象（用{}包裹）
• 端口值直接写数字，不带引号，确保解析为整数类型

方式2：使用外部JSON文件（推荐） #

避开命令行转义的麻烦，将容器定义写入单独的JSON文件，再通过file://引用：

1. 创建container-defs.json文件，内容如下：

[
  {
    "name": "your-container-name",
    "image": "your-image:tag",
    "portMappings": [
      {
        "containerPort": 7000,
        "hostPort": 7000
      }
    ]
  }
]

2. 在批处理脚本中执行命令：

aws ecs register-task-definition ^
  --family your-task-family ^
  --container-definitions file://container-defs.json

这种方式更清晰易维护，尤其适合复杂的任务定义，无需处理转义问题。

内容的提问来源于stack exchange，提问作者ardito.bryan