---
title: "Metadata 概要"
slug: "compute-vmetadata"
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
canonical: "api.ncloud-docs.com/compute-vmetadata"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metadata 概要

VPC環境で利用できます。

## 概要

実行中のサーバインスタンスを管理するのに使用できる、サーバインスタンス関連データを提供します。 また、サーバインスタンスに付与されたロール(Role)に関する情報を照会し、当該ロール(Role)に関する臨時のAccess Key (STS)が発行されます。 各パスの呼び出しの結果としては、下位項目のリストをライン区切り文字(\n)で区分して並べるか、 もしくは当該パスに該当する結果情報になり得ます。 サーバインスタンスに直接アクセスできるすべてのユーザーとサーバインスタンスで実行中のすべてのソフトウェアは、Metadataにアクセスできるため、ロール(Role)設定などに注意が必要です。 リソースがない場合、`404 - Not Found HTTP`エラーコードが返されます。 HTTP方式の呼び出しを介して行われます。

## 共通の設定

### API URL

```
GET
http://169.254.169.254/
```

### エラーレスポンス

```
[root@test-server ~]# curl -i http://169.254.169.254/nonexistent-path
HTTP/1.1 404 404
Date: Mon, 21 Dec 2020 23:19:37 GMT
Server: Apache
Referrer-Policy: unsafe-url
Connection: close
Transfer-Encoding: chunked
Content-Type: text/plain;charset=UTF-8

Path Not found.
[root@test-server ~]#
```

## カテゴリ

| 呼び出しのパス | 説明 |
| --- | --- |
| [GET /](/docs/ja/compute-vmetadata-version) | 使用可能なバージョンリストを照会します。 |
| [GET /{version}/meta-data/](/docs/ja/compute-vmetadata-serverdata) | サーバインスタンスの関連情報を照会します。 |
| [GET /{version}/meta-data/iam](/docs/ja/compute-vmetadata-roledata) | サーバインスタンスに付与されたロール(Role)関連情報を照会します。 |