설명
Cloud Log Analytics 서비스에서 확인할 수 있는 서버 목록을 조회합니다.
VPC 서버 목록 조회
VPC Platform에 있는 서버 인스턴스(VM) 리스트를 조회합니다. 로그 수집 설정 상태도 조회할 수 있으며 페이징 처리가 가능합니다.
요청 URL
GET https://cloudloganalytics.apigw.gov-ntruss.com/api/{regionCode}-v1/vpc/servers
요청 헤더
| 헤더명 | 설명 |
|---|---|
| x-ncp-apigw-timestamp | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-apigw-api-key | APIGW에서 발급받은 키 값x-ncp-apigw-api-key:{API Gateway API Key} |
| x-ncp-iam-access-key | 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값x-ncp-iam-access-key:{Account Access Key} |
| x-ncp-apigw-signature-v1 | Access Key ID 값과 Secret Key로 암호화한 서명x-ncp-apigw-signature-v1:{API Gateway Signature} |
| Content-Type | Request body content type을 application/json으로 지정Content-Type: application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| pageNo | Integer | N | 페이지 번호 ex) 1, 2 |
| pageSize | Integer | N | 페이지 사이즈 ex) 10, 20 |
요청 예시
GET https://cloudloganalytics.apigw.gov-ntruss.com/api/{regionCode}-v1/vpc/servers?pageNo=1&pageSize=10
HOST: cloudloganalytics.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: FJSBB4K3XnaGAvVe0Hzj3/2hfNWvgLHR1rQHW2Et2Rs=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 11IKBWgQegM4DwiJL4mo
curl -X GET "https://cloudloganalytics.apigw.gov-ntruss.com/api/{regionCode}-v1/vpc/servers?pageNo=1&pageSize=10"
-H "accept: application/json"
-H "x-ncp-iam-access-key: 11IKBWgQegM4DwiJL4mo"
-H "x-ncp-apigw-timestamp: 1593849262194"
-H "x-ncp-apigw-signature-v2: m/hJOfg92TqzOGyHJ++4vkimGT7un1/4+zLrLTvaVT4="
응답 예시
{
"code": 0,
"message": "요청이 정상적으로 처리되었습니다",
"result": {
"pageSize": 10,
"currentPage": 1,
"totalPage": 1,
"totalCount": 2,
"isPaged": true,
"vpcServerInfos": [
{
"additionalParameterMap": {
"networkInterfaceList": [
{
"attachedDeviceName": "eth0",
"subnet": "172.16.200.0/24",
"vpcName": "vpc",
"macAddress": "FF:FF:FF:FF:FF:FF",
"subnetNo": 600,
"igwYn": "Y",
"vpcNo": 402,
"networkInterfaceNo": 8077,
"internalIp": "123.123.123.123",
"subnetName": "sub",
"networkInterfaceName": "nic-8077"
}
],
"vpcName": "vpc",
"subnetNo": 600,
"igwYn": "Y",
"vpcNo": 402,
"subnetName": "sub"
},
"baseBlockStorageSize": 0,
"carrierNetworkIp": null,
"cncNo": 71,
"computeInstanceDetailTypeCode": null,
"computeInstanceName": null,
"computeInstanceTypeCode": null,
"computeInstanceUuid": null,
"computeSpec": null,
"contractNo": 354946,
"cpuCount": 2,
"createYmdt": 1593756715015,
"feeChargeMonitoringYn": null,
"hostNameInitConfigYn": null,
"instanceNo": 1267544,
"instanceProductType2Code": "STAND",
"instanceStatusCode": "INIT",
"instanceStatusName": "init",
"instanceTypeCode": "VSVR",
"instanceUuid": null,
"ip": null,
"launchDateTime": 0,
"macAddress": null,
"nsiName": "win-2016-64-en",
"operationCode": "NULL",
"operationYmdt": "1593756715015",
"osDiskTypeCode": "NET",
"osDiskTypeDetailCode": "SSD",
"osInformation": "Windows Server 2016 (64-bit) English Edition",
"osName": "Windows Server 2016 (64-bit) English Edition",
"overlayNetworkIp": "132.123.123.213",
"parameters": null,
"platformTypeCode": "WND64",
"productCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B100.G002",
"publicIp": null,
"publicIpInstanceNo": null,
"regionCode": "KR",
"regionName": "Korea",
"regionNo": "1",
"returnProtectionYn": "N",
"serverName": "clatest",
"serverSpec": "[STAND] 2vCPU, 8GB Mem",
"softwareProductCode": "SW.VSVR.OS.WND64.WND.SVR2016EN.B100",
"subnetName": null,
"subAccountNo": 0,
"upTime": null,
"vpcName": null,
"zoneName": "KR-1",
"zoneNo": 2,
"serverStatusColor": "green",
"serverStatusKorean": "운영중",
"serverStatusValue": "운영중",
"isSupportOS": false,
"collectingInfo": {
"collectorAgentVersion": null,
"logTypeCount": 0,
"collectionStatus": "미수집상태",
"settingStatus": "미설정",
"settingStatusColor": "grey",
"servername": "s173134d875e",
"logCollectorDate": null,
"logTypeList": null,
"configKey": null,
"isCollecting": false
}
}
],
"collectingCount": 1
}
}