--- title: "getServerInstanceList" slug: "cli-vserver-server-getserverinstancelist" tags: ["VPC", "Server"] updated: 2026-09-17T09:15:56Z published: 2026-09-17T09:15:56Z canonical: "cli.ncloud-docs.com/cli-vserver-server-getserverinstancelist" --- > ## 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. # getServerInstanceList VPC 환경에서 이용 가능합니다. 서버 인스턴스(VM) 목록을 조회합니다. ## 구문 `getServerInstanceList` 구문은 다음과 같습니다. ``` ./ncloud vserver getServerInstanceList \ [--vpcNo ] \ [--serverInstanceNoList ] \ [--serverName ] \ [--serverInstanceStatusCode ] \ [--baseBlockStorageDiskTypeCode ] \ [--baseBlockStorageDiskDetailTypeCode ] \ [--ip ] \ [--placementGroupNoList ] \ [--hypervisorTypeCodeList ] \ [--fabricClusterPoolNo ] \ [--fabricClusterNo ] \ [--fabricClusterMode ] \ [--pageNo ] \ [--pageSize ] \ [--sortedBy ] \ [--sortingOrder ] \ [--regionCode ] \ [--output ] ``` ## 옵션 `getServerInstanceList` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `getServerInstanceList`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--pageSize` | Integer | Conditional | 페이지당 항목 수 - `1`~`1000` (기본값: `1`) - `--pageNo` 입력 시 필수 입력 | ### 선택 옵션 `getServerInstanceList`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--vpcNo` | String | Optional | VPC 번호 - [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 참조 | | `--serverInstanceNoList` | List | Optional | 서버 인스턴스 번호 목록 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--serverInstanceNoList 1234 2345`) | | `--serverName` | String | Optional | 서버 이름 | | `--serverInstanceStatusCode` | String | Optional | 서버 인스턴스 상태 코드 - `INIT` \| `CREAT` \| `RUN` \| `NSTOP` | | `--baseBlockStorageDiskTypeCode` | String | Optional | 기본 블록 스토리지의 디스크 유형 코드 - `NET`: 네트워크 디스크 | | `--baseBlockStorageDiskDetailTypeCode` | String | Optional | 기본 블록 스토리지의 디스크 상세 유형 코드 - `HDD` \| `SSD` | | `--ip` | String | Optional | 서버 IP 주소 - 비공인 IP와 공인 IP 모두 포함 | | `--placementGroupNoList` | List | Optional | 물리 배치 그룹 번호 목록 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--placementGroupNoList 1234 2345`) - [getPlacementGroupList](/docs/cli-vserver-server-placementgroup-getplacementgrouplist) 참조 | | `--hypervisorTypeCodeList` | List | Optional | 하이퍼바이저 타입 코드 목록 - `XEN` \| `KVM` - 공백으로 구분하여 여러 개 입력 가능 (예시: `--hypervisorTypeCodeList KVM XEN`) | | `--fabricClusterPoolNo` | String | Optional | Fabric Cluster Pool 번호 - [getFabricClusterPoolList](/docs/cli-vserver-fabriccluster-getfabricclusterpoollist) 참조 | | `--fabricClusterNo` | String | Optional | Fabric Cluster 번호 - [getFabricClusterList](/docs/cli-vserver-fabriccluster-getfabricclusterlist) 참조 | | `--fabricClusterMode` | String | Optional | Fabric Cluster 모드 - `SINGLE` \| `CLUSTER` - `SINGLE`: Fabric Cluster에 포함되지 않은 서버 - `CLUSTER`: Fabric Cluster에 포함된 서버 | | `--pageNo` | Integer | Optional | 페이지 번호 - `0`~N (기본값: `0`) - 첫 번째 페이지: `0` 또는 `1` 입력 | | `--sortedBy` | String | Optional | 정렬 기준 - `serverName` \| `serverInstanceNo` - `serverName`: 서버 이름 - `serverInstanceNo`: 서버 인스턴스 번호 | | `--sortingOrder` | String | Optional | 정렬 순서 - `ASC` (기본값) \| `DESC` - `ASC`: 오름차순 - `DESC`: 내림차순 | ### 공통 옵션 `vserver` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Server (VPC) 옵션](/docs/cli-vserver#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 서버 인스턴스 목록 조회 요청이 성공하면 각 서버의 식별 및 구성 정보가 반환됩니다. ### 명령 명령 예시는 다음과 같습니다. ``` ./ncloud vserver getServerInstanceList \ --vpcNo 12345678 \ --serverInstanceStatusCode RUN \ --baseBlockStorageDiskTypeCode NET \ --baseBlockStorageDiskDetailTypeCode SSD \ --hypervisorTypeCodeList KVM XEN \ --pageNo 0 \ --pageSize 10 \ --sortedBy serverName \ --sortingOrder ASC \ --regionCode KR \ --output json ``` ### 출력 출력 예시는 다음과 같습니다. ``` { "getServerInstanceListResponse": { "totalRows": 4, "serverInstanceList": [ { "serverInstanceNo": "34567890", "serverName": "kvm-server-01", "cpuCount": 2, "memorySize": 8589934592, "platformType": { "code": "LNX64", "codeName": "Linux 64 Bit" }, "loginKeyName": "test-login-key-01", "serverInstanceStatus": { "code": "RUN", "codeName": "서버 RUN 상태" }, "serverInstanceOperation": { "code": "NULL", "codeName": "서버 NULL OP" }, "serverInstanceStatusName": "running", "createDate": "2026-04-28T13:01:30+0900", "uptime": "2026-04-28T13:03:43+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.NAVIX.09.G003", "serverProductCode": "SVR.VSVR.AMD.STAND.C002.M008.G003", "isProtectServerTermination": false, "zoneCode": "KR-1", "regionCode": "KR", "vpcNo": "12345678", "subnetNo": "23456789", "networkInterfaceNoList": [ "56789012" ], "serverInstanceType": { "code": "STAND", "codeName": "Standard" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "네트웍 스토리지" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "hypervisorType": { "code": "KVM", "codeName": "KVM" }, "serverImageNo": "45678902", "serverSpecCode": "s2-g3a", "eventList": [], "isPreInstallGpuDriver": false }, { "serverInstanceNo": "34567891", "serverName": "xen-server-01", "cpuCount": 2, "memorySize": 4294967296, "platformType": { "code": "LNX64", "codeName": "Linux 64 Bit" }, "loginKeyName": "test-login-key-01", "serverInstanceStatus": { "code": "RUN", "codeName": "서버 RUN 상태" }, "serverInstanceOperation": { "code": "NULL", "codeName": "서버 NULL OP" }, "serverInstanceStatusName": "running", "createDate": "2026-05-14T16:17:00+0900", "uptime": "2026-05-14T16:21:06+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050", "serverProductCode": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002", "isProtectServerTermination": false, "zoneCode": "KR-1", "regionCode": "KR", "vpcNo": "12345678", "subnetNo": "23456789", "networkInterfaceNoList": [ "56789013" ], "serverInstanceType": { "code": "HICPU", "codeName": "High-CPU" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "네트웍 스토리지" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "hypervisorType": { "code": "XEN", "codeName": "XEN" }, "serverImageNo": "45678901", "serverSpecCode": "c2-g2-s50", "eventList": [], "isPreInstallGpuDriver": false }, { "serverInstanceNo": "34567892", "serverName": "test-server-01", "cpuCount": 2, "memorySize": 4294967296, "platformType": { "code": "LNX64", "codeName": "Linux 64 Bit" }, "loginKeyName": "test-server-instance-key-01", "serverInstanceStatus": { "code": "RUN", "codeName": "서버 RUN 상태" }, "serverInstanceOperation": { "code": "NULL", "codeName": "서버 NULL OP" }, "serverInstanceStatusName": "running", "createDate": "2026-05-14T17:29:35+0900", "uptime": "2026-05-14T17:34:00+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050", "serverProductCode": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002", "isProtectServerTermination": false, "zoneCode": "KR-1", "regionCode": "KR", "vpcNo": "12345678", "subnetNo": "23456789", "networkInterfaceNoList": [ "56789014" ], "serverInstanceType": { "code": "HICPU", "codeName": "High-CPU" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "네트웍 스토리지" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "hypervisorType": { "code": "XEN", "codeName": "XEN" }, "serverImageNo": "45678901", "serverSpecCode": "c2-g2-s50", "eventList": [], "isPreInstallGpuDriver": false }, { "serverInstanceNo": "34567893", "serverName": "test-server-02", "cpuCount": 2, "memorySize": 4294967296, "platformType": { "code": "LNX64", "codeName": "Linux 64 Bit" }, "loginKeyName": "test-server-instance-key-01", "serverInstanceStatus": { "code": "RUN", "codeName": "서버 RUN 상태" }, "serverInstanceOperation": { "code": "NULL", "codeName": "서버 NULL OP" }, "serverInstanceStatusName": "running", "createDate": "2026-05-14T17:29:43+0900", "uptime": "2026-05-14T17:33:45+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050", "serverProductCode": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002", "isProtectServerTermination": false, "zoneCode": "KR-1", "regionCode": "KR", "vpcNo": "12345678", "subnetNo": "23456789", "networkInterfaceNoList": [ "56789015" ], "serverInstanceType": { "code": "HICPU", "codeName": "High-CPU" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "네트웍 스토리지" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "hypervisorType": { "code": "XEN", "codeName": "XEN" }, "serverImageNo": "45678901", "serverSpecCode": "c2-g2-s50", "eventList": [], "isPreInstallGpuDriver": false } ], "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "returnCode": "0", "returnMessage": "success" } } ```