Amazon EC2 · Schema

Instance

Describes an EC2 instance

Cloud ComputingComputeInfrastructure-as-a-ServiceInfrastructureVirtual Machines

Properties

Name Type Description
instanceId string The ID of the instance
imageId string The ID of the AMI used to launch the instance
instanceType string The instance type
keyName string The name of the key pair
launchTime string The time the instance was launched
placement object The location where the instance launched
monitoring object The monitoring for the instance
instanceState object The current state of the instance
subnetId string The ID of the subnet in which the instance is running
vpcId string The ID of the VPC in which the instance is running
privateIpAddress string The private IPv4 address assigned to the instance
publicIpAddress string The public IPv4 address assigned to the instance
architecture string The architecture of the image
rootDeviceType string The root device type used by the AMI
tags array Any tags assigned to the instance
securityGroups array The security groups for the instance
View JSON Schema on GitHub

JSON Schema

ec2-openapi-instance-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-ec2/refs/heads/main/json-schema/ec2-openapi-instance-schema.json",
  "title": "Instance",
  "description": "Describes an EC2 instance",
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string",
      "description": "The ID of the instance"
    },
    "imageId": {
      "type": "string",
      "description": "The ID of the AMI used to launch the instance"
    },
    "instanceType": {
      "type": "string",
      "description": "The instance type"
    },
    "keyName": {
      "type": "string",
      "description": "The name of the key pair"
    },
    "launchTime": {
      "type": "string",
      "format": "date-time",
      "description": "The time the instance was launched"
    },
    "placement": {
      "type": "object",
      "description": "The location where the instance launched",
      "properties": {
        "availabilityZone": {
          "type": "string",
          "description": "The Availability Zone of the instance"
        }
      }
    },
    "monitoring": {
      "type": "object",
      "description": "The monitoring for the instance",
      "properties": {
        "state": {
          "type": "string",
          "description": "The monitoring state",
          "enum": [
            "disabled",
            "disabling",
            "enabled",
            "pending"
          ]
        }
      }
    },
    "instanceState": {
      "type": "object",
      "description": "The current state of the instance",
      "properties": {
        "code": {
          "type": "integer",
          "description": "The state code (0=pending, 16=running, 32=shutting-down, 48=terminated, 64=stopping, 80=stopped)"
        },
        "name": {
          "type": "string",
          "description": "The current state of the instance",
          "enum": [
            "pending",
            "running",
            "shutting-down",
            "terminated",
            "stopping",
            "stopped"
          ]
        }
      }
    },
    "subnetId": {
      "type": "string",
      "description": "The ID of the subnet in which the instance is running"
    },
    "vpcId": {
      "type": "string",
      "description": "The ID of the VPC in which the instance is running"
    },
    "privateIpAddress": {
      "type": "string",
      "description": "The private IPv4 address assigned to the instance"
    },
    "publicIpAddress": {
      "type": "string",
      "description": "The public IPv4 address assigned to the instance"
    },
    "architecture": {
      "type": "string",
      "description": "The architecture of the image",
      "enum": [
        "i386",
        "x86_64",
        "arm64"
      ]
    },
    "rootDeviceType": {
      "type": "string",
      "description": "The root device type used by the AMI",
      "enum": [
        "ebs",
        "instance-store"
      ]
    },
    "tags": {
      "type": "array",
      "description": "Any tags assigned to the instance",
      "items": {
        "$ref": "#/components/schemas/Tag"
      }
    },
    "securityGroups": {
      "type": "array",
      "description": "The security groups for the instance",
      "items": {
        "type": "object",
        "properties": {
          "groupId": {
            "type": "string",
            "description": "The ID of the security group"
          },
          "groupName": {
            "type": "string",
            "description": "The name of the security group"
          }
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema 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 Schema
curl "https://apis.io/api/v1/json-schemas/ec2-openapi-instance"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.