Regenerating amazonka-ecs from latest service definition

amazonka-ecs/gen/Network/AWS/ECS.hs

@@ -252,6 +252,7 @@ module Network.AWS.ECS
     , ciVersionInfo
     , ciAgentUpdateStatus
     , ciAttributes
+    , ciVersion
     , ciPendingTasksCount
     , ciRegisteredResources
 
@@ -387,6 +388,7 @@ module Network.AWS.ECS
     , tLastStatus
     , tContainers
     , tStartedAt
+    , tVersion
     , tStartedBy
     , tStoppedReason
     , tTaskDefinitionARN

amazonka-ecs/gen/Network/AWS/ECS/CreateService.hs

@@ -18,16 +18,16 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- 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. To update an existing service, see 'UpdateService' .
+-- 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 copy of the task in the specified cluster. To update an existing service, see 'UpdateService' .
 --
 --
 -- In addition to maintaining the desired count of tasks in your service, you can optionally run your service behind a load balancer. The load balancer distributes traffic across the tasks that are associated with the service. For more information, see <http://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html Service Load Balancing> in the /Amazon EC2 Container Service Developer Guide/ .
 --
--- You can optionally specify a deployment configuration for your service. During a deployment (which is triggered by changing the task definition of a service with an 'UpdateService' operation), the service scheduler uses the @minimumHealthyPercent@ and @maximumPercent@ parameters to determine the deployment strategy.
+-- You can optionally specify a deployment configuration for your service. During a deployment (which is triggered by changing the task definition or the desired count of a service with an 'UpdateService' operation), the service scheduler uses the @minimumHealthyPercent@ and @maximumPercent@ parameters to determine the deployment strategy.
 --
--- If the @minimumHealthyPercent@ is below 100%, the scheduler can ignore the @desiredCount@ temporarily during a deployment. For example, if your service has a @desiredCount@ of four tasks, a @minimumHealthyPercent@ of 50% allows the scheduler to stop two existing tasks before starting two new tasks. Tasks for services that /do not/ use a load balancer are considered healthy if they are in the @RUNNING@ state; tasks for services that /do/ use a load balancer are considered healthy if they are in the @RUNNING@ state and the container instance it is hosted on is reported as healthy by the load balancer. The default value for @minimumHealthyPercent@ is 50% in the console and 100% for the AWS CLI, the AWS SDKs, and the APIs.
+-- The @minimumHealthyPercent@ represents a lower limit on the number of your service's tasks that must remain in the @RUNNING@ state during a deployment, as a percentage of the @desiredCount@ (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if your service has a @desiredCount@ of four tasks and a @minimumHealthyPercent@ of 50%, the scheduler may stop two existing tasks to free up cluster capacity before starting two new tasks. Tasks for services that /do not/ use a load balancer are considered healthy if they are in the @RUNNING@ state; tasks for services that /do/ use a load balancer are considered healthy if they are in the @RUNNING@ state and the container instance it is hosted on is reported as healthy by the load balancer. The default value for @minimumHealthyPercent@ is 50% in the console and 100% for the AWS CLI, the AWS SDKs, and the APIs.
 --
--- The @maximumPercent@ parameter represents an upper limit on the number of running tasks during a deployment, which enables you to define the deployment batch size. For example, if your service has a @desiredCount@ of four tasks, a @maximumPercent@ value of 200% starts four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default value for @maximumPercent@ is 200%.
+-- The @maximumPercent@ parameter represents an upper limit on the number of your service's tasks that are allowed in the @RUNNING@ or @PENDING@ state during a deployment, as a percentage of the @desiredCount@ (rounded down to the nearest integer). This parameter enables you to define the deployment batch size. For example, if your service has a @desiredCount@ of four tasks and a @maximumPercent@ value of 200%, the scheduler may start four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default value for @maximumPercent@ is 200%.
 --
 -- When the service scheduler launches new tasks, it attempts to balance them across the Availability Zones in your cluster with the following logic:
 --

amazonka-ecs/gen/Network/AWS/ECS/DeregisterContainerInstance.hs

@@ -63,7 +63,7 @@ data DeregisterContainerInstance = DeregisterContainerInstance'
 --
 -- * 'derCluster' - The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instance to deregister. If you do not specify a cluster, the default cluster is assumed.
 --
