| Copyright | (c) 2013-2015 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | None |
| Language | Haskell2010 |
Network.AWS.ECS.CreateService
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.
- createService :: Text -> Text -> Int -> CreateService
- data CreateService
- cCluster :: Lens' CreateService (Maybe Text)
- cClientToken :: Lens' CreateService (Maybe Text)
- cLoadBalancers :: Lens' CreateService [LoadBalancer]
- cRole :: Lens' CreateService (Maybe Text)
- cServiceName :: Lens' CreateService Text
- cTaskDefinition :: Lens' CreateService Text
- cDesiredCount :: Lens' CreateService Int
- createServiceResponse :: Int -> CreateServiceResponse
- data CreateServiceResponse
- csrsService :: Lens' CreateServiceResponse (Maybe ContainerService)
- csrsResponseStatus :: Lens' CreateServiceResponse Int
Creating a Request
Arguments
| :: Text | |
| -> Text | |
| -> Int | |
| -> 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:
data CreateService Source
See: createService smart constructor.
Instances
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
Arguments
| :: Int | |
| -> 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:
data CreateServiceResponse Source
See: createServiceResponse smart constructor.
Response Lenses
csrsService :: Lens' CreateServiceResponse (Maybe ContainerService) Source
The full description of your service following the create call.
csrsResponseStatus :: Lens' CreateServiceResponse Int Source
The response status code.