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

Raw ↑
{
  "$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."
        }
      ]
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/ec2-auto-scaling-instance-refresh-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.