Search Cloud Data Streaming Service Cluster node

Article summary

Did you find this summary helpful?

Thank you for your feedback

Can be used in a VPC environment.

Description

Search a Cloud Data Streaming Service Cluster's node.

Request

Request URL

GET https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getClusterNodeList/{service-group-instance-no} [KR]
GET https://clouddatastreamingservice.apigw.ntruss.com/api/sgn-v1/cluster/getClusterNodeList/{service-group-instance-no} [SGN]
GET https://clouddatastreamingservice.apigw.ntruss.com/api/jpn-v1/cluster/getClusterNodeList/{service-group-instance-no} [JPN]

Request headers

Header	Description
x-ncp-apigw-timestamp	This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. If the time difference compared to the API Gateway server is more than 5 minutes, then the request is considered invalid. `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	This is the Access Key ID value issued by the Naver Cloud Platform. `x-ncp-iam-access-key:{Account Access Key}`
x-ncp-apigw-signature-v2	This is the signature encrypted Access Key ID value and Secret Key. `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	Specifies the request body content type as application/json `Content-Type: application/json`

Request parameters

Parameter	Type	Required status	Description
serviceGroupInstanceNo	String	Y	This is the cluster number to search the list of broker nodes.

Request example

GET https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getClusterNodeList/1484848
HOST: clouddatastreamingservice.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw

curl -X GET "https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getClusterNodeList/1484848" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw" \
-H "x-ncp-apigw-timestamp: 1601971222179" \
-H "x-ncp-apigw-signature-v2: zrCelnR48AADdK/uh6Xe3yy468i8KpQoewYHUmeqYh4="

Response parameters

public class GetClusterDataNodeList {
    List<GetDataNodeListResponseDetailVo> computeList;
    Integer contractNo;
    DateTimeVo createdDate;
    String productCode;
    Integer regionNo;
    Integer serviceGroupInstanceNo;
    String serviceGroupInstanceTypeCode;
    String serviceGroupName;
    String statusCode;
    Integer vpcNo;
}

public class GetDataNodeListResponseDetailVo {
    Integer computeInstanceNo;
    String computeInstanceProductCode;
    String computeInstanceStatus;
    Integer cpuCount;
    DateTimeVo createdYmdt;
    String hostName;
    String macAddress;
    Long memorySize;
    String nodeRoleCode;
    DateTimeVo operationYmdt;
    String osInfo;
    String privateIp;
    String regionCode;
    String regionName;
    String regionNo;
    Boolean selfManaged;
    Integer serviceGroupInstanceNo;
    String uuid;
    String vpcName;
    Integer vpcNo;
    String subnetName;
    Integer subnetNo;
    String zoneName;
    Integer zoneNo;
}

public class DateTimeVo {
    Date formattedDate;
    Date formattedDateTime;
    Long utc;
}

Field

Parameter name	Type	Description
computeList	List	List of data nodes
contractNo	Integer	Contract number
createdDate	DateTimeVo	Cluster creation date
productCode	String	OS product code
regionNo	Integer	Number of a region where the server is located
serviceGroupInstanceNo	Integer	Cluster instance number
serviceGroupInstanceTypeCode	String	Cluster instance type
serviceGroupName	String	Cluster name
statusCode	String	Instance status code
vpcNo	Integer	Number of a VPC where the server is located
computeInstanceNo	Integer	Server instance number
computeInstanceProductCode	String	Server instance HW product code
computeInstanceStatus	String	Server instance status code
cpuCount	Integer	Number of vCPUs
createdYmdt	DateTimeVo	Server creation date
hostName	String	Server instance name
macAddress	String	Server instance MAC address
memorySize	Long	Memory size in Bytes
nodeRoleCode	String	Server rule code
operationYmdt	DateTimeVo	Server operation time
osInfo	String	OS information
privateIp	String	Private IP address
regionCode	String	Code of the region where the server is located
regionName	String	Name of the region where the server is located
regionNo	String	Number of the region where the server is located
selfManaged	Boolean	Console Server tab exposure status
serviceGroupInstanceNo	Integer	Cluster instance number
uuid	String	Server instance unique ID
vpcName	String	Name of the VPC where the server is located
vpcNo	Integer	Number of the VPC where the server is located
subnetName	String	Name of the subnet where the server is located
subnetNo	Integer	Number of the subnet where the server is located
zoneName	String	Name of the zone where the server is located
zoneNo	Integer	Number of the zone where the server is located
formattedDate	Date	Creation date
formattedDateTime	Date	Creation date and time
utc	Long	Convert the UTC time created into milliseconds

Response example

