AWS::ECS::ExpressGatewayService - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.

AWS::ECS::ExpressGatewayService

Creates an Express service that simplifies deploying containerized web applications on Amazon ECS with managed Amazon infrastructure. This operation provisions and configures Application Load Balancers, target groups, security groups, and auto-scaling policies automatically.

Specify a primary container configuration with your application image and basic settings. Amazon ECS creates the necessary Amazon resources for traffic distribution, health monitoring, network access control, and capacity management.

Provide an execution role for task operations and an infrastructure role for managing Amazon resources on your behalf.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::ECS::ExpressGatewayService",
  "Properties" : {
      "Cluster" : String,
      "Cpu" : String,
      "ExecutionRoleArn" : String,
      "HealthCheckPath" : String,
      "InfrastructureRoleArn" : String,
      "Memory" : String,
      "NetworkConfiguration" : ExpressGatewayServiceNetworkConfiguration,
      "PrimaryContainer" : ExpressGatewayContainer,
      "ScalingTarget" : ExpressGatewayScalingTarget,
      "ServiceName" : String,
      "Tags" : [ Tag, ... ],
      "TaskRoleArn" : String
    }
}

Properties

Cluster

The short name or full ARN of the cluster that hosts the Express service.

Required: No

Type: String

Update requires: Replacement

Cpu

The CPU allocation for tasks in this service revision.

Required: No

Type: String

Update requires: No interruption

ExecutionRoleArn

The ARN of the task execution role for the service revision.

Required: Yes

Type: String

Update requires: No interruption

HealthCheckPath

The health check path for this service revision.

Required: No

Type: String

Update requires: No interruption

InfrastructureRoleArn

The ARN of the infrastructure role that manages Amazon resources for the Express service.

Required: Yes

Type: String

Update requires: Replacement

Memory

The memory allocation for tasks in this service revision.

Required: No

Type: String

Update requires: No interruption

NetworkConfiguration

The network configuration for tasks in this service revision.

Required: No

Type: ExpressGatewayServiceNetworkConfiguration

Update requires: No interruption

PrimaryContainer

The primary container configuration for this service revision.

Required: Yes

Type: ExpressGatewayContainer

Update requires: No interruption

ScalingTarget

The auto-scaling configuration for this service revision.

Required: No

Type: ExpressGatewayScalingTarget

Update requires: Replacement

ServiceName

The name of the Express service.

Required: No

Type: String

Update requires: Replacement

Tags

The metadata applied to the Express service.

Required: No

Type: Array of Tag

Minimum: 0

Maximum: 50

Update requires: Replacement

TaskRoleArn

The ARN of the task role for the service revision.

Required: No

Type: String

Update requires: No interruption

Return values

Ref

Fn::GetAtt

ActiveConfigurations

The list of active service configurations for the Express service.

CreatedAt

The Unix timestamp for when the Express service was created.

ECSManagedResourceArns.AutoScaling.ApplicationAutoScalingPolicies

Property description not available.

ECSManagedResourceArns.AutoScaling.ScalableTarget

Property description not available.

ECSManagedResourceArns.IngressPath.CertificateArn

Property description not available.

ECSManagedResourceArns.IngressPath.ListenerArn

Property description not available.

ECSManagedResourceArns.IngressPath.ListenerRuleArn

Property description not available.

ECSManagedResourceArns.IngressPath.LoadBalancerArn

Property description not available.

ECSManagedResourceArns.IngressPath.LoadBalancerSecurityGroups

Property description not available.

ECSManagedResourceArns.IngressPath.TargetGroupArns

Property description not available.

ECSManagedResourceArns.LogGroups

Property description not available.

ECSManagedResourceArns.MetricAlarms

Property description not available.

ECSManagedResourceArns.ServiceSecurityGroups

Property description not available.

Endpoint

Property description not available.

ServiceArn

The ARN that identifies the Express service.

UpdatedAt

The Unix timestamp for when the Express service was last updated.