--- * 'derForce' - Forces the deregistration of the container instance. If you have tasks running on the container instance when you deregister it with the @force@ option, these tasks remain running and they continue to pass Elastic Load Balancing load balancer health checks until you terminate the instance or the tasks stop through some other means, but they are orphaned (no longer monitored or accounted for by Amazon ECS). If an orphaned task on your container instance is part of an Amazon ECS service, then the service scheduler starts another copy of that task, on a different container instance if possible.
+-- * 'derForce' - Forces the deregistration of the container instance. If you have tasks running on the container instance when you deregister it with the @force@ option, these tasks remain running until you terminate the instance or the tasks stop through some other means, but they are orphaned (no longer monitored or accounted for by Amazon ECS). If an orphaned task on your container instance is part of an Amazon ECS service, then the service scheduler starts another copy of that task, on a different container instance if possible.  Any containers in orphaned service tasks that are registered with a Classic load balancer or an Application load balancer target group are deregistered, and they will begin connection draining according to the settings on the load balancer or target group.
 --
 -- * 'derContainerInstance' - The container instance ID or full Amazon Resource Name (ARN) of the container instance to deregister. The ARN contains the @arn:aws:ecs@ namespace, followed by the region of the container instance, the AWS account ID of the container instance owner, the @container-instance@ namespace, and then the container instance ID. For example, @arn:aws:ecs:/region/ :/aws_account_id/ :container-instance//container_instance_ID/ @ .
 deregisterContainerInstance
@@ -80,7 +80,7 @@ deregisterContainerInstance pContainerInstance_ =
 derCluster :: Lens' DeregisterContainerInstance (Maybe Text)
 derCluster = lens _derCluster (\ s a -> s{_derCluster = a});
 
--- | Forces the deregistration of the container instance. If you have tasks running on the container instance when you deregister it with the @force@ option, these tasks remain running and they continue to pass Elastic Load Balancing load balancer health checks until you terminate the instance or the tasks stop through some other means, but they are orphaned (no longer monitored or accounted for by Amazon ECS). If an orphaned task on your container instance is part of an Amazon ECS service, then the service scheduler starts another copy of that task, on a different container instance if possible.
+-- | Forces the deregistration of the container instance. If you have tasks running on the container instance when you deregister it with the @force@ option, these tasks remain running until you terminate the instance or the tasks stop through some other means, but they are orphaned (no longer monitored or accounted for by Amazon ECS). If an orphaned task on your container instance is part of an Amazon ECS service, then the service scheduler starts another copy of that task, on a different container instance if possible.  Any containers in orphaned service tasks that are registered with a Classic load balancer or an Application load balancer target group are deregistered, and they will begin connection draining according to the settings on the load balancer or target group.
 derForce :: Lens' DeregisterContainerInstance (Maybe Bool)
 derForce = lens _derForce (\ s a -> s{_derForce = a});
 
@@ -136,7 +136,7 @@ data DeregisterContainerInstanceResponse = DeregisterContainerInstanceResponse'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'dcirsContainerInstance' - Undocumented member.
+-- * 'dcirsContainerInstance' - The container instance that was deregistered.
 --
 -- * 'dcirsResponseStatus' - -- | The response status code.
 deregisterContainerInstanceResponse
@@ -148,7 +148,7 @@ deregisterContainerInstanceResponse pResponseStatus_ =
     , _dcirsResponseStatus = pResponseStatus_
     }
 
--- | Undocumented member.
+-- | The container instance that was deregistered.
 dcirsContainerInstance :: Lens' DeregisterContainerInstanceResponse (Maybe ContainerInstance)
 dcirsContainerInstance = lens _dcirsContainerInstance (\ s a -> s{_dcirsContainerInstance = a});
 

amazonka-ecs/gen/Network/AWS/ECS/DescribeServices.hs

@@ -58,7 +58,7 @@ data DescribeServices = DescribeServices'
 --
 -- * 'dCluster' - The name of the cluster that hosts the service to describe. If you do not specify a cluster, the default cluster is assumed.
 --
--- * 'dServices' - A list of services to describe.
+-- * 'dServices' - A list of services to describe. You may specify up to 10 services to describe in a single operation.
 describeServices
     :: DescribeServices
 describeServices =
@@ -71,7 +71,7 @@ describeServices =
 dCluster :: Lens' DescribeServices (Maybe Text)
 dCluster = lens _dCluster (\ s a -> s{_dCluster = a});
 