{
  "code": 0,
  "message": "SUCCESS",
  "result": {
    "contractNo": 525810,
    "createdDate": {
      "formattedDate": "2020-10-26",
      "formattedDateTime": "2020-10-26 11:54:35 000861",
      "utc": 1603680875861
    },
    "productCode": "SW.VCDSS.OS.LNX64.CNTOS.0703.B050",
    "regionNo": 1,
    "serviceGroupInstanceNo": 1509943,
    "serviceGroupInstanceTypeCode": "VCDSS",
    "serviceGroupName": "tesss",
    "statusCode": "CREAT",
    "vpcNo": 1236,
    "computeList": [
      {
        "computeInstanceNo": 1509944,
        "computeInstanceProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
        "computeInstanceStatus": "running",
        "cpuCount": 2,
        "createdYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:54:36 000998",
          "utc": 1603680876998
        },
        "hostName": "tesss-m-4hp",
        "macAddress": "F2:20:AF:F6:9F:BC",
        "memorySize": 4294967296,
        "nodeRoleCode": "M",
        "operationYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:57:10 000490",
          "utc": 1603681030490
        },
        "osInfo": "CentOS 7.3 (64-bit)",
        "privateIp": "10.0.0.12",
        "regionCode": "KR",
        "regionName": "Korea",
        "regionNo": "1",
        "selfManaged": false,
        "serviceGroupInstanceNo": 1509943,
        "uuid": "12a8d0f1-fda4-3959-ccf1-691e25e9ad2e",
        "vpcName": "clean",
        "vpcNo": 1236,
        "subnetNo": 1300,
        "subnetName": "clean-pub | KR-1",
        "zoneName": "KR-1",
        "zoneNo": 2
      },
      {
        "computeInstanceNo": 1509947,
        "computeInstanceProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
        "computeInstanceStatus": "running",
        "cpuCount": 2,
        "createdYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:54:37 000208",
          "utc": 1603680877208
        },
        "hostName": "tesss-b-4hq",
        "macAddress": "F2:20:AF:F6:AB:08",
        "memorySize": 4294967296,
        "nodeRoleCode": "B",
        "operationYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:57:03 000913",
          "utc": 1603681023913
        },
        "osInfo": "CentOS 7.3 (64-bit)",
        "privateIp": "10.0.1.29",
        "regionCode": "KR",
        "regionName": "Korea",
        "regionNo": "1",
        "selfManaged": false,
        "serviceGroupInstanceNo": 1509943,
        "uuid": "81f18061-de79-b34e-b99d-8719d0446c76",
        "vpcName": "clean",
        "vpcNo": 1236,
        "subnetNo": 1301,
        "subnetName": "clean-private | KR-1",
        "zoneName": "KR-1",
        "zoneNo": 2
      },
      {
        "computeInstanceNo": 1509951,
        "computeInstanceProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
        "computeInstanceStatus": "running",
        "cpuCount": 2,
        "createdYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:54:37 000355",
          "utc": 1603680877355
        },
        "hostName": "tesss-b-4hr",
        "macAddress": "F2:20:AF:F6:B1:36",
        "memorySize": 4294967296,
        "nodeRoleCode": "B",
        "operationYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:57:32 000832",
          "utc": 1603681052832
        },
        "osInfo": "CentOS 7.3 (64-bit)",
        "privateIp": "10.0.1.30",
        "regionCode": "KR",
        "regionName": "Korea",
        "regionNo": "1",
        "selfManaged": false,
        "serviceGroupInstanceNo": 1509943,
        "uuid": "2a9bfb2b-e3f1-51cf-0194-f16bc869ca00",
        "vpcName": "clean",
        "vpcNo": 1236,
        "subnetNo": 1301,
        "subnetName": "clean-private | KR-1",
        "zoneName": "KR-1",
        "zoneNo": 2
      },
      {
        "computeInstanceNo": 1509955,
        "computeInstanceProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
        "computeInstanceStatus": "running",
        "cpuCount": 2,
        "createdYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:54:37 000486",
          "utc": 1603680877486
        },
        "hostName": "tesss-b-4hs",
        "macAddress": "F2:20:AF:F6:BF:D3",
        "memorySize": 4294967296,
        "nodeRoleCode": "B",
        "operationYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 11:57:44 000697",
          "utc": 1603681064697
        },
        "osInfo": "CentOS 7.3 (64-bit)",
        "privateIp": "10.0.1.31",
        "regionCode": "KR",
        "regionName": "Korea",
        "regionNo": "1",
        "selfManaged": false,
        "serviceGroupInstanceNo": 1509943,
        "uuid": "ea1030f6-3a37-0ef8-6b0b-426d759d69ff",
        "vpcName": "clean",
        "vpcNo": 1236,
        "subnetNo": 1301,
        "subnetName": "clean-private | KR-1",
        "zoneName": "KR-1",
        "zoneNo": 2
      },
      {
        "computeInstanceNo": 1509998,
        "computeInstanceProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
        "computeInstanceStatus": "running",
        "cpuCount": 2,
        "createdYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 14:06:37 000001",
          "utc": 1603688797001
        },
        "hostName": "tesss-b-4ht",
        "macAddress": "F2:20:AF:F6:C9:E6",
        "memorySize": 4294967296,
        "nodeRoleCode": "B",
        "operationYmdt": {
          "formattedDate": "2020-10-26",
          "formattedDateTime": "2020-10-26 14:09:08 000830",
          "utc": 1603688948830
        },
        "osInfo": "CentOS 7.3 (64-bit)",
        "privateIp": "10.0.1.32",
        "regionCode": "KR",
        "regionName": "Korea",
        "regionNo": "1",
        "selfManaged": false,
        "serviceGroupInstanceNo": 1509943,
        "uuid": "26ec215d-9673-3c90-1dec-7f14c956b880",
        "vpcName": "clean",
        "vpcNo": 1236,
        "subnetNo": 1301,
        "subnetName": "clean-private | KR-1",
        "zoneName": "KR-1",
        "zoneNo": 2
      }
    ]
  },
  "requestId": "026d8c36-5af9-4998-8d43-dfd1111865ed"
}

Was this article helpful?

What's Next

Cloud Data Streaming Service Cluster Get an ACG

Table of contents

Description
Request
Response parameters
Field