Describe Scaling Activities

autoscaling_describe_scaling_activities

R Documentation

Gets information about the scaling activities in the account and Region

Description

Gets information about the scaling activities in the account and Region.

When scaling events occur, you see a record of the scaling activity in the scaling activities. For more information, see Verify a scaling activity for an Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.

If the scaling event succeeds, the value of the StatusCode element in the response is Successful. If an attempt to launch instances failed, the StatusCode value is Failed or Cancelled and the StatusMessage element in the response indicates the cause of the failure. For help interpreting the StatusMessage, see Troubleshooting Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.

Usage

autoscaling_describe_scaling_activities(ActivityIds,
  AutoScalingGroupName, IncludeDeletedGroups, MaxRecords, NextToken,
  Filters)

Arguments

ActivityIds	The activity IDs of the desired scaling activities. If unknown activity IDs are requested, they are ignored with no error. Only activities started within the last six weeks can be returned regardless of the activity IDs specified. If other filters are specified with the request, only results matching all filter criteria can be returned. Array Members: Maximum number of 50 IDs.
AutoScalingGroupName	The name of the Auto Scaling group. Omitting this property performs an account-wide operation, which can result in slower or timed-out requests.
IncludeDeletedGroups	Indicates whether to include scaling activity from deleted Auto Scaling groups.
MaxRecords	The maximum number of items to return with this call. The default value is 100 and the maximum value is 100.
NextToken	The token for the next set of items to return. (You received this token from a previous call.)
Filters	One or more filters to limit the results based on specific criteria. The following filters are supported: StartTimeLowerBound - The earliest scaling activities to return based on the activity start time. Scaling activities with a start time earlier than this value are not included in the results. Only activities started within the last six weeks can be returned regardless of the value specified. StartTimeUpperBound - The latest scaling activities to return based on the activity start time. Scaling activities with a start time later than this value are not included in the results. Only activities started within the last six weeks can be returned regardless of the value specified. Status - The StatusCode value of the scaling activity. This filter can only be used in combination with the AutoScalingGroupName parameter. For valid StatusCode values, see Activity in the Amazon EC2 Auto Scaling API Reference. StartTimeLowerBound and StartTimeUpperBound accept ISO 8601 formatted timestamps. Timestamps without a timezone offset are assumed to be UTC. ⁠2000-01-18T08:15:00Z⁠ ⁠2000-01-18T16:15:00+08:00⁠

Value

A list with the following syntax:

list(
  Activities = list(
    list(
      ActivityId = "string",
      AutoScalingGroupName = "string",
      Description = "string",
      Cause = "string",
      StartTime = as.POSIXct(
        "2015-01-01"
      ),
      EndTime = as.POSIXct(
        "2015-01-01"
      ),
      StatusCode = "PendingSpotBidPlacement"|"WaitingForSpotInstanceRequestId"|"WaitingForSpotInstanceId"|"WaitingForInstanceId"|"PreInService"|"InProgress"|"WaitingForELBConnectionDraining"|"MidLifecycleAction"|"WaitingForInstanceWarmup"|"Successful"|"Failed"|"Cancelled"|"WaitingForConnectionDraining"|"WaitingForInPlaceUpdateToStart"|"WaitingForInPlaceUpdateToFinalize"|"InPlaceUpdateInProgress",
      StatusMessage = "string",
      Progress = 123,
      Details = "string",
      AutoScalingGroupState = "string",
      AutoScalingGroupARN = "string"
    )
  ),
  NextToken = "string"
)

Request syntax

svc$describe_scaling_activities(
  ActivityIds = list(
    "string"
  ),
  AutoScalingGroupName = "string",
  IncludeDeletedGroups = TRUE|FALSE,
  MaxRecords = 123,
  NextToken = "string",
  Filters = list(
    list(
      Name = "string",
      Values = list(
        "string"
      )
    )
  )
)

Examples

## Not run: 
# This example describes the scaling activities for the specified Auto
# Scaling group.
svc$describe_scaling_activities(
  AutoScalingGroupName = "my-auto-scaling-group"
)

## End(Not run)