Menu
AWS CloudFormation
User Guide (API Version 2010-05-15)

Amazon EC2 Container Service TaskDefinition ContainerDefinitions PortMappings

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

Syntax

JSON

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

YAML

Copy
ContainerPort: Integer HostPort: Integer Protocol: String

Properties

For more information about each property, see Task Definition Parameters in the Amazon EC2 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 EC2 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 EC2 Container Service Developer Guide. By default, AWS CloudFormation specifies tcp.

Required: No

Type: String

On this page: