IAmazonAutoScaling.DescribeInstanceRefreshes Method (DescribeInstanceRefreshesRequest)

Gets information about the instance refreshes for the specified Auto Scaling group from the previous six weeks.

This operation is part of the instance refresh feature in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group after you make configuration changes.

To help you determine the status of an instance refresh, Amazon EC2 Auto Scaling returns information about the instance refreshes you previously initiated, including their status, start time, end time, the percentage of the instance refresh that is complete, and the number of instances remaining to update before the instance refresh is complete. If a rollback is initiated while an instance refresh is in progress, Amazon EC2 Auto Scaling also returns information about the rollback of the instance refresh.

Note:

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

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

Syntax

public abstract DescribeInstanceRefreshesResponse DescribeInstanceRefreshes(
         DescribeInstanceRefreshesRequest request
)

Parameters

request: Type: Amazon.AutoScaling.Model.DescribeInstanceRefreshesRequest

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

Return Value

Type: DescribeInstanceRefreshesResponse

The response from the DescribeInstanceRefreshes service method, as returned by AutoScaling.

Exceptions

Exception	Condition
InvalidNextTokenException	The NextToken value is not valid.
ResourceContentionException	You already have a pending update to an Amazon EC2 Auto Scaling resource (for example, an Auto Scaling group, instance, or load balancer).

Examples

This example describes the instance refreshes for the specified Auto Scaling group.

To list instance refreshes


var client = new AmazonAutoScalingClient();
var response = client.DescribeInstanceRefreshes(new DescribeInstanceRefreshesRequest 
{
    AutoScalingGroupName = "my-auto-scaling-group"
});

List<InstanceRefresh> instanceRefreshes = response.InstanceRefreshes;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonAutoScaling.DescribeInstanceRefreshes (DescribeInstanceRefreshesRequest)

Method