---
title: "getInstanceTagList"
slug: "compute-server-getinstancetaglist"
updated: 2026-09-17T09:57:42Z
published: 2026-09-17T09:57:42Z
canonical: "api.ncloud-docs.com/compute-server-getinstancetaglist"
---

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

# getInstanceTagList

## 概要

インスタンスタグを照会します。

## リクエスト

### リクエストパラメータ

| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
| --- | --- | --- | --- | --- |
| instanceNoList.N | No | List<String> | 重複不可 | - インスタンスタグ照会対象のサーバインスタンス番号リスト [サーバ限定] 例: instanceNoList.1=1088217 |
| tagKeyList.N | No | List<String> | 重複不可 | - 照会対象インスタンスのタグキー Instanceの TagKeyは getInstanceTagListアクションを通じて取得可能 例) tagKeyList.1=tag1 |
| tagValueList.N | No | List<String> | 重複不可 | - 照会対象インスタンスのタグ値 Instanceの TagValueは getInstanceTagListアクションを通じて取得可能 tagValueList.1=dolphins |
| pageNo | No | Integer |  | - ページングされた結果のページ番号 結果値は pageNoを利用してページング処理できる |
| pageSize | No | Integer |  | - ページング時に表示する各ページサイズ 結果値は pageSizeを利用してページング処理できる |
| responseFormatType | No | String |  | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml |

## レスポンス

### レスポンスボディ

- [InstanceTagList](/docs/ja/common-apidatatype-instancetaglist)

## 例

### リクエスト例

```
GET {SERVER_API_URL}/getInstanceTagList
?tagKeyList.1=tag1
```

### レスポンス例

```
<getInstanceTagListResponse>
  <requestId>8b3584cc-d7c6-44fb-9976-3b8a11180bf7</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <instanceTagList>
    <instanceTag>
      <instanceNo>1088217</instanceNo>
      <instanceType>
        <code>SVR</code>
        <codeName>Server</codeName>
      </instanceType>
      <tagKey>tag1</tagKey>
      <tagValue>dolphins</tagValue>
    </instanceTag>
  </instanceTagList>
</getInstanceTagListResponse>
```