Skip to content

/AWS1/CL_ECSSERVICECNCTSERVICE

The Service Connect service object configuration. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

CONSTRUCTOR

IMPORTING

Required arguments:

iv_portname TYPE /AWS1/ECSSTRING /AWS1/ECSSTRING

The portName must match the name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.

Optional arguments:

iv_discoveryname TYPE /AWS1/ECSSTRING /AWS1/ECSSTRING

The discoveryName is the name of the new Cloud Map service that Amazon ECS creates for this Amazon ECS service. This must be unique within the Cloud Map namespace. The name can contain up to 64 characters. The name can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.

If the discoveryName isn't specified, the port mapping name from the task definition is used in portName.namespace.

it_clientaliases TYPE /AWS1/CL_ECSSVCCNCTCLIENTALIAS=>TT_SERVICECNCTCLIENTALIASLIST TT_SERVICECNCTCLIENTALIASLIST

The list of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1.

Each alias ("endpoint") is a fully-qualified name and port number that other Amazon ECS tasks ("clients") can use to connect to this service.

Each name and port mapping must be unique within the namespace.

For each ServiceConnectService, you must provide at least one clientAlias with one port.

iv_ingressportoverride TYPE /AWS1/ECSPORTNUMBER /AWS1/ECSPORTNUMBER

The port number for the Service Connect proxy to listen on.

Use the value of this field to bypass the proxy for traffic on the port number specified in the named portMapping in the task definition of this application, and then use it in your VPC security groups to allow traffic into the proxy for this Amazon ECS service.

In awsvpc mode and Fargate, the default value is the container port number. The container port number is in the portMapping in the task definition. In bridge mode, the default value is the ephemeral port of the Service Connect proxy.

io_timeout TYPE REF TO /AWS1/CL_ECSTIMEOUTCONF /AWS1/CL_ECSTIMEOUTCONF

A reference to an object that represents the configured timeouts for Service Connect.

io_tls TYPE REF TO /AWS1/CL_ECSSERVICECNCTTLSCONF /AWS1/CL_ECSSERVICECNCTTLSCONF

A reference to an object that represents a Transport Layer Security (TLS) configuration.


Queryable Attributes

portName

The portName must match the name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.

Accessible with the following methods

Method Description
GET_PORTNAME() Getter for PORTNAME, with configurable default
ASK_PORTNAME() Getter for PORTNAME w/ exceptions if field has no value
HAS_PORTNAME() Determine if PORTNAME has a value

discoveryName

The discoveryName is the name of the new Cloud Map service that Amazon ECS creates for this Amazon ECS service. This must be unique within the Cloud Map namespace. The name can contain up to 64 characters. The name can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.

If the discoveryName isn't specified, the port mapping name from the task definition is used in portName.namespace.

Accessible with the following methods

Method Description
GET_DISCOVERYNAME() Getter for DISCOVERYNAME, with configurable default
ASK_DISCOVERYNAME() Getter for DISCOVERYNAME w/ exceptions if field has no value
HAS_DISCOVERYNAME() Determine if DISCOVERYNAME has a value

clientAliases

The list of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1.

Each alias ("endpoint") is a fully-qualified name and port number that other Amazon ECS tasks ("clients") can use to connect to this service.

Each name and port mapping must be unique within the namespace.

For each ServiceConnectService, you must provide at least one clientAlias with one port.

Accessible with the following methods

Method Description
GET_CLIENTALIASES() Getter for CLIENTALIASES, with configurable default
ASK_CLIENTALIASES() Getter for CLIENTALIASES w/ exceptions if field has no value
HAS_CLIENTALIASES() Determine if CLIENTALIASES has a value

ingressPortOverride

The port number for the Service Connect proxy to listen on.

Use the value of this field to bypass the proxy for traffic on the port number specified in the named portMapping in the task definition of this application, and then use it in your VPC security groups to allow traffic into the proxy for this Amazon ECS service.

In awsvpc mode and Fargate, the default value is the container port number. The container port number is in the portMapping in the task definition. In bridge mode, the default value is the ephemeral port of the Service Connect proxy.

Accessible with the following methods

Method Description
GET_INGRESSPORTOVERRIDE() Getter for INGRESSPORTOVERRIDE, with configurable default
ASK_INGRESSPORTOVERRIDE() Getter for INGRESSPORTOVERRIDE w/ exceptions if field has no
HAS_INGRESSPORTOVERRIDE() Determine if INGRESSPORTOVERRIDE has a value

timeout

A reference to an object that represents the configured timeouts for Service Connect.

Accessible with the following methods

Method Description
GET_TIMEOUT() Getter for TIMEOUT

tls

A reference to an object that represents a Transport Layer Security (TLS) configuration.

Accessible with the following methods

Method Description
GET_TLS() Getter for TLS

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT_SERVICECONNECTSERVICELIST

TYPES TT_SERVICECONNECTSERVICELIST TYPE STANDARD TABLE OF REF TO /AWS1/CL_ECSSERVICECNCTSERVICE WITH DEFAULT KEY
.