---
title: "Role Data"
slug: "compute-vmetadata-roledata"
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
canonical: "api.ncloud-docs.com/compute-vmetadata-roledata"
---

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

# Role Data

VPC環境で利用できます。

サーバインスタンスに付与されたロール(Role)関連情報を照会します。 ロール関連の照会機能を使用するには、Sub Accountを通じてサーバインスタンスにロール(Role)を付与する必要があります。ロール付与の詳細は、Sub Accountご利用ガイドの[ロールの管理](https://guide.ncloud-docs.com/docs/ja/subaccount-policy-role#%EC%97%AD%ED%95%A0%EA%B4%80%EB%A6%AC)をご参照ください。 Role ID照会と仮 Access Keyの発行機能は、ncloud-sdkと Object Storage CLIで環境変数と configureファイルのいずれも Access Keyが設定されていない場合に利用できます。

              参考

              

言語別 ncloud-sdkリストとインストール方法、Ncloud CLI、Object Storage CLI使用の詳細は、次をご参照ください。

- **ncloud-sdk**
  - [ncloud-sdk-js](https://github.com/NaverCloudPlatform/ncloud-sdk-js)
  - [ncloud-sdk-java](https://github.com/NaverCloudPlatform/ncloud-sdk-java)
  - [ncloud-sdk-go](https://github.com/NaverCloudPlatform/ncloud-sdk-go-v2)
  - [ncloud-sdk-python](https://github.com/NaverCloudPlatform/ncloud-sdk-python)
- **Ncloud CLI**
  - [CLIご利用ガイド](https://cli.ncloud-docs.com/docs/ja/home)
- **Object Storage CLI**
  - [Object Storage CLIご利用ガイド](https://cli.ncloud-docs.com/docs/ja/guide-objectstorage)

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| 呼び出しのパス | 説明 |
| --- | --- |
| /{version}/meta-data/iam/ | このバージョンで提供するロール(Role)関連データの項目をリストで照会 |
| /{version}/meta-data/iam/info | サーバインスタンスに付与されたロール(Role)の詳細情報を照会 |
| /{version}/meta-data/iam/security-credentials | サーバインスタンスに付与されたロール(Role)の ID照会 - 出力結果の末尾に改行文字(\n)がない - ncloud-sdkと Object Storage CLI内部から Role IDを取得するために使用可能 |
| /{version}/meta-data/iam/security-credentials/{roleId} | サーバインスタンスに付与されたロール(Role)に対する仮 Access Key (STS)を発行 - 発行された仮 Access Keyは Roleに設定されたポリシー(Policy)に従って権限を取得 - サブアカウントの Access Keyと同様に API、CLI、SDKで使用可能 - 出力結果の末尾に改行文字(\n)がない - ncloud-sdkと Object Storage CLI内部から仮 Access Keyを取得するために使用可能 |

## 例

サンプルコードは次の通りです。

### Metadata v1

Metadata v1のサンプルコードは次の通りです。

```
# 項目の照会
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/iam/
info
security-credentials

# ロール詳細情報の照会
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/iam/info
{
  "roleId" : "***-***-***-***-***ec4",
  "roleName" : "test-role",
  "roleType" : "Server",
  "createTime" : "2024-05-04T08:24:35Z"
}

# Role IDの照会
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/iam/security-credentials
***-***-***-***-***ec4[root@test-server ~]#

# 仮 Access Keyの発行
[root@test-server ~]# curl http://169.254.169.254/latest/meta-data/iam/security-credentials/***-***-***-***-***ec4
{
  "Type" : "NCP-HMAC",
  "AccessKeyId" : "s_***976",
  "SecretAccessKey" : "***6ab",
  "Expiration" : "2024-05-22T11:50:45Z",
  "Token" : "",
  "LastUpdated" : "2024-04-21T23:50:45Z",
  "Code" : "Success"
}[root@test-server ~]#
```

### Metadata v2

Metadata v2のサンプルコードは次の通りです。 サンプルコードの2番目以降のリクエストは、最初のリクエストで生成したトークンの有効期限が切れていないと仮定して、そのトークンを使用した例です。

```
# 項目の照会
[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/iam/
info
security-credentials

# ロール詳細情報の照会
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/iam/info
{
  "roleId" : "***-***-***-***-***ec4",
  "roleName" : "test-role",
  "roleType" : "Server",
  "createTime" : "2024-05-04T08:24:35Z"
}

# Role IDの照会
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/iam/security-credentials
***-***-***-***-***ec4[root@test-server ~]#

# 仮 Access Keyの発行
[root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/iam/security-credentials/***-***-***-***-***ec4
{
  "Type" : "NCP-HMAC",
  "AccessKeyId" : "s_***976",
  "SecretAccessKey" : "***6ab",
  "Expiration" : "2024-05-22T11:50:45Z",
  "Token" : "",
  "LastUpdated" : "2024-04-21T23:50:45Z",
  "Code" : "Success"
}[root@test-server ~]#
```