Cloud Data Streaming Service Cluster の作成(Return ID)

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

VPC環境で利用できます。

説明

Cloud Data Streaming Service Cluster を作成後、serviceGroupInstanceNoを Returnします。

リクエスト

リクエスト URL

POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo [KR]
POST https://clouddatastreamingservice.apigw.ntruss.com/api/sgn-v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo [SGN]
POST https://clouddatastreamingservice.apigw.ntruss.com/api/jpn-v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo [JPN]

リクエストヘッダ

ヘッダ名	説明
x-ncp-apigw-timestamp	- 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表す - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	NAVERクラウドプラットフォームポータルから発行された Access Key ID値 `x-ncp-iam-access-key:{Account Access Key}`
x-ncp-apigw-signature-v2	Access Key ID値と Secret Keyで暗号化した署名 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	Request body content typeを application/jsonに指定 `Content-Type: application/json`

リクエストパラメータ

パラメータ	タイプ	要否	説明
clusterName	String	Y	- クラスタ名 - アルファベット(小文字)、数字、連続しないハイフン(-)のみで構成 - 先頭の文字はアルファベット、末尾の文字はアルファベットまたは数字にします。
kafkaVersionCode	String	Y	- 使用する Cloud Data Streaming Serviceのバージョン - getCDSSVersionアクションを通じて取得可能
kafkaManagerUserName	String	Y	- CMAKアクセス ID - アルファベット(小文字)、数字、連続しないハイフン(-)のみで構成先頭の文字はアルファベット、末尾の文字はアルファベットまたは数字にします。
kafkaManagerUserPassword	String	Y	- CMAKアクセス Password - 8文字以上で、アルファベットの大文字と小文字、特殊文字、数字をそれぞれ1文字以上含みます。
softwareProductCode	String	Y	- 使用する OSタイプ - getOsProductListアクションを通じて取得可能
vpcNo	Integer	Y	- 使用する VPC No - getVpcListアクションを通じて取得可能
managerNodeProductCode	String	Y	- マネージャーノードの HWスペック - getNodeProductListアクションを通じて取得可能
managerNodeSubnetNo	Integer	Y	- マネージャーノードが位置する Subnet No - getSubnetListアクションを通じて取得可能
brokerNodeProductCode	String	Y	- ブローカーノードの HWスペック - getNodeProductListアクションを通じて取得可能
brokerNodeSubnetNo	Integer	Y	- ブローカーノードが位置する Subnet No - getSubnetListアクションを通じて取得可能
brokerNodeCount	Integer	Y	- ブローカーノード数 - 最小3台以上、最大10台まで作成可能
brokerNodeStorageSize	Integer	Y	- ブローカーノードのストレージ容量 - 最小100GB、最大2000GBまで10GB単位で選択可能
configGroupNo	Integer	Y	- 使用する ConfigGroup No - getKafkaVersionConfigGroupListアクションを通じて取得可能

リクエスト例

POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo
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

{
  "clusterName": "test",
  "kafkaVersionCode": "2403005",
  "kafkaManagerUserName": "test",
  "kafkaManagerUserPassword": "qwe123!@#",
  "softwareProductCode": "SW.VCDSS.OS.LNX64.CNTOS.0708.B050",
  "vpcNo": 1236,
  "managerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
  "managerNodeSubnetNo": 1300,
  "brokerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
  "brokerNodeCount": 3,
  "brokerNodeSubnetNo": 1301,
  "brokerNodeStorageSize": 100,
  "configGroupNo": 127
}

curl -X POST "https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo" \
-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=" \
-d \
'{
   "clusterName": "test",
   "kafkaVersionCode": "2403005",
   "kafkaManagerUserName": "test",
   "kafkaManagerUserPassword": "qwe123!@#",
   "softwareProductCode": "SW.VCDSS.OS.LNX64.CNTOS.0708.B050",
   "vpcNo": 1236,
   "managerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
   "managerNodeSubnetNo": 1300,
   "brokerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
   "brokerNodeCount": 3,
   "brokerNodeSubnetNo": 1301,
   "brokerNodeStorageSize": 100,
   "configGroupNo": 127
 }'

レスポンスパラメータ

public class CreateClusterResponseVo {
    Integer serviceGroupInstanceNo;
}

フィールド

パラメータ名	タイプ	説明
serviceGroupInstanceNo	Integer	作成されたクラスタの固有番号

レスポンス例

{
  "code": 0,
  "message": "SUCCESS",
  "result": {
    "serviceGroupInstanceNo": 2435417
  },
  "requestId": "179bf48d-34e7-4a04-ba8c-1d51dee9abef"
}

この記事は役に立ちましたか?

What's Next

Cloud Data Streaming Service Versionの照会

説明
リクエスト
レスポンスパラメータ
フィールド

タグ

Cloud Data Streaming Service