IAmazonApplicationAutoScaling.DeregisterScalableTarget Method (DeregisterScalableTargetRequest)

Deregisters an Application Auto Scaling scalable target when you have finished using it. To see which resources have been registered, use DescribeScalableTargets.

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

Note:

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

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

Syntax

public abstract DeregisterScalableTargetResponse DeregisterScalableTarget(
         DeregisterScalableTargetRequest request
)

Parameters

request: Type: Amazon.ApplicationAutoScaling.Model.DeregisterScalableTargetRequest

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

Return Value

Type: DeregisterScalableTargetResponse

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

Exceptions

Exception	Condition
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.

Examples

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 client = new AmazonApplicationAutoScalingClient();
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

IAmazonApplicationAutoScaling.DeregisterScalableTarget (DeregisterScalableTargetRequest)

Method