---
title: "getInstanceTagList "
slug: "cli-server-getinstancetaglist"
tags: ["Server"]
updated: 2026-09-17T10:08:35Z
published: 2026-09-17T10:08:35Z
canonical: "cli.ncloud-docs.com/cli-server-getinstancetaglist"
---

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

# getInstanceTagList 

## Overview

Searching instance tags

## Description

Searching instance tags.

## Request Parameters

| Parameter Name | Requiredness | Type | Limitation | Description |
| --- | --- | --- | --- | --- |
| instanceNoList | No | List | Repeat not allowed | instance No list for searching tags |
| tagKeyList | No | List | Repeat not allowed | tag key list |
| tagValueList | No | List | Repeat not allowed | tag value list |
| pageNo | No | Integer |  | Page No. for each page size when there are multiple cases |
| pageSize | No | Integer |  | Page size for one search page |

## Response Data Type

- InstanceTagList type

| InstanceTagList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<instancetag data-tomark-pass=""> instanceTagList = new ArrayList<instancetag data-tomark-pass="">();</instancetag></instancetag> |

| InstanceTag |
| --- |
| private String instanceNo; |
| private CommonCode instanceType; |
| private String tagKey; |
| private String tagValue; |

## Examples

### Request

```
ncloud server getInstanceTagList --instanceNoList 713768 --tagKeyList penguin
```

### Response

```
{
  "getInstanceTagListResponse": {
    "requestId": "6c852800-4d84-4616-bf8e-2ccdf5cd81c9",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "instanceTagList": [
      {
        "instanceNo": "713768",
        "instanceType": {
          "code": "SVR",
          "codeName": "Server"
        },
        "tagKey": "penguin",
        "tagValue": "999999"
      }
    ]
  }
}
```

```
<?xml version="1.0" encoding="UTF-8" ?>
<getInstanceTagListResponse>
  <requestId>6c852800-4d84-4616-bf8e-2ccdf5cd81c9</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <instanceTagList>
    <instanceNo>713768</instanceNo>
    <instanceType>
      <code>SVR</code>
      <codeName>Server</codeName>
    </instanceType>
    <tagKey>penguin</tagKey>
    <tagValue>999999</tagValue>
  </instanceTagList>
</getInstanceTagListResponse>
```