Amazon EC2 Auto Scaling · JSON Structure
Ec2 Auto Scaling Instance Refresh Structure
Describes an instance refresh for an Auto Scaling group.
Type: object
Properties: 12
Amazon Web ServicesAuto ScalingComputeEC2High AvailabilityScaling
InstanceRefresh is a JSON Structure definition published by Amazon EC2 Auto Scaling, describing 12 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
InstanceRefreshId
AutoScalingGroupName
Status
StatusReason
StartTime
EndTime
PercentageComplete
InstancesToUpdate
ProgressDetails
Preferences
DesiredConfiguration
RollbackDetails
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/amazon-ec2-auto-scaling/refs/heads/main/json-structure/ec2-auto-scaling-instance-refresh-structure.json",
"name": "InstanceRefresh",
"description": "Describes an instance refresh for an Auto Scaling group. ",
"type": "object",
"properties": {
"InstanceRefreshId": {
"allOf": [
{
"$ref": "#/components/schemas/XmlStringMaxLen255"
},
{
"description": "The instance refresh ID."
}
]
},
"AutoScalingGroupName": {
"allOf": [
{
"$ref": "#/components/schemas/XmlStringMaxLen255"
},
{
"description": "The name of the Auto Scaling group."
}
]
},
"Status": {
"allOf": [
{
"$ref": "#/components/schemas/InstanceRefreshStatus"
},
{
"description": "<p>The current status for the instance refresh operation:</p> <ul> <li> <p> <code>Pending</code> - The request was created, but the instance refresh has not started.</p> </li> <li> <p> <code>InProgress</code> - An instance refresh is in progress.</p> </li> <li> <p> <code>Successful</code> - An instance refresh completed successfully.</p> </li> <li> <p> <code>Failed</code> - An instance refresh failed to complete. You can troubleshoot using the status reason and the scaling activities. </p> </li> <li> <p> <code>Cancelling</code> - An ongoing instance refresh is being cancelled.</p> </li> <li> <p> <code>Cancelled</code> - The instance refresh is cancelled. </p> </li> <li> <p> <code>RollbackInProgress</code> - An instance refresh is being rolled back.</p> </li> <li> <p> <code>RollbackFailed</code> - The rollback failed to complete. You can troubleshoot using the status reason and the scaling activities.</p> </li> <li> <p> <code>RollbackSuccessful</code> - The rollback completed successfully.</p> </li> </ul>"
}
]
},
"StatusReason": {
"allOf": [
{
"$ref": "#/components/schemas/XmlStringMaxLen1023"
},
{
"description": "The explanation for the specific status assigned to this operation."
}
]
},
"StartTime": {
"allOf": [
{
"$ref": "#/components/schemas/TimestampType"
},
{
"description": "The date and time at which the instance refresh began."
}
]
},
"EndTime": {
"allOf": [
{
"$ref": "#/components/schemas/TimestampType"
},
{
"description": "The date and time at which the instance refresh ended."
}
]
},
"PercentageComplete": {
"allOf": [
{
"$ref": "#/components/schemas/IntPercent"
},
{
"description": "<p>The percentage of the instance refresh that is complete. For each instance replacement, Amazon EC2 Auto Scaling tracks the instance's health status and warm-up time. When the instance's health status changes to healthy and the specified warm-up time passes, the instance is considered updated and is added to the percentage complete.</p> <note> <p> <code>PercentageComplete</code> does not include instances that are replaced during a rollback. This value gradually goes back down to zero during a rollback.</p> </note>"
}
]
},
"InstancesToUpdate": {
"allOf": [
{
"$ref": "#/components/schemas/InstancesToUpdate"
},
{
"description": "<p>The number of instances remaining to update before the instance refresh is complete.</p> <note> <p>If you roll back the instance refresh, <code>InstancesToUpdate</code> shows you the number of instances that were not yet updated by the instance refresh. Therefore, these instances don't need to be replaced as part of the rollback.</p> </note>"
}
]
},
"ProgressDetails": {
"allOf": [
{
"$ref": "#/components/schemas/InstanceRefreshProgressDetails"
},
{
"description": "Additional progress details for an Auto Scaling group that has a warm pool."
}
]
},
"Preferences": {
"allOf": [
{
"$ref": "#/components/schemas/RefreshPreferences"
},
{
"description": "The preferences for an instance refresh."
}
]
},
"DesiredConfiguration": {
"allOf": [
{
"$ref": "#/components/schemas/DesiredConfiguration"
},
{
"description": "Describes the desired configuration for the instance refresh."
}
]
},
"RollbackDetails": {
"allOf": [
{
"$ref": "#/components/schemas/RollbackDetails"
},
{
"description": "The rollback details."
}
]
}
}
}