すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:CreateClusterNodePool

    ドキュメントセンター

    Container Service for Kubernetes:CreateClusterNodePool

    最終更新日:Aug 21, 2026

    ノードプールは、同じ属性を共有するノードの論理的なコレクションです。ノードプールを使用すると、ノードのスペックアップや弾力的スケーリングなど、ノードの一元的な管理と運用保守が可能になります。さらに、OS の CVE 脆弱性の自動パッチ適用、エラーノードの自動復旧、kubelet および containerd バージョンの自動スペックアップなど、ノードプールの自動化された運用保守機能を活用して、運用保守コストを削減できます。CreateClusterNodePool を呼び出して、クラスターのコンテナノードプールを作成できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    cs:CreateClusterNodePool

    create

    *Cluster

    acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

    		 なし なし

    リクエスト構文

    POST /clusters/{ClusterId}/nodepools HTTP/1.1

    パスパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClusterId

    string

    必須

    クラスターの ID。

    c61da77e8bfbc4c4c999af2b51b65****

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    body

    object

    任意

    リクエストボディのパラメーター。

    nodepool_info

    object

    任意

    ノードプールの構成。

    name

    string

    必須

    ノードプールの名前。

    nodepool-test
    type

    string

    任意

    ノードプールのタイプ。有効な値:

    • ess: 通常ノードプール (マネージド特徴と弾力的スケーリングを含む)。

    • edge: エッジノードプール。

    • lingjun: Lingjun ノードプール。

    • hybrid: ハイブリッドクラウドノードプール。

    列挙値:

    • lingjun :

      Lingjun ノードプール。

    • edge :

      エッジノードプール。

    • ess :

      通常ノードプール。

    ess
    resource_group_id

    string

    任意

    ノードプールのリソースグループの ID。ノードプールによってスケールアウトされたインスタンスは、このリソースグループに属します。

    1 つのリソースは 1 つのリソースグループにのみ属することができます。異なるビジネスシナリオに基づいて、リソースグループをプロジェクト、アプリケーション、組織などの概念にマッピングできます。

    rg-acfmyvw3wjmb****
    auto_scaling

    object

    任意

    弾力的スケーリングの構成。

    enable

    boolean

    任意

    自動スケーリングを有効にするかどうかを指定します。有効な値:

    • true: ノードプールの自動スケーリング特徴を有効にします。クラスターの容量計画がアプリケーション Pod のスケジューリング要件を満たせない場合、ACK は設定された最小値および最大値のインスタンス数に基づいてノードリソースを自動的にスケーリングします。バージョン 1.24 以降のクラスターでは、デフォルトで即時ノードスケーリングが有効になります。1.24 より前のバージョンのクラスターでは、デフォルトで自動ノードスケーリングが有効になります。詳細については、「ノードスケーリング」を参照してください。

    • false: 自動スケーリングを無効にします。ACK は、設定された希望ノード数に基づいてノードプール内のノード数を調整し、ノード数を希望の数に維持します。

    値が false の場合、auto_scaling 内の他の構成パラメーターは効果を持ちません。

    デフォルト値: false。

    false
    type

    string

    任意

    弾力的スケーリングのインスタンスタイプ。このパラメーターは enable=true の場合にのみ効果を持ちます。有効な値:

    • cpu: 通常のインスタンスタイプ。

    • gpu: GPU インスタンスタイプ。

    • gpushare: GPU 共有タイプ。

    • spot: スポットインスタンスタイプ。

    デフォルト値: cpu。

    重要 このパラメーターは、ノードプールの作成後に変更済みにはできません。

    列挙値:

    • spot :

      スポットインスタンスタイプ。

    • cpu :

      通常のインスタンスタイプ。

    • gpushare :

      GPU 共有タイプ。

    • gpu :

      GPU インスタンスタイプ。

    cpu
    max_instances

    integer

    任意

    既存のインスタンスを除く、ノードプール内でスケーラブルなインスタンスの最大値。このパラメーターは enable=true の場合にのみ効果を持ちます。

    有効値: [min_instances, 2000]。デフォルト値: 0。

    10
    min_instances

    integer

    任意

    既存のインスタンスを除く、ノードプール内でスケーラブルなインスタンスの最小値。このパラメーターは enable=true の場合にのみ効果を持ちます。

    有効値: [0, max_instances]。デフォルト値: 0。

    説明

    • インスタンスの最小数が 0 でない場合、スケーリンググループは有効化後に該当する数の ECS インスタンスを自動的に作成します。

    • インスタンスの最大数には、ノードプール内の現在のノード数以上の値を設定してください。そうしないと、弾力的スケーリング特徴が有効化された直後にノードプールのノードスケールインがトリガーされます。

    1
    is_bond_eip deprecated

    boolean

    任意

    [非推奨] このパラメーターは非推奨です。代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

    EIP を関連付けるかどうかを指定します。有効な値:

    • true: EIP を関連付けます。

    • false: EIP を関連付けません。

    デフォルト値: false。

    null
    eip_internet_charge_type deprecated

    string

    任意

    [非推奨] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

    EIP の課金方法。有効な値:

    • PayByBandwidth: 固定帯域幅課金。

    • PayByTraffic: データ転送量課金。

    デフォルト値: PayByBandwidth。

    null
    eip_bandwidth deprecated

    integer

    任意

    [非推奨] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

    EIP のピーク帯域幅。単位: Mbit/s。

    null
    management

    object

    任意

    マネージドノードプール機能の構成。

    enable

    boolean

    任意

    マネージドノードプール機能を有効にするかどうかを指定します。有効な値:

    • true: 有効。

    • false: 無効。他の関連する構成は、enable が true に設定されている場合にのみ有効になります。

    デフォルト値: false。

    false
    auto_repair

    boolean

    任意

    ノードの自動修復を有効にするかどうかを指定します。このパラメーターは enable=true の場合にのみ有効になります。

    • true: 有効。

    • false: 無効。

    デフォルト値: true。

    true
    auto_repair_policy

    object

    任意

    ノードの自動修復ポリシー。

    restart_node

    boolean

    任意

    ノードの再起動を許可するかどうかを指定します。このパラメーターは auto_repair=true の場合にのみ有効になります。有効な値:

    • true: ノードの再起動が許可されます。

    • false: ノードの再起動は許可されません。

    デフォルト値: true。

    true
    approval_required

    boolean

    任意

    ノード修復に手動承認が必要かどうかを指定します。

    max_parallel_repairing_nodes

    string

    任意

    並列修復可能な最大ノード数。ノードプール内に多数の異常なノードが存在する場合、このパラメーターは同時に修復できるノードの最大数または割合を指定します。数値 (例: 5、有効値: 1～100000) またはパーセンテージ (例: 10%、有効値: 1%～100%) を指定できます。デフォルト値: 1。

    5
    max_unhealthy_nodes_threshold

    string

    任意

    自己修復サーキットブレーカーのしきい値。エラーのあるノードの数または割合がこのしきい値を超えると、自己修復はサーキットブレーカー状態に入り、新しい修復アクションの開始を停止します。数値 (例: 10、有効値: 1～100000) またはパーセンテージ (例: 20%、有効値: 1%～100%) を指定できます。デフォルト値: 100%。

    20%
    auto_vul_fix

    boolean

    任意

    CVE 脆弱性の自動修復を有効にするかどうかを指定します。このパラメーターは enable=true の場合にのみ有効になります。

    • true: CVE の自動修復が有効です。

    • false: CVE の自動修復が無効です。

    デフォルト値: true。

    true
    auto_vul_fix_policy

    object

    任意

    CVE の自動修復ポリシー。

    restart_node

    boolean

    任意

    ノードの再起動を許可するかどうかを指定します。このパラメーターは auto_vul_fix=true の場合にのみ有効になります。有効な値:

    • true: ノードの再起動が許可されます。

    • false: ノードの再起動は許可されません。

    デフォルト値: true。

    false
    vul_level

    string

    任意

    自動修復を許可する脆弱性レベルをカンマ区切りで指定します。例: asap,later。有効な値:

    • asap: 高

    • later: 中間

    • nntf: 低

    デフォルト値: asap。

    asap,nntf
    exclude_packages

    string

    任意

    脆弱性修復中に除外するパッケージ。

    デフォルト値: kernel。

    kernel
    auto_upgrade

    boolean

    任意

    ノードの自動アップグレードを有効にするかどうかを指定します。このパラメーターは enable=true の場合にのみ有効になります。

    • true: 自動アップグレードが有効です。

    • false: 自動アップグレードが無効です。

    デフォルト値: true。

    true
    auto_upgrade_policy

    object

    任意

    ノードの自動アップグレードポリシー。

    auto_upgrade_kubelet

    boolean

    任意

    kubelet の自動アップグレードを許可するかどうかを指定します。このパラメーターは auto_upgrade=true の場合にのみ有効になります。有効な値:

    • true: kubelet の自動アップグレードが許可されます。

    • false: kubelet の自動アップグレードは許可されません。

    デフォルト値: true。

    true
    auto_upgrade_runtime

    boolean

    任意

    ランタイムの自動アップグレードを許可するかどうかを指定します。このパラメーターは auto_upgrade=true の場合にのみ有効になります。有効な値:

    • true: ランタイムの自動アップグレードが許可されます。

    • false: ランタイムの自動アップグレードは許可されません。

    デフォルト値: true。

    false
    auto_upgrade_os

    boolean

    任意

    オペレーティングシステムの自動スペックアップを許可するかどうかを指定します。このパラメーターは auto_upgrade=true の場合にのみ有効になります。有効な値:

    • true: OS の自動スペックアップが許可されます。

    • false: OS の自動スペックアップは許可されません。

    デフォルト値: false。

    false
    upgrade_config deprecated

    object

    任意

    [非推奨] 代わりに上位レベルの auto_upgrade パラメーターを使用してください。

    自動スペックアップの構成。このパラメーターは enable=true の場合にのみ有効になります。

    auto_upgrade deprecated

    boolean

    任意

    [非推奨] 代わりに上位レベルの auto_upgrade パラメーターを使用してください。

    自動スペックアップを有効にするかどうかを指定します。有効な値:

    • true: 自動スペックアップが有効です。

    • false: 自動スペックアップが無効です。

    null
    surge

    integer

    任意

    追加ノードの数。このパラメーターまたは surge_percentage のいずれかを指定できます。

    アップグレード中はノードが使用できなくなります。クラスターのワークロードを補うために追加ノードを作成できます。

    説明

    追加ノードの数は現在のノード数を超えないようにしてください。

    0
    surge_percentage

    integer

    任意

    追加ノードの割合。このパラメーターまたは surge のいずれかを指定できます。

    追加ノード数 = 追加ノードの割合 × ノード数。たとえば、追加ノードの割合が 50% に設定されており、6 つのノードが存在する場合、追加ノード数 = 50% × 6 = 3 となります。

    0
    max_unavailable

    integer

    任意

    利用不可となるノードの最大数。 有効値: [1,1000]。

    デフォルト値: 1。

    1
    auto_fault_diagnosis

    boolean

    任意

    ノードの自己修復のために ECS 障害検出を有効にするかどうかを指定します。

    drift_enabled

    boolean

    任意

    ノードローテーションを有効にするかどうかを指定します。インテリジェントマネージドノードプールのみがこの機能をサポートしており、デフォルトで有効になっています。通常のノードプールはこの機能をサポートしていません。

    scaling_group

    object

    任意

    ノードプールのスケーリンググループ構成。

    vswitch_ids

    array

    必須

    vSwitch ID のリスト。有効な値: [1,8]。

    説明

    高可用性を確保するため、異なるゾーンの vSwitch を選択してください。

    string

    任意

    vSwitch の ID。

    vsw-wz9mfnhmssud6eicu****
    instance_types

    array

    必須

    ノードプールのインスタンスタイプのリスト。ノードプールがスケールアウトする際、このリストから要件を満たすインスタンスタイプに基づいてインスタンスが作成されます。

    サポートされるインスタンスタイプの有効値は 1 から 10 です。

    説明

    高可用性を確保するため、複数のインスタンスタイプを指定してください。

    string

    任意

    インスタンスタイプ。詳細については、「インスタンスファミリー」を参照してください。

    ecs.d1ne.2xlarge
    instance_charge_type

    string

    必須

    ノードプール内のノードの課金方法。有効な値:

    • PrePaid: サブスクリプション。

    • PostPaid: 従量課金。

    デフォルト値: PostPaid。

    列挙値:

    • PostPaid :

      従量課金インスタンス。

    • PrePaid :

      サブスクリプションインスタンス。

    PostPaid
    period

    integer

    任意

    ノードプール内のインスタンスのサブスクリプション期間。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ効果が適用され、必須となります。

    • period_unit=Week の場合、period の有効な値: {1, 2, 3, 4}。

    • period_unit=Month の場合、period の有効な値: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}。

    1
    period_unit

    string

    任意

    ノードプール内のインスタンスの課金エポック。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ効果が適用され、必須となります。

    • Month: 計算ユニット (CU) として月を使用します。

    • Week: 計算ユニット (CU) として週を使用します。

    デフォルト値: Month。

    Month
    auto_renew

    boolean

    任意

    ノードプール内のインスタンスの自動更新を有効にするかどうかを指定します。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ効果が適用されます。有効な値:

    • true: 自動更新を有効にします。

    • false: 自動更新を無効にします。

    デフォルト値: false。

    true
    auto_renew_period

    integer

    任意

    1 回の更新あたりの自動更新期間。有効な値:

    • PeriodUnit=Week: 1, 2, 3。

    • PeriodUnit=Month: 1, 2, 3, 6, 12, 24, 36, 48, 60。

    デフォルト値: 1。

    1
    spot_strategy

    string

    任意

    スポットインスタンスのタイプ。有効な値:

    • NoSpot: 非スポットインスタンス。

    • SpotWithPriceLimit: 値幅制限付きスポットインスタンス。

    • SpotAsPriceGo: システムが現在の市場価格で自動的に呼び出しを行います。

    詳細については、「スポットインスタンス」を参照してください。

    NoSpot
    spot_price_limit

    array<object>

    任意

    現在のスポットインスタンスタイプの値幅制限構成。

    object

    任意

    スポットインスタンスの値幅制限構成。インスタンスタイプごとに異なる値幅制限を設定できます。

    instance_type

    string

    任意

    スポットインスタンスのインスタンスタイプ。

    ecs.c6.large
    price_limit

    string

    任意

    インスタンスあたりの最大価格。

    単位: USD/時間。

    0.39
    image_type

    string

    任意

    オペレーティングシステムイメージのタイプ。有効な値:

    • AliyunLinux: Alinux2 イメージ。

    • AliyunLinuxSecurity: Alinux2 UEFI イメージ。

    • AliyunLinux3: Alinux3 イメージ。

    • AliyunLinux3Arm64: Alinux3 ARM イメージ。

    • AliyunLinux3Security: Alinux3 UEFI イメージ。

    • CentOS: CentOS イメージ。

    • Windows: Windows イメージ。

    • WindowsCore: WindowsCore イメージ。

    • ContainerOS: コンテナ最適化イメージ。

    • AliyunLinux3ContainerOptimized: Alinux3 コンテナ最適化イメージ。

    AliyunLinux3
    image_id

    string

    任意

    カスタムイメージ ID。デフォルトでは、システム提供のイメージが使用されます。

    aliyun_2_1903_x64_20G_alibase_20200529.vhd
    system_disk_category

    string

    任意

    ノードのシステムクラウドディスクのタイプ。有効な値:

    • cloud_efficiency: Ultra クラウドディスク。

    • cloud_ssd: 標準 SSD。

    • cloud_essd: ESSD。

    • cloud_auto: ESSD AutoPL クラウドディスク。

    • cloud_essd_entry: ESSD Entry クラウドディスク。

    デフォルト値: cloud_efficiency。

    cloud_efficiency
    system_disk_categories

    array

    任意

    システムクラウドディスクの複数クラウドディスクタイプ。優先度が最も高いクラウドディスクタイプが利用できない場合、システムは自動的に次の優先度のクラウドディスクタイプを試してシステムクラウドディスクを作成します。

    string

    任意

    ノードの複数のシステムクラウドディスクタイプ。

    有効な値:

    • cloud: 基本クラウドディスク。

    • cloud_efficiency: Ultra クラウドディスク。

    • cloud_ssd: 標準 SSD。

    • cloud_essd: ESSD。

    • cloud_auto: ESSD AutoPL クラウドディスク。

    • cloud_essd_entry: ESSD Entry ディスク。

    cloud_essd
    system_disk_size

    integer

    任意

    ノードのシステムクラウドディスクのサイズ。単位: GiB。

    有効な値: [20,2048]。

    120
    system_disk_performance_level

    string

    任意

    ノードのシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクに対してのみ効果が適用されます。パフォーマンスレベルはクラウドディスクのサイズによって異なります。詳細については、「ESSD クラウドディスク」を参照してください。

    • PL0: 中程度の最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが比較的安定しています。

    • PL1: 中程度の最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが比較的安定しています。

    • PL2: 高い最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが安定しています。

    • PL3: 超高い最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが極めて安定しています。

    PL1
    system_disk_encrypted

    boolean

    任意

    システムクラウドディスクを暗号化するかどうかを指定します。有効な値:

    • true: システムクラウドディスクを暗号化します。

    • false: システムクラウドディスクを暗号化しません。

    false
    system_disk_kms_key_id

    string

    任意

    システムクラウドディスクで使用される KMS キー ID。

    0e478b7a-4262-4802-b8cb-00d3fb40****
    system_disk_encrypt_algorithm

    string

    任意

    システムクラウドディスクを暗号化する際に使用される暗号化アルゴリズム。有効な値: aes-256。

    aes-256
    system_disk_bursting_enabled

    boolean

    任意

    ノードのシステムクラウドディスクのバーストパフォーマンスを有効にするかどうかを指定します。有効な値:

    • true: バーストパフォーマンスを有効にします。

    • false: バーストパフォーマンスを無効にします。

    このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL クラウドディスク」を参照してください。

    true
    system_disk_provisioned_iops

    integer

    任意

    ノードのシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。

    有効な値: 0~min{50,000, 1000*capacity-baseline performance}。ベースラインパフォーマンス=min{1,800+50*capacity, 50000}。

    このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL クラウドディスク」を参照してください。

    1000
    data_disks

    array

    任意

    ノードプール内のノードのデータクラウドディスク構成。

    data_disk

    任意

    データクラウドディスクの構成。

    security_group_ids

    array

    任意

    セキュリティグループ ID のリスト。このパラメーターは security_group_id と相互排他です。代わりに security_group_ids を使用してください。security_group_id と security_group_ids の両方が指定されている場合、security_group_ids が優先されます。

    string

    任意

    セキュリティグループ ID のリスト。このパラメーターは security_group_id と相互排他です。代わりに security_group_ids を使用してください。security_group_id と security_group_ids の両方が指定されている場合、security_group_ids が優先されます。

    sg-wz9a8g2mt6x5ll******
    key_pair

    string

    任意

    パスワードなしログイン用のキーペアの名前。このパラメーターは login_password と相互排他です。

    説明

    ノードプールが ContainerOS オペレーティングシステムを使用している場合、key_pair のみがサポートされます。

    np-key-name
    login_password

    string

    任意

    SSH ログインパスワード。このパラメーターは key_pair と相互排他です。パスワードの長さは 8〜30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。

    ****
    login_as_non_root

    boolean

    任意

    スケールアウトされた ECS インスタンスに非ルートユーザーとしてログインするかどうかを指定します。

    • true: 非ルートユーザー (ecs-user) としてログインします。

    • false: ルートユーザーとしてログインします。

    true
    cis_enabled deprecated

    boolean

    任意

    [非推奨] 代わりに security_hardening_os パラメーターを使用してください。

    null
    soc_enabled

    boolean

    任意

    MLPS 2.0 セキュリティ強化を有効にするかどうかを指定します。このパラメーターは、システムイメージが Alibaba Cloud Linux 2 または Alibaba Cloud Linux 3 の場合にのみ使用できます。Alibaba Cloud は、Alibaba Cloud Linux 2 および Alibaba Cloud Linux 3 の MLPS 2.0 Level 3 イメージに対して、等級保護コンプライアンスベースラインチェック基準およびスキャンプログラムを提供しています。

    false
    security_hardening_os

    boolean

    任意

    Alibaba Cloud OS セキュリティ強化を有効にするかどうかを指定します。有効な値:

    • true: Alibaba Cloud OS セキュリティ強化を有効にします。

    • false: Alibaba Cloud OS セキュリティ強化を無効にします。

    デフォルト値: false。

    false
    internet_charge_type

    string

    任意

    パブリック IP アドレスの課金方法。有効な値:

    • PayByBandwidth: 帯域幅課金。

    • PayByTraffic: トラフィック課金。

    PayByTraffic
    internet_max_bandwidth_out

    integer

    任意

    ノードの最大アウトバウンドパブリック帯域幅。単位: Mbit/s。有効な値: [1,100]。

    5
    tags

    array<object>

    任意

    ECS インスタンスにのみ追加されるタグ。

    タグキーは重複できず、最大 128 文字まで指定できます。タグキーおよびタグ値は、"aliyun" または "acs:" で始まることや、"https://" または "http://" を含むことはできません。

    object

    任意

    ノードのタグ。

    key

    string

    任意

    タグキー。

    node-k-1
    value

    string

    任意

    タグ値。

    node-v-1
    desired_size

    integer

    任意

    ノードプール内の希望ノード数。

    ノードプールが維持すべきノードの総数です。クラスターコンポーネントが正常に動作することを保証するため、少なくとも 2 つのノードを設定することを推奨します。希望ノード数を調整することで、ノードプールをスケールインまたはスケールアウトできます。

    ノードを作成する必要がない場合は、このパラメーターを 0 に設定します。後で値を手動で調整してノードを追加できます。

    0
    multi_az_policy

    string

    任意

    スケーリンググループ内の ECS インスタンスのマルチゾーンスケーリングポリシー。有効な値:

    • PRIORITY: 定義した vSwitch (VSwitchIds.N) に基づいてインスタンスをスケーリングします。優先度が最も高い vSwitch のゾーンで ECS インスタンスを作成できない場合、システムは自動的に次に優先度の高い vSwitch を使用して ECS インスタンスを作成します。

    • COST_OPTIMIZED: vCPU の単位価格が低い順にインスタンスの作成を試みます。スケーリング設定で複数のインスタンスタイプが従量課金メソッドに設定されている場合、スポットインスタンスが最初に作成されます。CompensateWithOnDemand パラメーターを使用して、在庫不足などの理由でスポットインスタンスを作成できない場合に、従量課金インスタンスの作成を自動的に試行するかどうかを指定できます。

      説明

      COST_OPTIMIZED は、スケーリング設定で複数のインスタンスタイプが設定されているか、スポットインスタンスが使用されている場合にのみ効果が得られます。

    • BALANCE: スケーリンググループで指定された複数のゾーンに ECS インスタンスを均等に分配します。在庫不足などの理由でゾーンのバランスが崩れた場合は、 RebalanceInstances API オペレーションを呼び出してリソースをリバランスできます。

    デフォルト値: PRIORITY。

    COST_OPTIMIZED
    scaling_policy

    string

    任意

    スケーリンググループのパターン。有効な値:

    • release: 標準パターン。リクエストされた計算リソースの使用量に基づいて ECS インスタンスを作成およびリリースすることでスケーリングします。

    • recycle: 高速パターン。インスタンスの作成、停止、開始を行うことでスケーリングし、後続のスケーリング操作の速度を向上させます。停止中のインスタンスには計算リソースの料金は発生しませんが、ローカルディスクを持つインスタンスを除き、ストレージ料金は引き続き発生します。

    デフォルト値: release。

    release
    on_demand_base_capacity

    integer

    任意

    スケーリンググループに必要な従量課金インスタンスの最小値。有効な値: [0,1000]。従量課金インスタンスの数がこの値未満の場合、従量課金インスタンスが優先的に作成されます。

    0
    on_demand_percentage_above_base_capacity

    integer

    任意

    スケーリンググループ内で従量課金インスタンスの最小値 (on_demand_base_capacity) を超える追加インスタンスにおける従量課金インスタンスの割合。有効な値: [0,100]。

    20
    spot_instance_pools

    integer

    任意

    利用可能なインスタンスタイプの数。スケーリンググループは複数のタイプのスポットインスタンスを最低コストで作成します。有効な値: [1,10]。

    5
    spot_instance_remedy

    boolean

    任意

    スポットインスタンスの補充を有効にするかどうかを指定します。有効にすると、スケーリンググループはシステム通知を受信した後、回収されようとしているスポットインスタンスを置き換えるために新しいインスタンスの作成を試みます。有効な値:

    • true: スポットインスタンスの補充を有効にします。

    • false: スポットインスタンスの補充を無効にします。

    false
    compensate_with_on_demand

    boolean

    任意

    multi_az_policy が COST_OPTIMIZED に設定されており、価格、在庫、またはその他の理由でスポットインスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスの自動作成を許可するかどうかを指定します。有効な値:

    • true: 必要な ECS インスタンス数を満たすために従量課金インスタンスの自動作成を許可します。

    • false: 必要な ECS インスタンス数を満たすための従量課金インスタンスの自動作成を許可しません。

    true
    enable_high_density_mode

    boolean

    任意

    高密度クラウドディスクモードを有効にするかどうかを指定します。これはノードプールがインスタンスタイプを使用している場合にのみサポートされます。有効にすると、システムクラウドディスクとデータクラウドディスクの総数は、インスタンスタイプでサポートされる高密度クラウドディスクの最大値を超えません。

    false
    deploymentset_id

    string

    任意

    デプロイメントセット ID。デプロイメントセットを使用して、ノードプールによってスケールアウトされた ECS インスタンスを異なる物理サーバーに分散配置し、高可用性と基盤となるディザスタリカバリを確保できます。デプロイメントセット内で ECS インスタンスが作成されると、事前に設定されたデプロイメントポリシーに基づいて指定されたリージョンで起動されます。

    重要 デプロイメントセットを選択すると、ノードプール内の最大ノード数が制限されます。デフォルトでは、デプロイメントセットは最大 20 × ゾーン数 (ゾーン数は vSwitch によって決定されます) をサポートします。慎重に選択し、ノードのスケールアウト失敗を避けるためにデプロイメントセットに十分なクォータがあることを確認してください。

    ds-bp1d19mmbsv3jf6xxxxx
    rds_instances

    array

    任意

    ApsaraDB RDS インスタンスのリスト。

    string

    任意

    ApsaraDB RDS インスタンスの ID。

    rds-****
    private_pool_options

    object

    任意

    非公開ノードプールの構成。

    id

    string

    任意

    非公開ノードプール ID。match_criteria が Target に設定されている場合、非公開プール ID を指定する必要があります。

    eap-bp67acfmxazb4****
    match_criteria

    string

    任意

    非公開ノードプールタイプ。インスタンス起動時の非公開プールキャパシティーオプションを指定します。エラスティシティ保証またはキャパシティー予約が有効になると、インスタンス起動用の非公開プールが生成されます。有効な値:

    • Open: オープンモード。オープンタイプの非公開プールキャパシティーを自動的にマッチングします。一致する非公開プールキャパシティーが利用できない場合、パブリックプールリソースが起動に使用されます。

    • Target: ターゲットモード。指定された非公開プールキャパシティーを使用してインスタンスを起動します。指定された非公開プールキャパシティーが利用できない場合、インスタンスの起動は失敗します。

    • None: 非公開プールなしモード。インスタンス起動に非公開プールキャパシティーを使用しません。

    Target
    security_group_id deprecated

    string

    任意

    ノードプールのセキュリティグループ ID。このパラメーターまたは security_group_ids のいずれかを使用します。security_group_ids の使用を推奨します。

    sg-wz9a8g2mt6x5llu0****
    platform deprecated

    string

    任意

    [非推奨] 代わりに image_type パラメーターを使用してください。

    オペレーティングシステムのディストリビューション。有効な値:

    • CentOS

    • AliyunLinux

    • Windows

    • WindowsCore

    デフォルト値: AliyunLinux。

    null
    instance_patterns

    array

    任意

    インスタンス属性の構成。

    instance_patterns

    任意

    インスタンス属性。

    ram_role_name

    string

    任意

    Worker RAM ロール名。

    • 空の場合、クラスターによって作成されたデフォルトの Worker RAM ロールが使用されます。

    • 指定する場合、RAM ロールは信頼できるサービスが Elastic Compute Service に設定された通常のサービスロールである必要があります。詳細については、「通常のサービスロールの作成」を参照してください。指定された RAM ロールがクラスターによって作成されたデフォルトの Worker RAM ロールではない場合、ロール名は KubernetesMasterRole- または KubernetesWorkerRole- で始まることはできません。

    重要 このパラメーターは、バージョン 1.22 以降の ACK マネージドクラスターでのみサポートされています。

    example-role
    instance_metadata_options InstanceMetadataOptions

    任意

    ECS インスタンスのインスタンスメタデータアクセス構成。

    resource_pool_options

    object

    任意

    インスタンス作成時に使用されるリソースプールおよびリソースプールポリシー。このパラメーターを設定後は、次の点に注意してください: このパラメーターは従量課金インスタンスの作成時にのみ効果が得られます。 このパラメーターは private_pool_options.match_criteria または private_pool_options.id と同時に設定できません。

    strategy

    string

    任意

    インスタンス作成時に使用されるリソースプールポリシー。リソースプールには、エラスティシティ保証またはキャパシティー予約が有効になった後に生成される非公開プールと、インスタンス起動用のパブリックプールが含まれます。有効な値: PrivatePoolFirst: 非公開プール優先。このポリシーが選択され resouce_pool_options.private_pool_ids が指定されている場合、指定された非公開プールが優先的に使用されます。非公開プールが指定されていないか、指定された非公開プールのキャパシティーが不足している場合、オープンタイプの非公開プールが自動的にマッチングされます。一致する非公開プールが利用できない場合、パブリックプールリソースがインスタンスの作成に使用されます。 PrivatePoolOnly: 非公開プール限定。このポリシーが選択されている場合、resouce_pool_options.private_pool_ids を指定する必要があります。指定された非公開プールのキャパシティーが不足している場合、インスタンスの起動は失敗します。 None: リソースプールポリシーなし。 デフォルト値: None。

    PrivatePoolFirst
    private_pool_ids

    array

    任意

    非公開プール ID のリスト (エラスティシティ保証 ID またはキャパシティー予約 ID)。ターゲットモードの非公開プール ID のみ指定できます。N の有効な値: 1～20。

    string

    任意

    非公開プール ID (エラスティシティ保証 ID またはキャパシティー予約 ID)。ターゲットモードの非公開プール ID のみ指定できます。

    eap-bp67acfmxazb4****
    system_disk_snapshot_policy_id

    string

    任意

    システムクラウドディスクのスナップショットポリシー。

    sp-0jl6xnmme8v7o935****
    disk_init

    array

    任意

    ブロックデバイスの初期化構成。

    DiskInit

    任意

    DiskInit の構成。

    cpu_options

    object

    任意

    CPU 関連の構成オプション。

    nested_virtualization

    string

    任意

    入れ子になった仮想化を有効にするかどうかを指定します。有効な値: disabled: 入れ子になった仮想化を無効にします。 enabled: 入れ子になった仮想化を有効にします。

    enabled
    node_config

    object

    任意

    ノードの構成。

    kubelet_configuration kubelet_config

    任意

    Kubelet のパラメータ設定。

    kubernetes_config

    object

    任意

    クラスター関連の構成。

    labels

    array

    任意

    ノードのラベル。Kubernetes クラスター内のノードにラベルを追加できます。

    tag

    任意

    ラベルの構成。

    taints

    array

    任意

    Taint の構成。

    taint

    任意

    Taint 構成のコレクション。

    runtime

    string

    任意

    コンテナランタイム名。ACK は以下の 3 つのコンテナランタイムをサポートしています。

    • containerd: 推奨。すべてのクラスターバージョンでサポートされています。

    • Sandboxed-Container.runv: より高い隔離性を提供するサンドボックスコンテナ。バージョン 1.31 以前のクラスターでサポートされています。

    • docker: エラー修正終了。バージョン 1.22 以前のクラスターでサポートされています。

    デフォルト値: containerd。

    containerd
    runtime_version

    string

    任意

    コンテナランタイムバージョン。

    1.6.38
    cpu_policy

    string

    任意

    ノードの CPU 管理ポリシー。バージョン 1.12.6 以降のクラスターでは、以下の 2 つのポリシーがサポートされています。

    • static: ノード上で特定のリソース特徴を持つ Pod に、強化された CPU アフィニティと排他性を付与できます。静的なポリシーです。

    • none: 既存のデフォルト CPU アフィニティスキームを有効にします。エラーが発生した場合でもデフォルト動作を維持します。

    デフォルト値: none。

    none
    user_data

    string

    任意

    インスタンスのユーザーデータ。ノードがクラスターに参加した後、指定されたユーザースクリプトが実行されます。詳細については、「ユーザーデータスクリプト」を参照してください。

    dGhpcyBpcyBhIGV4YW1wbGU=
    unschedulable

    boolean

    任意

    スケールアウトされたノードをスケジュール不可にするかどうかを指定します。

    • true: スケジュール不可。

    • false: スケジュール可能。

    true
    cms_enabled

    boolean

    任意

    ECS ノードに CloudMonitor エージェントをインストールするかどうかを指定します。インストール後、CloudMonitor コンソールで作成された ECS インスタンスのモニタリング情報をビューできます。この特徴を有効にすることを推奨します。有効な値:

    • true: ECS ノードに CloudMonitor エージェントをインストールします。エラー検出機能が有効になります。

    • false: ECS ノードに CloudMonitor エージェントをインストールしません。

    デフォルト値: false。

    false
    node_name_mode

    string

    任意

    カスタムノード名。ノード名をカスタマイズすると、ノード名、ECS インスタンス名、および ECS インスタンスのホスト名がすべてそれに応じて変更されます。

    説明

    カスタムノード名が有効になっている Windows インスタンスの場合、ホスト名は IP アドレスのドット (.) をハイフン (-) に置き換えたものに固定され、プレフィックスやサフィックスは含まれません。

    ノード名はプレフィックス、ノード IP アドレス、およびサフィックスで構成されます。

    • 全体の長さは 2 ～ 64 文字です。ノード名の先頭と末尾は小文字または数字である必要があります。

    • プレフィックスとサフィックスには、大文字・小文字、数字、ハイフン (-)、ピリオド (.) を使用できます。先頭は大文字または小文字である必要があり、ハイフン (-) またはピリオド (.) で開始または終了することはできません。連続したハイフン (-) またはピリオド (.) は使用できません。

    • プレフィックスは必須です (ECS の制限)。サフィックスはオプションです。

    • ノード IP は、ノードの完全な非公開 IP アドレスです。

    例: ノード IP アドレスが 192.XX.YY.55、プレフィックスが aliyun.com、サフィックスが test の場合:

    • Linux ノードの場合、ノード名、ECS インスタンス名、および ECS インスタンスのホスト名はすべて aliyun.com192.XX.YY.55test となります。

    • Windows ノードの場合、ECS インスタンスのホスト名は 192-XX-YY-55 となり、ノード名と ECS インスタンス名はともに aliyun.com192.XX.YY.55test となります。

    aliyun.com192.XX.YY.55test
    pre_user_data

    string

    任意

    インスタンスの事前ユーザーデータ。ノードがクラスターに参加する前に、指定された事前ユーザースクリプトが実行されます。詳細については、「ユーザーデータスクリプト」を参照してください。

    dGhpcyBpcyBhIGV4YW1wbGU
    tee_config

    object

    任意

    機密コンピューティングクラスターの構成。

    tee_enable

    boolean

    任意

    クラスターの機密コンピューティングを有効にするかどうかを指定します。

    • true: 機密コンピューティングを有効にします。

    • false: 機密コンピューティングを有効にしません。

    true
    interconnect_config deprecated

    object

    任意

    [非推奨]

    エッジノードプールの構成。

    cen_id

    string

    任意

    [非推奨]

    拡張エッジノードプールにアタッチされた Cloud Enterprise Network (CEN) のインスタンス ID。

    null
    ccn_id

    string

    任意

    [非推奨]

    拡張エッジノードプールにアタッチされた Cloud Connect Network (CCN) のインスタンス ID。

    null
    ccn_region_id

    string

    任意

    [非推奨]

    拡張エッジノードプールにバインドされた Cloud Connect Network (CCN) インスタンスのリージョン。

    null
    bandwidth

    integer

    任意

    [非推奨]

    拡張エッジノードプールのネットワーク帯域幅。単位: Mbps。

    null
    improved_period

    string

    任意

    [非推奨]

    拡張エッジノードプールの購入期間。単位: 月。

    null
    count deprecated

    integer

    任意

    [非推奨] 代わりに desired_size を使用してください。

    ノードプール内のノード数。

    null
    max_nodes deprecated

    integer

    任意

    [非推奨]

    エッジノードプールで許可される最大ノード数。

    null
    interconnect_mode

    string

    任意

    エッジノードプールのネットワークタイプ。このパラメーターは type が edge のノードプールに対してのみ有効です。有効な値:

    • basic: パブリックネットワーク。クラウドノードプール内のノードはインターネット経由でクラウドノードと通信します。クラウドノードプール内のアプリケーションは、クラウド VPC の内部ネットワークに直接アクセスできません。

    • private: 非公開ネットワーク。クラウドノードプール内のノードは Express Connect、VPN、または CEN を通じてクラウドに接続し、より高品質なクラウドエッジ間通信とより効果的なセキュリティを提供します。

    basic
    host_network

    boolean

    任意

    Pod のネットワークモードとしてホストネットワークモードを使用するかどうかを指定します。

    • true: ホストネットワーク。Pod はホストのネットワークスタックを直接使用し、ホストと IP アドレスおよびポートを共有します。

    • false: コンテナネットワーク。Pod は独立したネットワークスタックを持ち、ホストのネットワークポートを占有しません。

    true
    intranet

    boolean

    任意

    エッジノードプール内のノード同士がレイヤー 3 ネットワーク接続性を持つかどうかを指定します。

    • true: 接続済み。ノードプール内のすべてのノードが相互にレイヤー 3 ネットワーク接続性を持ちます。

    • false: 未接続。ノードプール内のすべてのノードが相互にレイヤー 3 ネットワーク接続性を持ちません。

    true
    eflo_node_group

    object

    任意

    Lingjun ノードプールの構成。

    cluster_id

    string

    任意

    Lingjun ノードプールを作成する際に関連付ける Lingjun クラスターの ID。

    i1169130516633730****
    group_id

    string

    任意

    Lingjun ノードプールを作成する際に関連付ける Lingjun クラスターの Lingjun グループの ID。

    ng-ec3c96ff0aa****
    auto_attach_enabled

    boolean

    任意

    Lingjun ノードプールの自動ノード追加を有効にするかどうかを指定します。

    worker_ram_role_name

    string

    任意

    Lingjun ノードプールで使用されるワーカー RAM ロール。

    auto_mode

    object

    任意

    ノードプールのインテリジェントマネージド構成。

    enable

    boolean

    任意

    インテリジェントマネージドモードを有効にするかどうかを指定します。 有効な値:

    • true: インテリジェントマネージドモードを有効にします。これは、クラスターでインテリジェントマネージドモードが有効になっている場合にのみ有効にできます。

    • false: インテリジェントマネージドモードを有効にしません。

    true
    node_components

    array<object>

    任意

    ノードコンポーネントのリスト。

    array<object>

    任意

    ノードコンポーネント。

    name

    string

    任意

    ノードコンポーネントの名前。

    kubelet
    version

    string

    任意

    ノードコンポーネントのバージョン。

    1.33.3-aliyun.1
    config

    object

    任意

    ノードコンポーネントの構成。

    custom_config

    object

    任意

    ノードコンポーネントのカスタム構成。

    {"cpuManagerPolicy":"静的"}

    any

    任意

    ノードコンポーネントのカスタム構成文字列。

    cpuManagerPolicy
    envs

    array<object>

    任意

    ノードコンポーネントの環境変数。

    object

    任意

    name

    string

    任意

    環境変数の名前。

    LOG_LEVEL
    value

    string

    任意

    環境変数の値。

    info

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    ノードプールの構成。

    nodepool_id

    string

    ノードプールの ID。

    np31da1b38983f4511b490fc62108a****
    task_id

    string

    タスクの ID。

    T-613b19bbd160ad492800****
    request_id

    string

    リクエストの ID。

    0527ac9a-c899-4341-a21a-****

    例

    成功レスポンス

    JSONJSON

    {
  "nodepool_id": "np31da1b38983f4511b490fc62108a****",
  "task_id": "T-613b19bbd160ad492800****",
  "request_id": "0527ac9a-c899-4341-a21a-****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。