EC2 Instance

Resource Type

AWS.EC2.Instance

Resource ID Format

For EC2 Instances, the resource ID is the ARN.

arn:aws:ec2:us-west-2:123456789012:instance/i-1

Background

This resource represents a snapshot of an AWS EC2 Instance.

Fields

Field

Type

Description

AmiLaunchIndex

Integer

The AMI launch index.

Architecture

String

The architecture of the image.

BlockDeviceMappings

List

Any block device mapping entries for the instance.

CapacityReservationId

String

The ID of the Capacity Reservation.

CapacityReservationSpecification

Map

Information about the Capacity Reservation targeting option.

ClientToken

String

The provided token when the instance launched.

CpuOptions

Map

The CPU options for the instance.

EbsOptimized

Boolean

Whether the instance is optimized for Amazon EBS I/O.

ElasticGpuAssociations

List

The Elastic GPU associated with the instance.

ElasticInferenceAcceleratorAssociations

List

The elastic inference accelerator associated with the instance.

EnaSupport

Boolean

Whether enhanced networking with ENA is enabled.

HibernationOptions

Map

Whether the instance is enabled for Amazon Web Services Nitro Enclaves.

Hypervisor

String

The hypervisor type of the instance.

IamInstanceProfile

Map

The IAM instance profile associated with the instance.

ImageId

String

The ID of the AMI used to launch the instance.

InstanceLifecycle

String

Whether this is a Spot Instance or a Scheduled Instance.

InstanceType

String

The instance type.

KernelId

String

The kernel associated with this instance.

KeyName

String

The name of the key pair, if this instance was launched with an associated key pair.

Licenses

String

The license configurations for the instance.

MetadataOptions

List

The metadata options for the instance.

Monitoring

Map

The monitoring for the instance.

NetworkInterfaces

List

Placement

Map

The location where the instance launched, if applicable.

Platform

String

The instance operating system.

PrivateDnsName

String

The private DNS hostname name assigned to the instance.

PrivateIpAddress

String

The private IPv4 address assigned to the instance.

ProductCodes

List

The product codes attached to this instance.

PublicDnsName

String

The public DNS name assigned to the instance.

PublicIpAddress

String

The public IP address.

RamdiskId

String

The RAM disk associated with this instance.

RootDeviceName

String

The device name of the root device volume.

RootDeviceType

String

The root device type used by the AMI.

SecurityGroups

List

The security groups for the instance.

SourceDestCheck

Boolean

Whether source/destination checking is enabled.

SpotInstanceRequestId

String

The ID of the Spot Instance request.

SriovNetSupport

String

Whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

State

Map

The current state of the instance.

StateReason

Map

The reason for the most recent state transition.

StateTransitionReason

String

The reason for the most recent state transition.

SubnetId

String

The ID of the subnet in which the instance is running.

VirtualizationType

String

The virtualization type of the instance.

VpcId

String

The ID of the VPC in which the instance is running.

Example

{
    "AccountId": "123456789012",
    "AmiLaunchIndex": 0,
    "Architecture": "x86_64",
    "Arn": "arn:aws:ec2:us-west-2:123456789012:instance/i-1",
    "BlockDeviceMappings": [
        {
            "DeviceName": "/dev/xvda",
            "Ebs": {
                "AttachTime": "2019-01-01T00:00:00Z",
                "DeleteOnTermination": true,
                "Status": "attached",
                "VolumeId": "vol-1"
            }
        }
    ],
    "CapacityReservationId": null,
    "CapacityReservationSpecification": {
        "CapacityReservationPreference": "open",
        "CapacityReservationTarget": null
    },
    "ClientToken": null,
    "CpuOptions": {
        "CoreCount": 1,
        "ThreadsPerCore": 1
    },
    "EbsOptimized": false,
    "ElasticGpuAssociations": null,
    "ElasticInferenceAcceleratorAssociations": null,
    "EnaSupport": true,
    "HibernationOptions": {
        "Configured": false
    },
    "Hypervisor": "xen",
    "IamInstanceProfile": null,
    "Id": "i-1",
    "ImageId": "ami-1",
    "InstanceLifecycle": null,
    "InstanceType": "t2.micro",
    "KernelId": null,
    "KeyName": "ec2-instance-key-pair",
    "Licenses": null,
    "Monitoring": {
        "State": "disabled"
    },
    "NetworkInterfaces": [
        {
            "Association": {
                "IpOwnerId": "amazon",
                "PublicDnsName": "ec2-111-111-111-111.us-west-2.compute.amazonaws.com",
                "PublicIp": "111.111.111.111"
            },
            "Attachment": {
                "AttachTime": "2019-01-01T00:00:00Z",
                "AttachmentId": "eni-attach-1",
                "DeleteOnTermination": true,
                "DeviceIndex": 0,
                "Status": "attached"
            },
            "Description": null,
            "Groups": [
                {
                    "GroupId": "sg-1",
                    "GroupName": "launch-wizard-1"
                }
            ],
            "InterfaceType": "interface",
            "Ipv6Addresses": null,
            "MacAddress": "00:00:de:ad:be:ef",
            "NetworkInterfaceId": "eni-1",
            "OwnerId": "123456789012",
            "PrivateDnsName": "ip-10-10-10-10.us-west-2.compute.internal",
            "PrivateIpAddress": "10.10.10.10",
            "PrivateIpAddresses": [
                {
                    "Association": {
                        "IpOwnerId": "amazon",
                        "PublicDnsName": "ec2-111-111-111-111.us-west-2.compute.amazonaws.com",
                        "PublicIp": "111.111.111.111"
                    },
                    "Primary": true,
                    "PrivateDnsName": "ip-10-10-10-10.us-west-2.compute.internal",
                    "PrivateIpAddress": "10.10.10.10"
                }
            ],
            "SourceDestCheck": true,
            "Status": "in-use",
            "SubnetId": "subnet-1",
            "VpcId": "vpc-1"
        }
    ],
    "Placement": {
        "Affinity": null,
        "AvailabilityZone": "us-west-2b",
        "GroupName": null,
        "HostId": null,
        "PartitionNumber": null,
        "SpreadDomain": null,
        "Tenancy": "default"
    },
    "Platform": null,
    "PrivateDnsName": "ip-10-10-10-10.us-west-2.compute.internal",
    "PrivateIpAddress": "10.10.10.10",
    "ProductCodes": null,
    "PublicDnsName": "ec2-111-111-111-111.us-west-2.compute.amazonaws.com",
    "PublicIpAddress": "111.111.111.111",
    "RamdiskId": null,
    "Region": "us-west-2",
    "ResourceId": "arn:aws:ec2:us-west-2:123456789012:instance/i-1",
    "ResourceType": "AWS.EC2.Instance",
    "RootDeviceName": "/dev/xvda",
    "RootDeviceType": "ebs",
    "SecurityGroups": [
        {
            "GroupId": "sg-1",
            "GroupName": "launch-wizard-1"
        }
    ],
    "SourceDestCheck": true,
    "SpotInstanceRequestId": null,
    "SriovNetSupport": null,
    "State": {
        "Code": 16,
        "Name": "running"
    },
    "StateReason": null,
    "StateTransitionReason": null,
    "SubnetId": "subnet-1",
    "Tags": {
        "Key1": "Value1"
    },
    "TimeCreated": "2019-01-01T00:00:00.000Z",
    "VirtualizationType": "hvm",
    "VpcId": "vpc-1"
}

Last updated