Sign In to the Console
AWS CloudFormation
User Guide (API Version 2010-05-15)

AWS Documentation » AWS CloudFormation » User Guide » Template Reference » AWS Resource and Property Types Reference » Amazon Elastic Container Service Resource Types Reference » AWS::ECS::TaskDefinition » Amazon Elastic Container Service TaskDefinition PortMapping

Amazon Elastic Container Service TaskDefinition PortMapping

PortMappings is a property of the Amazon Elastic Container Service TaskDefinition ContainerDefinition property that maps a container port to a host port.

Syntax

JSON

{
  "ContainerPort" : Integer,
  "HostPort" : Integer,
  "Protocol" : String
}

YAML

ContainerPort: Integer
HostPort: Integer
Protocol: String

Properties

For more information about each property, see Task Definition Parameters in the Amazon Elastic Container Service Developer Guide.

ContainerPort

The port number on the container bound to the host port.

Required: Yes

Type: Integer

HostPort

The host port number on the container instance that you want to reserve for your container. You can specify a non-reserved host port for your container port mapping, omit the host port, or set the host port to 0. If you specify a container port but no host port, your container host port is assigned automatically .

Don't specify a host port in the 49153 to 65535 port range; these ports are reserved for automatic assignment. Other reserved ports include 22 for SSH, 2375 and 2376 for Docker, and 51678 for the Amazon Elastic Container Service container agent. Don't specify a host port that is being used for a task—that port is reserved while the task is running.

Required: No

Type: Integer

Protocol

The protocol used for the port mapping. For valid values, see the protocol parameter in the Amazon Elastic Container Service Developer Guide. By default, AWS CloudFormation specifies tcp.

Required: No

Type: String

On this page: