Network.AWS.ECS.CreateService

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 will spawn another instantiation of the task in the specified cluster.

See: AWS API Reference for CreateService.

Creating a Request

createService

Arguments

:: Text

cServiceName

-> Text

cTaskDefinition

-> Int

cDesiredCount

-> CreateService

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:

• cCluster
• cClientToken
• cLoadBalancers
• cRole
• cServiceName
• cTaskDefinition
• cDesiredCount

data CreateService

See: createService smart constructor.

Instances

Eq CreateService

Data CreateService

Read CreateService

Show CreateService

Generic CreateService

ToJSON CreateService

AWSRequest CreateService

ToPath CreateService

ToHeaders CreateService

ToQuery CreateService

Typeable * CreateService

type Rep CreateService

type Rs CreateService = CreateServiceResponse

Request Lenses

cCluster :: Lens' CreateService (Maybe Text)

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

cClientToken :: Lens' CreateService (Maybe Text)

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

cLoadBalancers :: Lens' CreateService [LoadBalancer]

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)

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

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

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

cDesiredCount :: Lens' CreateService Int

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

Destructuring the Response

createServiceResponse

Arguments

:: Int

csrsResponseStatus

-> CreateServiceResponse

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:

• csrsService
• csrsResponseStatus

data CreateServiceResponse

See: createServiceResponse smart constructor.

Instances

Eq CreateServiceResponse

Data CreateServiceResponse

Read CreateServiceResponse

Show CreateServiceResponse

Generic CreateServiceResponse

Typeable * CreateServiceResponse

type Rep CreateServiceResponse

Response Lenses

csrsService :: Lens' CreateServiceResponse (Maybe ContainerService)

The full description of your service following the create call.

csrsResponseStatus :: Lens' CreateServiceResponse Int

The response status code.