GetMetaServer
- Print
- PDF
GetMetaServer
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
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
|
Note
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
}
]
}
Was this article helpful?