--- | A list of services to describe.
+-- | A list of services to describe. You may specify up to 10 services to describe in a single operation.
 dServices :: Lens' DescribeServices [Text]
 dServices = lens _dServices (\ s a -> s{_dServices = a}) . _Coerce;
 

amazonka-ecs/gen/Network/AWS/ECS/ListContainerInstances.hs

@@ -61,7 +61,7 @@ data ListContainerInstances = ListContainerInstances'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'lciCluster' - The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to list. If you do not specify a cluster, the default cluster is assumed..
+-- * 'lciCluster' - The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to list. If you do not specify a cluster, the default cluster is assumed.
 --
 -- * 'lciNextToken' - The @nextToken@ value returned from a previous paginated @ListContainerInstances@ request where @maxResults@ was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the @nextToken@ value. This value is @null@ when there are no more results to return.
 --
@@ -75,7 +75,7 @@ listContainerInstances =
     , _lciMaxResults = Nothing
     }
 
--- | The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to list. If you do not specify a cluster, the default cluster is assumed..
+-- | The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to list. If you do not specify a cluster, the default cluster is assumed.
 lciCluster :: Lens' ListContainerInstances (Maybe Text)
 lciCluster = lens _lciCluster (\ s a -> s{_lciCluster = a});
 

amazonka-ecs/gen/Network/AWS/ECS/ListServices.hs

@@ -61,7 +61,7 @@ data ListServices = ListServices'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'lsCluster' - The short name or full Amazon Resource Name (ARN) of the cluster that hosts the services to list. If you do not specify a cluster, the default cluster is assumed..
+-- * 'lsCluster' - The short name or full Amazon Resource Name (ARN) of the cluster that hosts the services to list. If you do not specify a cluster, the default cluster is assumed.
 --
 -- * 'lsNextToken' - The @nextToken@ value returned from a previous paginated @ListServices@ request where @maxResults@ was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the @nextToken@ value. This value is @null@ when there are no more results to return.
 --
@@ -75,7 +75,7 @@ listServices =
     , _lsMaxResults = Nothing
     }
 
--- | The short name or full Amazon Resource Name (ARN) of the cluster that hosts the services to list. If you do not specify a cluster, the default cluster is assumed..
+-- | The short name or full Amazon Resource Name (ARN) of the cluster that hosts the services to list. If you do not specify a cluster, the default cluster is assumed.
 lsCluster :: Lens' ListServices (Maybe Text)
 lsCluster = lens _lsCluster (\ s a -> s{_lsCluster = a});
 

amazonka-ecs/gen/Network/AWS/ECS/ListTasks.hs

@@ -75,7 +75,7 @@ data ListTasks = ListTasks'
 --
 -- * 'ltDesiredStatus' - The task desired status with which to filter the @ListTasks@ results. Specifying a @desiredStatus@ of @STOPPED@ limits the results to tasks that ECS has set the desired status to @STOPPED@ , which can be useful for debugging tasks that are not starting properly or have died or finished. The default status filter is @RUNNING@ , which shows tasks that ECS has set the desired status to @RUNNING@ .
 --
--- * 'ltCluster' - The short name or full Amazon Resource Name (ARN) of the cluster that hosts the tasks to list. If you do not specify a cluster, the default cluster is assumed..
+-- * 'ltCluster' - The short name or full Amazon Resource Name (ARN) of the cluster that hosts the tasks to list. If you do not specify a cluster, the default cluster is assumed.
 --
 -- * 'ltFamily' - The name of the family with which to filter the @ListTasks@ results. Specifying a @family@ limits the results to tasks that belong to that family.
 --
@@ -106,7 +106,7 @@ listTasks =
 ltDesiredStatus :: Lens' ListTasks (Maybe DesiredStatus)
 ltDesiredStatus = lens _ltDesiredStatus (\ s a -> s{_ltDesiredStatus = a});
 
--- | The short name or full Amazon Resource Name (ARN) of the cluster that hosts the tasks to list. If you do not specify a cluster, the default cluster is assumed..
+-- | The short name or full Amazon Resource Name (ARN) of the cluster that hosts the tasks to list. If you do not specify a cluster, the default cluster is assumed.
 ltCluster :: Lens' ListTasks (Maybe Text)
 ltCluster = lens _ltCluster (\ s a -> s{_ltCluster = a});
 

