---
title: "Version"
slug: "compute-vmetadata-version"
tags: ["Metadata"]
updated: 2026-10-22T10:47:10Z
published: 2026-10-22T10:47:10Z
canonical: "api-gov.ncloud-docs.com/compute-vmetadata-version"
---

> ## 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.

# Version

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

사용 가능한 인스턴스 메타데이터 버전 목록과 각 버전의 최상위 카테고리 목록을 조회합니다.

          참고

          

Metadata v2 호출 방식에 대한 자세한 내용은 [Metadata v2 사용](/docs/compute-vmetadata-metadatav2)을 참조해 주십시오.

## 요청

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

| 호출 경로 | 설명 |
| --- | --- |
| / | 사용 가능한 인스턴스 메타데이터 버전 목록 조회 |
| /{version}/ | 각 버전에서 제공하는 최상위 카테고리 목록 조회 - 가장 최신 버전을 이용하려면 `latest` 이용 |

## 예시

예시는 다음과 같습니다.

### Metadata v1

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

```
## 인스턴스 메타데이터 버전 목록 조회 
[root@test-server ~]# curl http://169.254.169.254/
2020-11-18
latest

## latest 버전에서 제공하는 최상위 카테고리 목록 조회
[root@test-server ~]# curl http://169.254.169.254/latest/
meta-data
[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/
2020-11-18
latest

# latest 버전에서 제공하는 최상위 카테고리 목록 조회
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/
meta-data
[root@test-server ~]#
```