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 life cycle
of any associated tasks and services.
For 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 permission 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
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms