---
title: "createInstanceTags"
slug: "cli-server-createinstancetags"
updated: 2026-04-23T08:56:59Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-server-createinstancetags"
---

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

# createInstanceTags

## 개요<a name="개요"></a>

인스턴스 태그 생성

## 설명 <a name="설명"></a>

인스턴스 태그를 생성합니다.

## 요청 파라미터 <a name="요청파라미터"></a>

| 파라미터 명                | 필수 여부   | 타입     | 제약사항               | 설명 |
| -------------------- | --------- | ------ | ---------------- | ---- |
| instanceNoList.N | Yes | List\<String> | 중복불가 | 인스턴스 태그를 생성할 인스턴스 번호 리스트 (서버 한정) |
| instanceTagList.N.tagKey             | Yes     | String |                  | 생성할 인스턴스 태그 리스트. 태그 키 |
| instanceTagList.N.tagValue               | Yes    | String |                  | 생성할 인스턴스 태그 리스트. 태그 값 |

## 응답 데이터 타입 <a name="응답데이터타입"></a>

- InstanceTagList type

| InstanceTagList extends CommonResponse |
| ---------------------------------------- |
| private Integer totalRows;
| private List<InstanceTag> instanceTagList = new ArrayList<InstanceTag>(); |

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

## 예시 <a name="예시"></a>

### 호출 <a name="호출"></a>

```
ncloud server createInstanceTags --instanceNoList 712342 --instanceTagList "tagKey=penguin, tagValue=999999"
```

### 응답 <a name="응답"></a>

```json
{
  "createInstanceTagsResponse": {
    "requestId": "2f77f4b0-86c8-49d9-8bf9-0c4988f51a47",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "instanceTagList": [
      {
        "instanceNo": "712342",
        "instanceType": {
          "code": "SVR",
          "codeName": "Server"
        },
        "tagKey": "penguin2",
        "tagValue": "aaaa"
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<createInstanceTagsResponse>
  <requestId>2f77f4b0-86c8-49d9-8bf9-0c4988f51a47</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <instanceTagList>
    <instanceNo>712342</instanceNo>
    <instanceType>
      <code>SVR</code>
      <codeName>Server</codeName>
    </instanceType>
    <tagKey>penguin2</tagKey>
    <tagValue>aaaa</tagValue>
  </instanceTagList>
</createInstanceTagsResponse>
```