awscc_ecs_task_definition (Data Source)

Data Source schema for AWS::ECS::TaskDefinition

Schema

Required

Read-Only

Nested Schema for container_definitions.depends_on

Read-Only: md5-29b177e3f357f4fac1d884084b93f7b3

Nested Schema for container_definitions.environment

Read-Only: md5-b4d848db42104a970a65320ca373a7eb

Nested Schema for container_definitions.environment_files

Read-Only: md5-db0a070ec45ec5e4275996f3708103b3

Nested Schema for container_definitions.extra_hosts

Read-Only: md5-3bfb8b57d68ca82c058076f431d33c4a

Nested Schema for container_definitions.firelens_configuration

Read-Only: md5-c3b79d3bd970914b9426a7ebd1bb3d1d

Nested Schema for container_definitions.health_check

Read-Only: md5-543518f06872d3869313f2be8b0809d5

Nested Schema for container_definitions.linux_parameters

Read-Only: md5-5e5d68dac6d534befbfc7f8c28f31403

Nested Schema for container_definitions.linux_parameters.capabilities

Read-Only: md5-9898518d52bdd5968412b45e6ecb7ba9

Nested Schema for container_definitions.linux_parameters.devices

Read-Only: md5-baa272464d911ed3c8403c90a4eee3e1

Nested Schema for container_definitions.linux_parameters.tmpfs

Read-Only: md5-afe0460b30f3e160f6b17c943253c9c0

Nested Schema for container_definitions.log_configuration

Read-Only: md5-1c7f34eb4b76b3f0dc51d20e78d005f3

Nested Schema for container_definitions.log_configuration.secret_options

Read-Only: md5-a471b4cf56886f1cfa067737c005a99d

Nested Schema for container_definitions.mount_points

Read-Only: md5-d8e628c63e99ae6c38033266f4f6788d

Nested Schema for container_definitions.port_mappings

Read-Only: md5-382c74e1db35226a8e4fc88dacf65f1f

You can call DescribeTasks to view the hostPortRange which are the host ports that are bound to the container ports.

  • host_port (Number) The port number on the container instance to reserve for your container. If you specify a containerPortRange, leave this field empty and the value of the hostPort is set as follows:

    If you use containers in a task with the awsvpc or host network mode, the hostPort can either be left blank or set to the same value as the containerPort. If you use containers in a task with the bridge network mode, you can specify a non-reserved host port for your container port mapping, or you can omit the hostPort (or set it to 0) while specifying a containerPort and your container automatically receives a port in the ephemeral port range for your container instance operating system and Docker version. The default ephemeral port range for Docker version 1.6.0 and later is listed on the instance under /proc/sys/net/ipv4/ip_local_port_range. If this kernel parameter is unavailable, the default ephemeral port range from 49153 through 65535 (Linux) or 49152 through 65535 (Windows) is used. Do not attempt to specify a host port in the ephemeral port range as these are reserved for automatic assignment. In general, ports below 32768 are outside of the ephemeral port range. The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376, and the Amazon ECS container agent ports 51678-51680. Any host port that was previously specified in a running task is also reserved while the task is running. That is, after a task stops, the host port is released. The current reserved ports are displayed in the remainingResources of DescribeContainerInstances output. A container instance can have up to 100 reserved ports at a time. This number includes the default reserved ports. Automatically assigned ports aren't included in the 100 reserved ports quota.

  • name (String) The name that's used for the port mapping. This parameter only applies to Service Connect. This parameter is the name that you use in the serviceConnectConfiguration of a service. The name can include up to 64 characters. The characters can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.
  • protocol (String) The protocol used for the port mapping. Valid values are tcp and udp. The default is tcp. protocol is immutable in a Service Connect service. Updating this field requires a service deletion and redeployment.
  • Nested Schema for container_definitions.repository_credentials

    Read-Only:

    Nested Schema for container_definitions.resource_requirements

    Read-Only:

    Nested Schema for container_definitions.secrets

    Read-Only:

    Nested Schema for container_definitions.system_controls

    Read-Only:

    Nested Schema for container_definitions.ulimits

    Read-Only:

    Nested Schema for container_definitions.volumes_from

    Read-Only:

    Nested Schema for ephemeral_storage

    Read-Only:

    Nested Schema for inference_accelerators

    Read-Only:

    Nested Schema for placement_constraints

    Read-Only:

    Nested Schema for proxy_configuration

    Read-Only:

    Nested Schema for proxy_configuration.proxy_configuration_properties

    Read-Only:

    Nested Schema for runtime_platform

    Read-Only:

    Nested Schema for tags

    Read-Only:

    Nested Schema for volumes

    Read-Only:

    Nested Schema for volumes.docker_volume_configuration

    Read-Only:

    Nested Schema for volumes.efs_volume_configuration

    Read-Only:

    Nested Schema for volumes.efs_volume_configuration.authorization_config

    Read-Only:

    Nested Schema for volumes.fsx_windows_file_server_volume_configuration

    Read-Only:

    Nested Schema for volumes.fsx_windows_file_server_volume_configuration.authorization_config

    Read-Only:

    Nested Schema for volumes.host

    Read-Only: