--- title: "Server Data " slug: "compute-vmetadata-serverdata" tags: ["Metadata"] updated: 2026-10-22T10:47:10Z published: 2026-10-22T10:47:10Z canonical: "api-gov.ncloud-docs.com/compute-vmetadata-serverdata" --- > ## Documentation Index > Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Server Data VPC 환경에서 이용 가능합니다. 서버 인스턴스와 관련된 최상위 메타데이터 카테고리 목록을 조회하고, 각 카테고리의 조회 값을 확인합니다. 참고 Metadata v2 호출 방식에 대한 자세한 내용은 [Metadata v2 사용](/docs/compute-vmetadata-metadatav2)을 참조해 주십시오. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 호출 경로 | 설명 | | --- | --- | | /{version}/meta-data/ | 해당 버전에서 제공하는 서버 인스턴스와 관련된 [최상위 메타데이터 카테고리를 목록](/docs/compute-vmetadata-serverdata#%EC%B5%9C%EC%83%81%EC%9C%84%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC%EB%AA%A9%EB%A1%9D)으로 조회 | | /{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 역할 및 보안 인증 정보 |