AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
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 cannot use an
INACTIVE task definition to run new tasks or create
new services, and you cannot update an existing service to reference an
task definition (although 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, so you should
not rely on
INACTIVE task definitions persisting beyond the lifecycle
of any associated tasks and services.
For .NET Core and PCL this operation is only available in asynchronous form. Please refer to DeregisterTaskDefinitionAsync.
public virtual DeregisterTaskDefinitionResponse DeregisterTaskDefinition( DeregisterTaskDefinitionRequest request )
Container for the necessary parameters to execute the DeregisterTaskDefinition service method.
|ClientException||These errors are usually caused by a client action, such as using an action or resource on behalf of a user that doesn't have permissions to use the action or resource, or specifying an identifier that is not valid.|
|InvalidParameterException||The specified parameter is invalid. Review the available parameters for the API request.|
|ServerException||These errors are usually caused by a server issue.|
Supported in: 4.5, 4.0, 3.5
Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms