ニフクラAPI (Kubernetes Service Hatoba: CreateNodePool)

CreateNodePool

処理概要

ノードプールを作成します。

リクエストURL

POST /v1/clusters/{ClusterName}/nodePools

指定するパラメーター

パスパラメーター

パラメーター	型	説明	必須
ClusterName	string	ノードプールを属させたいクラスター名	○

リクエストボディ

パラメーター	型	説明	必須
nodePool	object
␣name	string	ノードプール名 使用可能文字: 半角英数小文字またはハイフン（先頭と末尾を除く）40文字以内	○
␣instanceType	string	ノードプール内に作成するノードのサーバータイプ 値: c-medium e-medium medium c-medium4 e-medium4 medium4 c-medium8 e-medium8 medium8 e-medium16 medium16 e-medium24 medium24 c-large e-large large c-large8 e-large8 large8 e-large16 large16 e-large24 large24 e-large32 large32 e-extra-large8 extra-large8 e-extra-large16 extra-large16 e-extra-large24 extra-large24 e-extra-large32 extra-large32 e-extra-large48 extra-large48 e-double-large16 double-large16 e-double-large24 double-large24 e-double-large32 double-large32 e-double-large48 double-large48 e-double-large64 double-large64 e-double-large96 double-large96	○
␣nodeCount	integer	ノードプール内に作成するノードの数 Default: 1
␣tags[]	object[]
␣␣key	string	付与したいタグキー 使用可能文字: UTF-8で全角半角128文字以内
␣␣value	string	付与したいタグ値 使用可能文字: UTF-8で全角半角256文字以内

応答フィールド

フィールド (項目)	型	説明
nodePool	object
␣name	string	ノードプール名
␣instanceType	string	ノードプール内のノードのサーバータイプ
␣nodeCount	integer	ノードプール内の現在のノード数
␣initialNodeCount	integer	ノードプール作成時に設定したノードプール内のノード数
␣status	string	ノードプールのステータス 値: PROVISIONING (ノードプール作成中) RUNNING (稼働中) RUNNING_WITH_ERROR (一部ノードでエラーが発生中) RECONCILING (設定変更中) STOPPING (削除中) ERROR (エラー)
␣nodes[]	object[]
␣␣name	string	ノード名
␣␣availabilityZone	string	ノードのゾーン情報
␣␣publicIpAddress	string	グローバルIPアドレス
␣␣privateIpAddress	string	プライベートIPアドレス
␣␣status	string	ノードのステータス 値: PROVISIONING (ノード作成中) RUNNING (稼働中) RECONCILING (設定変更中) STOPPING (削除中) ERROR (エラー)
␣nrn	string	NRN
␣tags[]	object[]
␣␣id	string	タグID
␣␣key	string	タグキー
␣␣value	string	タグ値

リクエストサンプル

    curl -XPOST https://jp-east-1.hatoba.api.nifcloud.com/v1/clusters/cluster01/nodePools
  -H "X-Amz-Date: 20190724T000000Z"
  -H "Authorization: AWS4-HMAC-SHA256 ..."
  -d {
    "nodePool": {
      "name": "nodepool02",
      "instanceType": "medium",
      "nodeCount": 1,
      "tags": [
        {
          "key": "key01",
          "value": "value01"
        }
      ]
    }
  }

  

応答サンプル

    {
  "nodePool": {
    "name": "nodepool02",
    "instanceType": "medium",
    "nodeCount": 1,
    "initialNodeCount": 1,
    "status": "PROVISIONING",
    "nodes": [
      {
        "name": "nodepool02-ek9xe1",
        "availabilityZone": "east-11",
        "publicIpAddress": "",
        "privateIpAddress": "",
        "status": "PROVISIONING"
      }
    ],
    "nrn": "nrn:nifcloud:hatoba:jp-east-1:xxxxxxxx:node-pool:c22fa663-0502-45cc-894d-dccfdcd3c20d",
    "tags": [
      {
        "id": "31fac2be-013e-4702-b5ba-5d49b7d8e7b7",
        "key": "key01",
        "value": "value01"
      }
    ]
  }
}