---
title: "getInstanceTagList "
slug: "compute-server-getinstancetaglist"
updated: 2026-10-22T10:47:05Z
published: 2026-10-22T10:47:05Z
canonical: "api-gov.ncloud-docs.com/compute-server-getinstancetaglist"
---

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

# getInstanceTagList

## 개요

인스턴스 태그를 조회합니다.

## 요청

### 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| instanceNoList.N | No | List<String> | 중복 불가 | - 인스턴스 태그를 조회할 서버 인스턴스 번호 리스트 `[서버 한정]` ex)instanceNoList.1=1088217 |
| tagKeyList.N | No | List<String> | 중복 불가 | - 조회 할 인스턴스의 태그 키 Instance의 TagKey는 getInstanceTagList 액션을 통해 획득 가능 ex) 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 |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [InstanceTagList](/docs/common-vapidatatype-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>
```