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

Copyright(c) 2013-2016 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.DeleteService

Contents

Description

Deletes a specified service within a cluster. You can delete a service if you have no running tasks in it and the desired task count is zero. If the service is actively maintaining tasks, you cannot delete it, and you must update the service to a desired task count of zero. For more information, see UpdateService.

When you delete a service, if there are still running tasks that require cleanup, the service status moves from ACTIVE to DRAINING, and the service is no longer visible in the console or in ListServices API operations. After the tasks have stopped, then the service status moves from DRAINING to INACTIVE. Services in the DRAINING or INACTIVE status can still be viewed with DescribeServices API operations; however, in the future, INACTIVE services may be cleaned up and purged from Amazon ECS record keeping, and DescribeServices API operations on those services will return a ServiceNotFoundException error.

Synopsis

Creating a Request

deleteService Source

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

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

Request Lenses

dsCluster :: Lens' DeleteService (Maybe Text) Source

The name of the cluster that hosts the service to delete. If you do not specify a cluster, the default cluster is assumed.

dsService :: Lens' DeleteService Text Source

The name of the service to delete.

Destructuring the Response

deleteServiceResponse Source

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

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

Response Lenses

dsrsService :: Lens' DeleteServiceResponse (Maybe ContainerService) Source

The full description of the deleted service.