amazonka-ecs-1.3.4: Amazon EC2 Container Service SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.ECS.CreateService

Contents

Description

Runs and maintains a desired number of tasks from a specified task definition. If the number of tasks running in a service drops below desiredCount, Amazon ECS spawns another instantiation of the task in the specified cluster.

See: AWS API Reference for CreateService.

Synopsis

Creating a Request

createService Source

Creates a value of CreateService with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

cCluster :: Lens' CreateService (Maybe Text) Source

The short name or full Amazon Resource Name (ARN) of the cluster on which to run your service. If you do not specify a cluster, the default cluster is assumed.

cClientToken :: Lens' CreateService (Maybe Text) Source

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. Up to 32 ASCII characters are allowed.

cLoadBalancers :: Lens' CreateService [LoadBalancer] Source

A list of load balancer objects, containing the load balancer name, the container name (as it appears in a container definition), and the container port to access from the load balancer.

cRole :: Lens' CreateService (Maybe Text) Source

The name or full Amazon Resource Name (ARN) of the IAM role that allows your Amazon ECS container agent to make calls to your load balancer on your behalf. This parameter is only required if you are using a load balancer with your service.

cServiceName :: Lens' CreateService Text Source

The name of your service. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. Service names must be unique within a cluster, but you can have similarly named services in multiple clusters within a region or across multiple regions.

cTaskDefinition :: Lens' CreateService Text Source

The family and revision ('family:revision') or full Amazon Resource Name (ARN) of the task definition to run in your service. If a revision is not specified, the latest ACTIVE revision is used.

cDesiredCount :: Lens' CreateService Int Source

The number of instantiations of the specified task definition to place and keep running on your cluster.

Destructuring the Response

createServiceResponse Source

Creates a value of CreateServiceResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

csrsService :: Lens' CreateServiceResponse (Maybe ContainerService) Source

The full description of your service following the create call.