Amazon EC2 인스턴스에 대한 인스턴스 ID 문서 검색 - Amazon Elastic Compute Cloud

Amazon EC2 인스턴스에 대한 인스턴스 ID 문서 검색

Amazon EC2 인스턴스에 대한 인스턴스 ID 문서는 일반 텍스트 JSON 형식을 사용합니다. 인스턴스 ID 문서의 내용에 대한 설명은 Amazon EC2 인스턴스의 인스턴스 자격 증명 문서 섹션을 참조하세요.

인스턴스 ID 문서는 인스턴스에 대한 인스턴스 메타데이터의 instance-identity/document 동적 데이터 범주에 저장됩니다. 인스턴스에 연결하고 인스턴스 메타데이터에서 검색하여 인스턴스에 대한 인스턴스 ID 문서에 액세스할 수 있습니다.

IPv4 주소 169.254.169.254 또는 IPv6 주소 fd00:ec2::254를 사용하여 인스턴스 메타데이터에 액세스할 수 있습니다. 링크-로컬 주소이므로 인스턴스에서만 액세스할 수 있습니다. 자세한 내용은 링크-로컬 주소 단원을 참조하십시오. 이 페이지의 예제에서는 IMDS의 IPv4 주소(169.254.169.254)를 사용합니다. IPv6를 통해 EC2 인스턴스에 대한 인스턴스 메타데이터를 검색하려면 fd00:ec2::254를 대신 사용합니다.

검색한 후 인스턴스 ID 문서의 신뢰성을 확인하기 위함입니다. 자세한 내용은 인스턴스 자격 증명 문서 확인 단원을 참조하십시오.

인스턴스 ID 문서를 검색하려면 다음을 수행하세요.

인스턴스에 연결한 후 다음 명령을 실행하여 인스턴스 메타데이터의 인스턴스 ID 문서에 액세스합니다.

cURL

IMDSv2

$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document

IMDSv1

$ curl http://169.254.169.254/latest/dynamic/instance-identity/document
PowerShell

IMDSv2

PS C:\> [string]$token = (Invoke-WebRequest -Method Put -Headers @{'X-aws-ec2-metadata-token-ttl-seconds' = '21600'} http://169.254.169.254/latest/api/token).Content
PS C:\> (Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} http://169.254.169.254/latest/dynamic/instance-identity/document).Content

IMDSv1

PS C:\> (Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/document).Content

출력의 예시는 다음과 같습니다.

{
    "devpayProductCodes" : null,
    "marketplaceProductCodes" : [ "1abc2defghijklm3nopqrs4tu" ], 
    "availabilityZone" : "us-west-2b",
    "privateIp" : "10.158.112.84",
    "version" : "2017-09-30",
    "instanceId" : "i-1234567890abcdef0",
    "billingProducts" : null,
    "instanceType" : "t2.micro",
    "accountId" : "123456789012",
    "imageId" : "ami-5fb8c835",
    "pendingTime" : "2016-11-19T16:32:11Z",
    "architecture" : "x86_64",
    "kernelId" : null,
    "ramdiskId" : null,
    "region" : "us-west-2"
}