--- title: "getServerInstanceList" slug: "cli-vserver-server-getserverinstancelist" tags: ["Server"] updated: 2026-06-25T09:10:26Z published: 2026-06-25T09:10:26Z canonical: "cli-fin.ncloud-docs.com/cli-vserver-server-getserverinstancelist" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # getServerInstanceList 서버 인스턴스(VM) 목록을 조회합니다. ## 구문 `getServerInstanceList` 구문은 다음과 같습니다. ```shell ./ncloud vserver getServerInstanceList \ [--vpcNo ] \ [--serverInstanceNoList ] \ [--serverName ] \ [--serverInstanceStatusCode ] \ [--baseBlockStorageDiskTypeCode ] \ [--baseBlockStorageDiskDetailTypeCode ] \ [--ip ] \ [--placementGroupNoList ] \ [--hypervisorTypeCodeList ] \ [--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`)
  • [getServerInstanceList](/docs/cli-vserver-server-getserverinstancelist) 참조
| | `--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` \| `RHV`
  • 공백으로 구분하여 여러 개 입력 가능 (예시: `--hypervisorTypeCodeList RHV XEN`)
| | `--pageNo` | Integer | Optional | 페이지 번호
  • `0`~N (기본값: `0`)
  • 첫 번째 페이지: `0` 또는 `1` 입력
| | `--sortedBy` | String | Optional | 정렬 기준
  • `serverName` \| `serverInstanceNo`
    • `serverName`: 서버 이름
    • `serverInstanceNo`: 서버 인스턴스 번호
| | `--sortingOrder` | String | Optional | 정렬 순서
  • `ASC` (기본값) \| `DESC`
    • `ASC`: 오름차순
    • `DESC`: 내림차순
| ### 공통 옵션 `vserver` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Server 옵션](/docs/cli-vserver#옵션)을 참조해 주십시오. ## 예시 서버 인스턴스 목록 조회 요청이 성공하면 각 서버의 식별 및 구성 정보가 반환됩니다. ### 명령 명령 예시는 다음과 같습니다. ```shell ./ncloud vserver getServerInstanceList \ --vpcNo 12345678 \ --serverInstanceStatusCode RUN \ --baseBlockStorageDiskTypeCode NET \ --baseBlockStorageDiskDetailTypeCode SSD \ --hypervisorTypeCodeList RHV XEN \ --pageNo 0 \ --pageSize 10 \ --sortedBy serverName \ --sortingOrder ASC \ --regionCode FKR \ --output json ``` ### 출력 출력 예시는 다음과 같습니다. ```json { "getServerInstanceListResponse": { "totalRows": 2, "serverInstanceList": [ { "serverInstanceNo": "34567890", "serverName": "test-server-01", "cpuCount": 2, "memorySize": 8589934592, "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-27T16:38:35+0900", "uptime": "2026-05-27T16:43:19+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050", "serverProductCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G001", "isProtectServerTermination": false, "zoneCode": "FKR-1", "regionCode": "FKR", "vpcNo": "12345678", "subnetNo": "23456789", "networkInterfaceNoList": [ "56789012" ], "serverInstanceType": { "code": "STAND", "codeName": "Standard" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "네트웍 스토리지" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "hypervisorType": { "code": "XEN", "codeName": "XEN" }, "serverImageNo": "45678901", "serverSpecCode": "s2-g1-s50", "eventList": [], "isPreInstallGpuDriver": false }, { "serverInstanceNo": "34567891", "serverName": "test-server-02", "cpuCount": 2, "memorySize": 4294967296, "platformType": { "code": "LNX64", "codeName": "Linux 64 Bit" }, "loginKeyName": "test-server-instance-key-01", "publicIpInstanceNo": "78901234", "publicIp": "221.168.37.181", "serverInstanceStatus": { "code": "RUN", "codeName": "서버 RUN 상태" }, "serverInstanceOperation": { "code": "NULL", "codeName": "서버 NULL OP" }, "serverInstanceStatusName": "running", "createDate": "2026-05-27T17:22:31+0900", "uptime": "2026-05-27T17:28:32+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.RHEL.0810.B050.H001", "serverProductCode": "SVR.VSVR.STAND.C002.M004.NET.SSD.B050.G001", "isProtectServerTermination": false, "zoneCode": "FKR-1", "regionCode": "FKR", "vpcNo": "12345678", "subnetNo": "23456789", "networkInterfaceNoList": [ "56789012" ], "serverInstanceType": { "code": "STAND", "codeName": "Standard" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "네트웍 스토리지" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "hypervisorType": { "code": "RHV", "codeName": "RHV" }, "serverImageNo": "45678902", "serverSpecCode": "sd2-g1-s50", "eventList": [], "isPreInstallGpuDriver": false } ], "requestId": "bd3607b5-cd27-4fa8-919d-f3a099edc8bf", "returnCode": "0", "returnMessage": "success" } } ```