Server Data

Prev Next

VPC 환경에서 이용 가능합니다.

서버 인스턴스와 관련된 최상위 메타데이터 카테고리 목록을 조회하고, 각 카테고리의 조회 값을 확인합니다.

참고

Metadata v2 호출 방식에 대한 자세한 내용은 Metadata v2 사용을 참조해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

호출 경로 설명
/{version}/meta-data/ 해당 버전에서 제공하는 서버 인스턴스와 관련된 최상위 메타데이터 카테고리를 목록으로 조회
/{version}/meta-data/{field-1}/{field-2}/.. 제공하는 메타데이터 중 하위 항목이 있는 경우 하위 경로로 사용하여 조회
  • 리스트 형태의 데이터는 하위 항목으로 인덱스 목록이 제공되며, 인덱스 값을 하위 경로로 사용

예시

예시는 다음과 같습니다.

Metadata v1

Metadata v1 예시는 다음과 같습니다.

# 최상위 메타데이터 카테고리 조회
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/
serverInstanceNo
serverName
serverDescription
cpuCount
memorySize
platformType
loginKeyName
publicIpInstanceNo
publicIp
serverInstanceStatus
serverInstanceOperation
serverInstanceStatusName
createDate
uptime
serverImageProductCode
serverProductCode
isProtectServerTermination
zoneCode
regionCode
vpcNo
subnetNo
networkInterfaceNoList
initScriptNo
serverInstanceType
baseBlockStorageDiskType
baseBlockStorageDiskDetailType
placementGroupNo
placementGroupName
iam

# 서버 인스턴스 이름 조회 예
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverName/
test-server

# 서버 인스턴스 상태 조회 예
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverInstanceStatus/
code
codeName

# 서버 인스턴스 상태(serverInstanceStatus)의 하위 항목인 code 조회
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverInstanceStatus/code
RUN

# 서버 인스턴스에 할당된 네트워크 인터페이스 항목 조회
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/networkInterfaceNoList/
0
1

# 네트워크 인터페이스 항목 조회(networkInterfaceNoList) 결과 값인 인덱스 번호로 네트워크 인터페이스 ID 조회
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/networkInterfaceNoList/0
***531
[root@test-server ~]#

Metadata v2

Metadata v2 예시는 다음과 같습니다.
예시의 두 번째 이후 요청은 첫 번째 요청에서 생성한 토큰이 만료되지 않았다는 가정하에 해당 토큰을 사용한 예입니다.

# 최상위 메타데이터 카테고리 조회
[root@test-server ~]# TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-NCP-METADATA-TOKEN-TTL-SECONDS: 21600"` \
&& curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/
serverInstanceNo
serverName
serverDescription
cpuCount
memorySize
platformType
loginKeyName
publicIpInstanceNo
publicIp
serverInstanceStatus
serverInstanceOperation
serverInstanceStatusName
createDate
uptime
serverImageProductCode
serverProductCode
isProtectServerTermination
zoneCode
regionCode
vpcNo
subnetNo
networkInterfaceNoList
initScriptNo
serverInstanceType
baseBlockStorageDiskType
baseBlockStorageDiskDetailType
placementGroupNo
placementGroupName
iam

# 서버 인스턴스 이름 조회 예
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/serverName/
test-server

# 서버 인스턴스 상태 조회 예
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/serverInstanceStatus/
code
codeName

# 서버 인스턴스 상태(serverInstanceStatus)의 하위 항목인 code 조회
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest//meta-data/serverInstanceStatus/code
RUN

# 네트워크 인터페이스 항목 조회(networkInterfaceNoList) 결과 값인 인덱스 번호로 네트워크 인터페이스 ID 조회
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/networkInterfaceNoList/
0
1

# 네트워크 인터페이스 항목 조회(networkInterfaceNoList) 결과 값인 인덱스 번호로 네트워크 인터페이스 ID 조회
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/networkInterfaceNoList/0
***531
[root@test-server ~]#

최상위 메타데이터 카테고리 목록

인스턴스 메타데이터의 최상위 카테고리 목록에 대한 설명은 다음과 같습니다.
네이버 클라우드 플랫폼에서 메타데이터 카테고리를 릴리스하면 새 카테고리에 대한 메타데이터를 기존 인스턴스에서 사용하지 못할 수 있습니다.

최상위 카테고리 설명
serverInstanceNo 서버 인스턴스 번호
serverName 서버 인스턴스 이름
serverDescription 서버 인스턴스에 대한 설명
cpuCount 서버 인스턴스의 CPU 개수
memorySize 서버 인스턴스의 메모리 크기
platformType 서버 인스턴스의 운영체제 코드 및 코드 이름
loginKeyName 로그인 키 이름
publicIpInstanceNo 할당된 공인 IP 인스턴스의 번호
publicIp 할당된 공인 IP 주소
serverInstanceStatus 서버 인스턴스 가동 상태 코드 및 코드 이름
serverInstanceOperation 서버 인스턴스 오퍼레이션 코드 및 코드 이름
serverInstanceStatusName 서버 인스턴스 가동 상태
createDate 서버 인스턴스 생성일
uptime 서버스 인스턴스 업데이트 날짜
serverImageProductCode 서버 이미지 상품 코드
serverProductCode 서버 상품 코드
isProtectServerTermination 보호 반납 여부
zoneCode 존 코드
regionCode 리전 코드
vpcNo 서버 인스턴스가 생성된 VPC 번호
subnetNo 서버 인스턴스에서 사용 중인 기본 네트워크 인터페이지의 Subnet 번호
networkInterfaceNoList 할당된 네트워크 인터페이스 리스트
initScriptNo 초기화 스크립트 번호
serverInstanceType 서버 스펙 타입 코드 및 코드 이름
baseBlockStorageDiskType 블록 스토리지 디스크 타입
baseBlockStorageDiskDetailType 블록 스토리지 디스크 타입 상세
placementGroupNo 물리 배치 그룹 번호
placementGroupName 물리 배치 그룹 번호 이름
iam 서버 인스턴스의 IAM 역할 및 보안 인증 정보