Server Data
- 인쇄
- PDF
Server Data
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
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 역할 및 보안 인증 정보 |
이 문서가 도움이 되었습니까?