- Print
- PDF
Cloud Data Streaming Service
- Print
- PDF
Available in Classic and VPC
Get the list of Cloud Data Streaming Service server instances (VMs) in the VPC environment.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
GET | /api/{regionCode}-v1/vpc/servers/cdss |
Request headers
For information about the headers common to all Cloud Log Analytics APIs, see Cloud Log Analytics request headers.
Request path parameters
You can use the following path parameters with your request:
Field | Type | Required | Description |
---|---|---|---|
regionCode | String | Required | Region code
|
Request query parameters
You can use the following path parameters with your request:
Field | Type | Required | Description |
---|---|---|---|
pageNo | Integer | Optional | Page number
|
pageSize | Integer | Optional | Number of items per page
|
Request example
The request example is as follows:
curl --location --request GET 'https://cloudloganalytics.apigw.ntruss.com/api/{regionCode}-v1/vpc/servers/cdss' \
--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' \
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
code | Integer | - | Response status codes |
message | String | - | Response status message |
result | Object | - | Response result |
result.pageSize | Integer | - | Number of items per page |
result.currentPage | Integer | - | Current page number |
result.totalPage | Integer | - | Total number of pages |
result.totalCount | Integer | - | Total item count |
result.isPaged | Boolean | - | Whether to page
|
result.clusterInfoList | Array | - | Server list
|
For more information about the fields related to server information (clusterInfoList
), see the Cloud Data Streaming Service API Guide and Cloud Data Streaming Service User Guide.
Response status codes
For response status codes common to all Cloud Log Analytics APIs, see Cloud Log Analytics response status codes.
Response example
The response example is as follows:
{
"code": 0,
"message": "The request has been successfully processed.",
"result": {
"pageSize": 10,
"currentPage": 1,
"totalPage": 1,
"totalCount": 1,
"isPaged": true,
"clusterInfoList": [
{
"clusterName": "cdss-test",
"serverStatus": "In operation",
"serverStatusColor": "green",
"kafkaVersion": "3.7.1",
"vpcName": "test"
}
]
}
}