amazonka-ecs/gen/Network/AWS/ECS/RegisterContainerInstance.hs

@@ -67,7 +67,7 @@ data RegisterContainerInstance = RegisterContainerInstance'
 --
 -- * 'rciInstanceIdentityDocumentSignature' - The instance identity document signature for the EC2 instance to register. This signature can be found by running the following command from the instance: @curl http://169.254.169.254/latest/dynamic/instance-identity/signature/@
 --
--- * 'rciCluster' - The short name or full Amazon Resource Name (ARN) of the cluster with which to register your container instance. If you do not specify a cluster, the default cluster is assumed..
+-- * 'rciCluster' - The short name or full Amazon Resource Name (ARN) of the cluster with which to register your container instance. If you do not specify a cluster, the default cluster is assumed.
 --
 -- * 'rciInstanceIdentityDocument' - The instance identity document for the EC2 instance to register. This document can be found by running the following command from the instance: @curl http://169.254.169.254/latest/dynamic/instance-identity/document/@
 --
@@ -95,7 +95,7 @@ registerContainerInstance =
 rciInstanceIdentityDocumentSignature :: Lens' RegisterContainerInstance (Maybe Text)
 rciInstanceIdentityDocumentSignature = lens _rciInstanceIdentityDocumentSignature (\ s a -> s{_rciInstanceIdentityDocumentSignature = a});
 
--- | The short name or full Amazon Resource Name (ARN) of the cluster with which to register your container instance. If you do not specify a cluster, the default cluster is assumed..
+-- | The short name or full Amazon Resource Name (ARN) of the cluster with which to register your container instance. If you do not specify a cluster, the default cluster is assumed.
 rciCluster :: Lens' RegisterContainerInstance (Maybe Text)
 rciCluster = lens _rciCluster (\ s a -> s{_rciCluster = a});
 
@@ -174,7 +174,7 @@ data RegisterContainerInstanceResponse = RegisterContainerInstanceResponse'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'rcirsContainerInstance' - Undocumented member.
+-- * 'rcirsContainerInstance' - The container instance that was registered.
 --
 -- * 'rcirsResponseStatus' - -- | The response status code.
 registerContainerInstanceResponse
@@ -186,7 +186,7 @@ registerContainerInstanceResponse pResponseStatus_ =
     , _rcirsResponseStatus = pResponseStatus_
     }
 
--- | Undocumented member.
+-- | The container instance that was registered.
 rcirsContainerInstance :: Lens' RegisterContainerInstanceResponse (Maybe ContainerInstance)
 rcirsContainerInstance = lens _rcirsContainerInstance (\ s a -> s{_rcirsContainerInstance = a});
 

amazonka-ecs/gen/Network/AWS/ECS/RegisterTaskDefinition.hs

@@ -65,7 +65,7 @@ data RegisterTaskDefinition = RegisterTaskDefinition'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'rtdTaskRoleARN' - The Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role.
+-- * 'rtdTaskRoleARN' - The short name or full Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role. For more information, see <http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html IAM Roles for Tasks> in the /Amazon EC2 Container Service Developer Guide/ .
 --
 -- * 'rtdNetworkMode' - The Docker networking mode to use for the containers in the task. The valid values are @none@ , @bridge@ , and @host@ .  The default Docker network mode is @bridge@ . If the network mode is set to @none@ , you cannot specify port mappings in your container definitions, and the task's containers do not have external connectivity. The @host@ network mode offers the highest networking performance for containers because they use the host network stack instead of the virtualized network stack provided by the @bridge@ mode; however, exposed container ports are mapped directly to the corresponding host port, so you cannot take advantage of dynamic host port mappings or run multiple instantiations of the same task on a single container instance if port mappings are used. For more information, see <https://docs.docker.com/engine/reference/run/#network-settings Network settings> in the /Docker run reference/ .
 --
@@ -86,7 +86,7 @@ registerTaskDefinition pFamily_ =
     , _rtdContainerDefinitions = mempty
     }
 
--- | The Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role.
+-- | The short name or full Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role. For more information, see <http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html IAM Roles for Tasks> in the /Amazon EC2 Container Service Developer Guide/ .
 rtdTaskRoleARN :: Lens' RegisterTaskDefinition (Maybe Text)
 rtdTaskRoleARN = lens _rtdTaskRoleARN (\ s a -> s{_rtdTaskRoleARN = a});