Network.AWS.ECS.DeleteService

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.

Creating a Request

deleteService

Arguments

:: Text

dsService

-> DeleteService

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:

• dsCluster
• dsService

data DeleteService

See: deleteService smart constructor.

Instances

Eq DeleteService

Methods

(==) :: DeleteService -> DeleteService -> Bool

(/=) :: DeleteService -> DeleteService -> Bool

Data DeleteService

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DeleteService -> c DeleteService

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DeleteService

toConstr :: DeleteService -> Constr

dataTypeOf :: DeleteService -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DeleteService)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DeleteService)

gmapT :: (forall b. Data b => b -> b) -> DeleteService -> DeleteService

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DeleteService -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DeleteService -> r

gmapQ :: (forall d. Data d => d -> u) -> DeleteService -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> DeleteService -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DeleteService -> m DeleteService

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DeleteService -> m DeleteService

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DeleteService -> m DeleteService

Read DeleteService

Methods

readsPrec :: Int -> ReadS DeleteService

readList :: ReadS [DeleteService]

readPrec :: ReadPrec DeleteService

readListPrec :: ReadPrec [DeleteService]

Show DeleteService

Methods

showsPrec :: Int -> DeleteService -> ShowS

show :: DeleteService -> String

showList :: [DeleteService] -> ShowS

Generic DeleteService

Associated Types

type Rep DeleteService :: * -> *

Methods

from :: DeleteService -> Rep DeleteService x

to :: Rep DeleteService x -> DeleteService

Hashable DeleteService

Methods

hashWithSalt :: Int -> DeleteService -> Int

hash :: DeleteService -> Int

ToJSON DeleteService

Methods

toJSON :: DeleteService -> Value

toEncoding :: DeleteService -> Encoding

toJSONList :: [DeleteService] -> Value

toEncodingList :: [DeleteService] -> Encoding

NFData DeleteService

Methods

rnf :: DeleteService -> ()

AWSRequest DeleteService

Associated Types

type Rs DeleteService :: *

Methods

request :: DeleteService -> Request DeleteService

response :: MonadResource m => Logger -> Service -> Proxy * DeleteService -> ClientResponse -> m (Response DeleteService)

ToQuery DeleteService

Methods

toQuery :: DeleteService -> QueryString

ToPath DeleteService

Methods

toPath :: DeleteService -> ByteString

ToHeaders DeleteService

Methods

toHeaders :: DeleteService -> [Header]

type Rep DeleteService

type Rep DeleteService = D1 (MetaData "DeleteService" "Network.AWS.ECS.DeleteService" "amazonka-ecs-1.4.3-EI6LaLn2ihbBOjQBfPY85t" False) (C1 (MetaCons "DeleteService'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_dsCluster") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dsService") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))

type Rs DeleteService

type Rs DeleteService = DeleteServiceResponse

Request Lenses

dsCluster :: Lens' DeleteService (Maybe Text)

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

The name of the service to delete.

Destructuring the Response

deleteServiceResponse

Arguments

:: Int

dsrsResponseStatus

-> DeleteServiceResponse

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:

• dsrsService
• dsrsResponseStatus

data DeleteServiceResponse

See: deleteServiceResponse smart constructor.

Instances

Eq DeleteServiceResponse

Methods

(==) :: DeleteServiceResponse -> DeleteServiceResponse -> Bool

(/=) :: DeleteServiceResponse -> DeleteServiceResponse -> Bool

Data DeleteServiceResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DeleteServiceResponse -> c DeleteServiceResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DeleteServiceResponse

toConstr :: DeleteServiceResponse -> Constr

dataTypeOf :: DeleteServiceResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DeleteServiceResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DeleteServiceResponse)

gmapT :: (forall b. Data b => b -> b) -> DeleteServiceResponse -> DeleteServiceResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DeleteServiceResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DeleteServiceResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> DeleteServiceResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> DeleteServiceResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DeleteServiceResponse -> m DeleteServiceResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DeleteServiceResponse -> m DeleteServiceResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DeleteServiceResponse -> m DeleteServiceResponse

Read DeleteServiceResponse

Methods

readsPrec :: Int -> ReadS DeleteServiceResponse

readList :: ReadS [DeleteServiceResponse]

readPrec :: ReadPrec DeleteServiceResponse

readListPrec :: ReadPrec [DeleteServiceResponse]

Show DeleteServiceResponse

Methods

showsPrec :: Int -> DeleteServiceResponse -> ShowS

show :: DeleteServiceResponse -> String

showList :: [DeleteServiceResponse] -> ShowS

Generic DeleteServiceResponse

Associated Types

type Rep DeleteServiceResponse :: * -> *

Methods

from :: DeleteServiceResponse -> Rep DeleteServiceResponse x

to :: Rep DeleteServiceResponse x -> DeleteServiceResponse

NFData DeleteServiceResponse

Methods

rnf :: DeleteServiceResponse -> ()

type Rep DeleteServiceResponse

type Rep DeleteServiceResponse = D1 (MetaData "DeleteServiceResponse" "Network.AWS.ECS.DeleteService" "amazonka-ecs-1.4.3-EI6LaLn2ihbBOjQBfPY85t" False) (C1 (MetaCons "DeleteServiceResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_dsrsService") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ContainerService))) (S1 (MetaSel (Just Symbol "_dsrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

dsrsService :: Lens' DeleteServiceResponse (Maybe ContainerService)

The full description of the deleted service.

dsrsResponseStatus :: Lens' DeleteServiceResponse Int

The response status code.