> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/cloud-scanning/cloud-resource-attributes/aws/ec2-instance.md).
# 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": {
"AssociatedResource": null,
"AttachTime": "2019-01-01T00:00:00Z",
"DeleteOnTermination": true,
"Operator": null,
"Status": "attached",
"VolumeId": "vol-1",
"VolumeOwnerId": null
}
}
],
"CapacityReservationId": null,
"CapacityReservationSpecification": {
"CapacityReservationPreference": "open",
"CapacityReservationTarget": null
},
"ClientToken": null,
"CpuOptions": {
"AmdSevSnp": null,
"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,
"MetadataOptions": {
"HttpEndpoint": "enabled",
"HttpProtocolIpv6": "disabled",
"HttpPutResponseHopLimit": 2,
"HttpTokens": "required",
"InstanceMetadataTags": "disabled",
"State": "applied"
},
"Monitoring": {
"State": "disabled"
},
"NetworkInterfaces": [
{
"Association": {
"CarrierIp": null,
"CustomerOwnedIp": null,
"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,
"EnaQueueCount": null,
"EnaSrdSpecification": null,
"NetworkCardIndex": 0,
"Status": "attached"
},
"ConnectionTrackingConfiguration": null,
"Description": null,
"Groups": [
{
"GroupId": "sg-1",
"GroupName": "launch-wizard-1"
}
],
"InterfaceType": "interface",
"Ipv4Prefixes": null,
"Ipv6Addresses": null,
"Ipv6Prefixes": null,
"MacAddress": "00:00:de:ad:be:ef",
"NetworkInterfaceId": "eni-1",
"Operator": {
"Managed": false,
"Principal": null
},
"OwnerId": "123456789012",
"PrivateDnsName": "ip-10-10-10-10.us-west-2.compute.internal",
"PrivateIpAddress": "10.10.10.10",
"PrivateIpAddresses": [
{
"Association": {
"CarrierIp": null,
"CustomerOwnedIp": null,
"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",
"AvailabilityZoneId": "usw2-az4",
"GroupId": null,
"GroupName": null,
"HostId": null,
"HostResourceGroupArn": 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"
}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.panther.com/cloud-scanning/cloud-resource-attributes/aws/ec2-instance.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.