- Print
- PDF
GetMetaServer
- Print
- PDF
The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.
Available in VPC
Get available server information from the Network Traffic Monitoring service.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
GET | /meta/v1/server |
Request headers
For information about the headers common to all Network Traffic Monitoring APIs, see Network Traffic Monitoring request headers.
Request query parameters
You can use the following query parameters with your request:
Field | Type | Required | Description |
---|---|---|---|
page | Integer | Required | Page number
|
size | Integer | Required | Page output count
|
privateIp | String | Optional | Private IP |
publicIp | Integer | Optional | Public IP |
regionCode | String | Optional | Region code
|
serverName | Integer | Optional | Server name |
Request example
The request example is as follows:
curl --location --request GET 'https://vpc-ntm.apigw.ntruss.com/meta/v1/server?regionCode=KR' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-dmn_cd: PUB' \
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
serverList | Array | - | Server list |
total | Integer | - | Number of response results |
serverList
The following describes serverList
.
Field | Type | Required | Description |
---|---|---|---|
networkTrafficMonitoringInstanceNo | Integer | - | Network Traffic Monitoring instance number |
subscribed | Boolean | - | Network Traffic Monitoring subscription status
|
See ServerInstance for more information about the fields related to server information.
Response status codes
For information about the HTTP status codes common to all Network Traffic Monitoring APIs, see Network Traffic Monitoring response status codes.
Response example
The response example is as follows:
{
"total": 7,
"serverList": [
{
"instanceNo": 1777948,
"serverName": "test-code003",
"regionNo": 1,
"regionCode": "KR",
"regionName": "Korea",
"privateIpList": [
"***.***.***.***"
],
"publicIp": null,
"instanceStatusCode": "NSTOP",
"instanceStatusName": "stopped",
"networkTrafficMonitoringInstanceNo": 2094117,
"subscribed": true
},
{
"instanceNo": 1777945,
"serverName": "test-code002",
"regionNo": 1,
"regionCode": "KR",
"regionName": "Korea",
"privateIpList": [
"***.***.***.***"
],
"publicIp": null,
"instanceStatusCode": "RUN",
"instanceStatusName": "running",
"networkTrafficMonitoringInstanceNo": 1808470,
"subscribed": true
}
]
}