AWS IMDS - What is Link-Local IP address

In the world of networking, IP addresses are crucial for devices to communicate with each other over the Internet. However, not all IP addresses are created equal, and some serve unique purposes. One such IP address is, which is commonly referred to as a link-local address.

In this article, we'll delve into the concept of link-local IP addresses, explore what means, and discuss its practical uses.

aws imds

Link-Local IP Addresses:

Link-local IP addresses are a special class of addresses designed for communication within a single network segment or link. They are not globally routable, meaning they can only be used for local communication on the same network. One of the most well-known link-local IP addresses is What Does It Signify?

The IP address holds a unique significance in the context of cloud computing and virtualization. It is often associated with cloud service providers and is used for various purposes, primarily for obtaining metadata and configuration information about virtual instances or servers.

Uses of

  1. Metadata Service:
    • Cloud service providers, such as Amazon Web Services (AWS), Google Cloud Platform (GCP), and Microsoft Azure, use to provide metadata services to virtual instances.
    • Virtual instances can send HTTP requests to this IP address to retrieve essential information about themselves and their environment. This metadata includes instance ID, public IP address, security group details, and more.
    • For example, in AWS, you can make a request to to access this information.
  2. Instance Configuration:
    • Virtual instances can also use this address to retrieve configuration data. For instance, they can obtain user data scripts, which are often used for customizing an instance during launch.
    • This allows for dynamic configuration based on user requirements, making it a valuable tool for system administrators and DevOps teams.
  3. Bootstrapping and Service Discovery:
    • Cloud instances can use during their startup process to discover and connect to other services in the same network. It simplifies the configuration process and promotes self-discovery among components.
  4. Network Troubleshooting:
    • When working with virtual instances in the cloud, debugging network issues can be challenging. Accessing the metadata and diagnostic information through can aid in identifying and resolving connectivity problems.
  5. Security and Authentication:
    • Link-local addresses like are often used in the context of security groups and firewalls to control and secure access to metadata and configuration services.
  6. Hybrid Cloud Environments:
    • In hybrid cloud environments where on-premises servers connect to cloud resources, link-local addresses can be utilized to obtain cloud-specific information and integrate seamlessly with cloud services.


What other Link-Local IP Addresses are there

Besides, several other link-local IP addresses are defined within the IPv4 address space. These addresses are part of the Automatic Private IP Addressing (APIPA) range and are reserved for use on local networks when no DHCP server is available. Here are some common link-local IP addresses:

  1. to
    • This is the entire APIPA address range. It is used when a device is unable to obtain an IP address via DHCP and needs to assign itself an address to function on the local network.
    • This address is the network identifier for the APIPA range.
    • This address is the broadcast address for the APIPA range.
    • Sometimes used as the default gateway address within a network that relies on APIPA addressing.


Link-Local IP address in AWS

In AWS, the link-local IP address is used for the EC2 Instance Metadata Service. You can make HTTP requests to this address to retrieve metadata about your EC2 instances. Here's an example of a simple payload you might receive from the EC2 Instance Metadata Service:


You can make HTTP requests to to access various types of metadata.

For example:


Sample Payload:

The payload you receive depends on the specific metadata you request. Here's an example of metadata for a hypothetical EC2 instance:

ami-id: ami-12345678
instance-id: i-0123456789abcdef0
instance-type: t2.micro
security-groups: my-security-group


This metadata includes information about the instance's ID, type, IP address, and security groups. The exact details and structure of the metadata can vary depending on the cloud provider and the specific instance.

You can use this metadata for various purposes, such as dynamically configuring instances, fetching instance-specific information, and enhancing automation in your AWS environment

The service hosted on this IP address and returning metadata in AWS is called  as Instance Metadata Service or IMDS


AWS - Instance Metadata Service ( IMDS)

In AWS, the EC2 Instance Metadata Service (IMDS) provides metadata about your EC2 instances. There are two major versions of IMDS: IMDSv1 and IMDSv2. Here's a summary of each version, along with an example of how to use them with the AWS Metadata IP address, which is

IMDSv1 (Instance Metadata Service Version 1):


IMDSv1 is the older version of the Instance Metadata Service.

It uses a simple HTTP endpoint at to retrieve metadata.

Authentication is based on an "X-aws-ec2-metadata-token" header, which can be spoofed if you have access to the instance.


To retrieve instance metadata using IMDSv1, you can make a simple HTTP request. For example, to get the instance ID:


IMDSv2 (Instance Metadata Service Version 2):

IMDSv2 is the improved version of the Instance Metadata Service, introduced for enhanced security.

It has a more secure authentication mechanism, using signed HTTP requests with temporary session credentials from the instance's EC2 instance profile.

The endpoint is, which provides a session token, and you use this token to make subsequent requests for metadata.


To use IMDSv2, you first request a session token, and then you use that token to fetch metadata. Here's an example using the AWS CLI:

Step1: Request a session token: 

TOKEN=$(curl -X PUT "" -H "X-aws-ec2-metadata-token-ttl-seconds: 300")


Step2: Use the token to get instance ID (or any other metadata):

curl -H "X-aws-ec2-metadata-token: $TOKEN"


IMDSv2 provides enhanced security and access control, making it the recommended choice for accessing instance metadata in AWS. It mitigates some of the security risks associated with IMDSv1, such as token spoofing.



Hope this article helped you understand What is Link-Local IP address and how to use it for AWS Automation and what other similar IP addresses are available etc

this local-link IP can be used to fetch the EC2 instance metadata such as IAM roles and security group configuration of the EC2 and much more.

We have also seen examples of IMDS v1 and v2 and how to fetch Metadata in EC2

Let me know your feedback or questions in the comments section.

Sarav AK

Follow me on Linkedin My Profile
Follow DevopsJunction onFacebook orTwitter
For more practical videos and tutorials. Subscribe to our channel

Buy Me a Coffee at

Signup for Exclusive "Subscriber-only" Content