--- title: "Server" slug: "analytics-cloudloganalytics-getserverlist-vpc-server" tags: ["Cloud Log Analytics"] updated: 2026-10-22T10:47:29Z published: 2026-10-22T10:47:29Z canonical: "api-gov.ncloud-docs.com/analytics-cloudloganalytics-getserverlist-vpc-server" --- > ## 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. # Server VPC 환경에서 이용 가능합니다. VPC 환경의 서버 인스턴스(VM) 목록을 조회하고, 서버별 Cloud Log Analytics 서비스를 통한 로그 수집 설정 상태를 확인합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET | /api/{regionCode}-v1/vpc/servers | ### 요청 헤더 Cloud Log Analytics API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud Log Analytics 요청 헤더](/docs/analytics-cloudloganalytics#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 경로 파라미터 요청 경로 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Required | 리전 코드 - `kr` \| `krs` - `kr`: 수도권 - `krs`: 남부권 | ### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `pageNo` | Integer | Optional | 페이지 번호 - 1~100 (기본값: 1) | | `pageSize` | Integer | Optional | 페이지당 항목 수 - 10~100 (기본값: 10) | ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://cloudloganalytics.apigw.gov-ntruss.com/api/{regionCode}-v1/vpc/servers' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \ --header 'Content-Type: application/json' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `code` | Integer | - | 응답 코드 | | `message` | String | - | 응답 메시지 | | `result` | Object | - | 응답 결과 | | `result.pageSize` | Integer | - | 페이지당 항목 수 | | `result.currentPage` | Integer | - | 현재 페이지 번호 | | `result.totalPage` | Integer | - | 전체 페이지 수 | | `result.totalCount` | Integer | - | 전체 항목 수 | | `result.isPaged` | Boolean | - | 페이징 여부 - `true` \| `false` - `true`: 페이징 - `false`: 페이징 안 함 | | `result.vpcServerInfos` | Array | - | 서버 목록: [vpcServerInfos](/docs/analytics-cloudloganalytics-getserverlist-vpc-server#vpcServerInfos) - 서버 정보 - 로그 수집 설정 정보 | | `result.collectingCount` | Integer | - | 로그 수집 설정 완료 서버 수 | #### `vpcServerInfos` `vpcServerInfos`에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `additionalParameterMap` | Object | - | 서버 정보 | | `collectingInfo` | Object | - | 로그 수집 설정 정보 | | `collectingInfo.collectorAgentVersion` | String | - | 로그 수집 에이전트 버전 | | `collectingInfo.logTypeCount` | Integer | - | 수집 대상 로그 유형 개수 | | `collectingInfo.collectionStatus` | String | - | 로그 수집 상태 | | `collectingInfo.settingStatus` | String | - | 로그 수집 설정 상태 | | `collectingInfo.settingStatusColor` | String | - | 로그 수집 설정 상태 색상 표기 값 | | `collectingInfo.servername` | String | - | 로그 수집 대상 서버 이름 | | `collectingInfo.logCollectorDate` | String | - | 로그 수집 설정 일시 | | `collectingInfo.logTypeList` | String | - | 수집 대상 로그 유형 목록 | | `collectingInfo.configKey` | String | - | 로그 수집 에이전트 Install Key | | `collectingInfo.isCollecting` | Boolean | - | 로그 수집 활성화 여부 - `true` \| `false` - `true`: 활성화 - `false`: 비활성화 | 참고 Server 정보 관련 필드(`additionalParameterMap`)에 대한 설명은 [Server API 가이드](/docs/compute-vserver)와 [Server 사용 가이드](https://guide-gov.ncloud-docs.com/docs/compute-server-virtualmachineserver-overview)를 참조해 주십시오. ### 응답 상태 코드 Cloud Log Analytics API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Cloud Log Analytics 응답 상태 코드](/docs/analytics-cloudloganalytics#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ``` { "code": 0, "message": "요청이 정상적으로 처리되었습니다", "result": { "pageSize": 10, "currentPage": 1, "totalPage": 1, "totalCount": 2, "isPaged": true, "vpcServerInfos": [ { "additionalParameterMap": { "networkInterfaceList": [ { "vpcNo": 77778, "vpcName": "test", "subnetNo": 177781, "subnetName": "mgmt-subnet", "subnet": "***.***.***.***/**", "igwYn": "Y", "zoneNo": 2, "zoneName": "KR-1", "networkInterfaceNo": 4352109, "networkInterfaceName": "nic-4352109", "internalIp": "***.***.***.***", "macAddress": "**:**:**:**:**:**", "attachedDeviceName": "eth0", "secondaryIps": [ null ] } ], "igwYn": "Y", "vpcName": "test", "vpcNo": 77778, "subnetName": "mgmt-subnet", "subnetNo": 177781 }, "baseBlockStorageSize": null, "carrierNetworkIp": "***.***.***.***", "computeInstanceDetailTypeCode": null, "computeInstanceName": "s19293f45ef5", "computeInstanceTypeCode": "VSVR", "computeInstanceUuid": null, "computeSpec": "vCPU 2EA, Memory 8GB, Disk 50GB", "contractNo": 17792786, "cpuCount": 2, "createYmdt": 1729059121967, "hostNameInitConfigYn": null, "instanceNo": 27057139, "instanceProductType2Code": "STAND", "instanceStatusCode": "RUN", "instanceStatusName": "running", "instanceTypeCode": "VSVR", "ip": null, "launchDateTime": 1729059320699, "macAddress": null, "nsiName": "centos-7.3-64", "operationCode": "NULL", "operationYmdt": "1729059320699", "osDiskTypeCode": "NET", "osDiskTypeDetailCode": "HDD", "osInformation": "CentOS 7.3 (64-bit)", "osName": "CentOS 7.3 (64-bit)", "overlayNetworkIp": "172.16.1.7", "parameters": null, "platformTypeCode": "LNX64", "productCode": "SVR.VSVR.STAND.C002.M008.NET.HDD.B050.G002", "publicIp": null, "publicIpInstanceNo": null, "regionCode": "KR", "regionName": "Korea", "serverName": "s19293f45ef5", "serverSpec": "vCPU 2EA, Memory 8GB, Disk 50GB", "softwareProductCode": "SW.VSVR.OS.LNX64.CNTOS.0703.B050", "subnetName": null, "subAccountNo": null, "upTime": null, "vpcName": null, "zoneName": "KR-1", "zoneNo": 2, "serverStatusColor": "green", "serverStatusKorean": "운영중", "serverStatusValue": "운영중", "isSupportOS": true, "collectingInfo": { "collectorAgentVersion": "7.17.2", "logTypeCount": 5, "collectionStatus": "미설정", "settingStatus": "설정완료", "settingStatusColor": "green", "servername": "s19293f45ef5", "logCollectorDate": "2024-11-08 22:30:57", "logTypeList": "tomcat_catalina,SYSLOG,security_log,apache_access,apache_error", "configKey": "***********", "isCollecting": true } }, { "additionalParameterMap": { "networkInterfaceList": [ { "vpcNo": 77778, "vpcName": "test", "subnetNo": 177781, "subnetName": "mgmt-subnet", "subnet": "***.***.***.***/**", "igwYn": "Y", "zoneNo": 2, "zoneName": "KR-1", "networkInterfaceNo": 4352038, "networkInterfaceName": "nic-4352038", "internalIp": "***.***.***.***", "macAddress": "**:**:**:**:**:**", "attachedDeviceName": "eth0", "secondaryIps": [ null ] } ], "igwYn": "Y", "vpcName": "test", "vpcNo": 77778, "subnetName": "mgmt-subnet", "subnetNo": 177781 }, "baseBlockStorageSize": null, "carrierNetworkIp": "***.***.***.***", "computeInstanceDetailTypeCode": null, "computeInstanceName": "s19293c276d5", "computeInstanceTypeCode": "VSVR", "computeInstanceUuid": null, "computeSpec": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "contractNo": 17792417, "cpuCount": 2, "createYmdt": 1729055851701, "hostNameInitConfigYn": null, "instanceNo": 27056413, "instanceProductType2Code": "STAND", "instanceStatusCode": "RUN", "instanceStatusName": "running", "instanceTypeCode": "VSVR", "ip": null, "launchDateTime": 1729056060600, "macAddress": null, "nsiName": "centos-7.3-64", "operationCode": "NULL", "operationYmdt": "1729056060600", "osDiskTypeCode": "NET", "osDiskTypeDetailCode": "SSD", "osInformation": "CentOS 7.3 (64-bit)", "osName": "CentOS 7.3 (64-bit)", "overlayNetworkIp": "172.16.1.6", "parameters": null, "platformTypeCode": "LNX64", "productCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002", "publicIp": null, "publicIpInstanceNo": null, "regionCode": "KR", "regionName": "Korea", "serverName": "s19293c276d5", "serverSpec": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "softwareProductCode": "SW.VSVR.OS.LNX64.CNTOS.0703.B050", "subnetName": null, "subAccountNo": null, "upTime": null, "vpcName": null, "zoneName": "KR-1", "zoneNo": 2, "serverStatusColor": "green", "serverStatusKorean": "운영중", "serverStatusValue": "운영중", "isSupportOS": true, "collectingInfo": { "collectorAgentVersion": "7.17.2", "logTypeCount": 8, "collectionStatus": "미설정", "settingStatus": "설정완료", "settingStatusColor": "green", "servername": "s19293c276d5", "logCollectorDate": "2024-11-17 23:27:09", "logTypeList": "apache_access,apache_error,cdb_mysql_audit,mysql_error,mysql_slow,security_log,SYSLOG,tomcat_catalina", "configKey": "***********", "isCollecting": true } } ], "collectingCount": 0 } } ```