Amazonka.ECS.DeregisterTaskDefinition

Deregisters the specified task definition by family and revision. Upon deregistration, the task definition is marked as INACTIVE. Existing tasks and services that reference an INACTIVE task definition continue to run without disruption. Existing services that reference an INACTIVE task definition can still scale up or down by modifying the service's desired count.

You can't use an INACTIVE task definition to run new tasks or create new services, and you can't update an existing service to reference an INACTIVE task definition. However, there may be up to a 10-minute window following deregistration where these restrictions have not yet taken effect.

At this time, INACTIVE task definitions remain discoverable in your account indefinitely. However, this behavior is subject to change in the future. We don't recommend that you rely on INACTIVE task definitions persisting beyond the lifecycle of any associated tasks and services.

Creating a Request

data DeregisterTaskDefinition

See: newDeregisterTaskDefinition smart constructor.

Constructors

DeregisterTaskDefinition'

Fields

• taskDefinition :: Text

  The family and revision (family:revision) or full Amazon Resource Name (ARN) of the task definition to deregister. You must specify a revision.

Instances

ToJSON DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

toJSON :: DeregisterTaskDefinition -> Value

toEncoding :: DeregisterTaskDefinition -> Encoding

toJSONList :: [DeregisterTaskDefinition] -> Value

toEncodingList :: [DeregisterTaskDefinition] -> Encoding

ToHeaders DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

toHeaders :: DeregisterTaskDefinition -> [Header]

ToPath DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

toPath :: DeregisterTaskDefinition -> ByteString

ToQuery DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

toQuery :: DeregisterTaskDefinition -> QueryString

AWSRequest DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Associated Types

type AWSResponse DeregisterTaskDefinition

Methods

request :: (Service -> Service) -> DeregisterTaskDefinition -> Request DeregisterTaskDefinition

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy DeregisterTaskDefinition -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DeregisterTaskDefinition)))

Generic DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Associated Types

type Rep DeregisterTaskDefinition :: Type -> Type

Methods

from :: DeregisterTaskDefinition -> Rep DeregisterTaskDefinition x

to :: Rep DeregisterTaskDefinition x -> DeregisterTaskDefinition

Read DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

readsPrec :: Int -> ReadS DeregisterTaskDefinition

readList :: ReadS [DeregisterTaskDefinition]

readPrec :: ReadPrec DeregisterTaskDefinition

readListPrec :: ReadPrec [DeregisterTaskDefinition]

Show DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

showsPrec :: Int -> DeregisterTaskDefinition -> ShowS

show :: DeregisterTaskDefinition -> String

showList :: [DeregisterTaskDefinition] -> ShowS

NFData DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

rnf :: DeregisterTaskDefinition -> ()

Eq DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

(==) :: DeregisterTaskDefinition -> DeregisterTaskDefinition -> Bool

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

Hashable DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

hashWithSalt :: Int -> DeregisterTaskDefinition -> Int

hash :: DeregisterTaskDefinition -> Int

type AWSResponse DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

type AWSResponse DeregisterTaskDefinition = DeregisterTaskDefinitionResponse

type Rep DeregisterTaskDefinition

Defined in Amazonka.ECS.DeregisterTaskDefinition

type Rep DeregisterTaskDefinition = D1 ('MetaData "DeregisterTaskDefinition" "Amazonka.ECS.DeregisterTaskDefinition" "amazonka-ecs-2.0-3xFxVqi9x5nBZ44jBEC5G8" 'False) (C1 ('MetaCons "DeregisterTaskDefinition'" 'PrefixI 'True) (S1 ('MetaSel ('Just "taskDefinition") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))

newDeregisterTaskDefinition

Arguments

:: Text

DeregisterTaskDefinition

-> DeregisterTaskDefinition

Create a value of DeregisterTaskDefinition with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

DeregisterTaskDefinition, deregisterTaskDefinition_taskDefinition - The family and revision (family:revision) or full Amazon Resource Name (ARN) of the task definition to deregister. You must specify a revision.

Request Lenses

deregisterTaskDefinition_taskDefinition :: Lens' DeregisterTaskDefinition Text

The family and revision (family:revision) or full Amazon Resource Name (ARN) of the task definition to deregister. You must specify a revision.

Destructuring the Response

data DeregisterTaskDefinitionResponse

See: newDeregisterTaskDefinitionResponse smart constructor.

Constructors

DeregisterTaskDefinitionResponse'

Fields

• taskDefinition :: Maybe TaskDefinition

  The full description of the deregistered task.

• httpStatus :: Int

  The response's http status code.

Instances

Generic DeregisterTaskDefinitionResponse

Defined in Amazonka.ECS.DeregisterTaskDefinition

Associated Types

type Rep DeregisterTaskDefinitionResponse :: Type -> Type

Methods

from :: DeregisterTaskDefinitionResponse -> Rep DeregisterTaskDefinitionResponse x

to :: Rep DeregisterTaskDefinitionResponse x -> DeregisterTaskDefinitionResponse

Read DeregisterTaskDefinitionResponse

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

readsPrec :: Int -> ReadS DeregisterTaskDefinitionResponse

readList :: ReadS [DeregisterTaskDefinitionResponse]

readPrec :: ReadPrec DeregisterTaskDefinitionResponse

readListPrec :: ReadPrec [DeregisterTaskDefinitionResponse]

Show DeregisterTaskDefinitionResponse

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

showsPrec :: Int -> DeregisterTaskDefinitionResponse -> ShowS

show :: DeregisterTaskDefinitionResponse -> String

showList :: [DeregisterTaskDefinitionResponse] -> ShowS

NFData DeregisterTaskDefinitionResponse

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

rnf :: DeregisterTaskDefinitionResponse -> ()

Eq DeregisterTaskDefinitionResponse

Defined in Amazonka.ECS.DeregisterTaskDefinition

Methods

(==) :: DeregisterTaskDefinitionResponse -> DeregisterTaskDefinitionResponse -> Bool

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

type Rep DeregisterTaskDefinitionResponse

Defined in Amazonka.ECS.DeregisterTaskDefinition

type Rep DeregisterTaskDefinitionResponse = D1 ('MetaData "DeregisterTaskDefinitionResponse" "Amazonka.ECS.DeregisterTaskDefinition" "amazonka-ecs-2.0-3xFxVqi9x5nBZ44jBEC5G8" 'False) (C1 ('MetaCons "DeregisterTaskDefinitionResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "taskDefinition") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe TaskDefinition)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newDeregisterTaskDefinitionResponse

Arguments

:: Int

$sel:httpStatus:DeregisterTaskDefinitionResponse'

-> DeregisterTaskDefinitionResponse

Create a value of DeregisterTaskDefinitionResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

DeregisterTaskDefinition, deregisterTaskDefinitionResponse_taskDefinition - The full description of the deregistered task.

$sel:httpStatus:DeregisterTaskDefinitionResponse', deregisterTaskDefinitionResponse_httpStatus - The response's http status code.

Response Lenses

deregisterTaskDefinitionResponse_taskDefinition :: Lens' DeregisterTaskDefinitionResponse (Maybe TaskDefinition)

The full description of the deregistered task.

deregisterTaskDefinitionResponse_httpStatus :: Lens' DeregisterTaskDefinitionResponse Int

The response's http status code.