AWS SDK Version 3 for .NET
API Reference

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 a scalable target.

Deregistering a scalable target deletes the scaling policies that are associated with it.

To create a scalable target or update an existing one, see RegisterScalableTarget.


For .NET Core and PCL this operation is only available in asynchronous form. Please refer to DeregisterScalableTargetAsync.

Namespace: Amazon.ApplicationAutoScaling
Assembly: AWSSDK.ApplicationAutoScaling.dll
Version: 3.x.y.z


public virtual DeregisterScalableTargetResponse DeregisterScalableTarget(
         DeregisterScalableTargetRequest request
Type: Amazon.ApplicationAutoScaling.Model.DeregisterScalableTargetRequest

Container for the necessary parameters to execute the DeregisterScalableTarget service method.

Return Value
The response from the DeregisterScalableTarget service method, as returned by ApplicationAutoScaling.


ConcurrentUpdateException Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.
InternalServiceException The service encountered an internal error.
ObjectNotFoundException The specified object could not be found. For any operation that depends on the existence of a scalable target, this exception is thrown if the scalable target with the specified service namespace, resource ID, and scalable dimension does not exist. For any operation that deletes or deregisters a resource, this exception is thrown if the resource cannot be found.
ValidationException An exception was thrown for a validation issue. Review the available parameters for the API request.


This example deregisters a scalable target for an Amazon ECS service called web-app that is running in the default cluster.

To deregister a scalable target

var response = client.DeregisterScalableTarget(new DeregisterScalableTargetRequest 
    ResourceId = "service/default/web-app",
    ScalableDimension = "ecs:service:DesiredCount",
    ServiceNamespace = "ecs"


Version Information

.NET Framework:
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

See Also