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.
Deletes one or more task definitions.
You must deregister a task definition revision before you delete it. For more information, see DeregisterTaskDefinition.
When you delete a task definition revision, it is immediately transitions from the
INACTIVE to DELETE_IN_PROGRESS. Existing tasks and services that reference
a DELETE_IN_PROGRESS task definition revision continue to run without disruption.
Existing services that reference a DELETE_IN_PROGRESS task definition revision
can still scale up or down by modifying the service's desired count.
You can't use a DELETE_IN_PROGRESS task definition revision to run new tasks
or create new services. You also can't update an existing service to reference a DELETE_IN_PROGRESS
task definition revision.
A task definition revision will stay in DELETE_IN_PROGRESS status until all
the associated tasks and services have been terminated.
When you delete all INACTIVE task definition revisions, the task definition
name is not displayed in the console and not returned in the API. If a task definition
revisions are in the DELETE_IN_PROGRESS state, the task definition name is
displayed in the console and returned in the API. The task definition name is retained
by Amazon ECS and the revision is incremented the next time you create a task definition
with that name.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginDeleteTaskDefinitions and EndDeleteTaskDefinitions.
Namespace: Amazon.ECS
Assembly: AWSSDK.ECS.dll
Version: 3.x.y.z
public virtual Task<DeleteTaskDefinitionsResponse> DeleteTaskDefinitionsAsync( DeleteTaskDefinitionsRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the DeleteTaskDefinitions service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| AccessDeniedException | You don't have authorization to perform the requested action. |
| ClientException | These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid. |
| InvalidParameterException | The specified parameter isn't valid. Review the available parameters for the API request. For more information about service event errors, see Amazon ECS service event messages. |
| ServerException | These errors are usually caused by a server issue. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer