Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
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.
Synopsis
- data DeregisterTaskDefinition = DeregisterTaskDefinition' {}
- newDeregisterTaskDefinition :: Text -> DeregisterTaskDefinition
- deregisterTaskDefinition_taskDefinition :: Lens' DeregisterTaskDefinition Text
- data DeregisterTaskDefinitionResponse = DeregisterTaskDefinitionResponse' {}
- newDeregisterTaskDefinitionResponse :: Int -> DeregisterTaskDefinitionResponse
- deregisterTaskDefinitionResponse_taskDefinition :: Lens' DeregisterTaskDefinitionResponse (Maybe TaskDefinition)
- deregisterTaskDefinitionResponse_httpStatus :: Lens' DeregisterTaskDefinitionResponse Int
Creating a Request
data DeregisterTaskDefinition Source #
See: newDeregisterTaskDefinition
smart constructor.
DeregisterTaskDefinition' | |
|
Instances
newDeregisterTaskDefinition Source #
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 Source #
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 Source #
See: newDeregisterTaskDefinitionResponse
smart constructor.
DeregisterTaskDefinitionResponse' | |
|
Instances
Generic DeregisterTaskDefinitionResponse Source # | |
Read DeregisterTaskDefinitionResponse Source # | |
Show DeregisterTaskDefinitionResponse Source # | |
Defined in Amazonka.ECS.DeregisterTaskDefinition | |
NFData DeregisterTaskDefinitionResponse Source # | |
Defined in Amazonka.ECS.DeregisterTaskDefinition rnf :: DeregisterTaskDefinitionResponse -> () # | |
Eq DeregisterTaskDefinitionResponse Source # | |
type Rep DeregisterTaskDefinitionResponse Source # | |
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 Source #
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) Source #
The full description of the deregistered task.
deregisterTaskDefinitionResponse_httpStatus :: Lens' DeregisterTaskDefinitionResponse Int Source #
The response's http status code.