Container Service for Kubernetes:CreateCluster

カスタムクラスター名です。数字、英字、中国語文字、またはハイフン (-) を含めることができます。名前の長さは 1～63 文字で、ハイフン (-) で開始することはできません。

クラスターをデプロイするリージョン ID です。詳細については、「Container Service for Kubernetes でサポートされているリージョン」をご参照ください。

• Kubernetes: ACK 専用クラスター

• ManagedKubernetes: ACK マネージドクラスター（Pro 版、Basic Edition）、ACK サーバーレスクラスター（Pro 版、Basic Edition）、ACK Edge クラスター（Pro 版、Basic Edition）、および ACK LINGJUN クラスター（Pro 版）

• ExternalKubernetes: 登録済みクラスター

cluster_type を ManagedKubernetes に設定し、profile を構成する場合、クラスター仕様をさらに指定できます。有効値は次のとおりです。

• ack.standard: Basic Edition（このパラメーターが空の場合のデフォルト値）

• ack.pro.small: Pro 版

• ack.pro.xlarge: Pro XL

• ack.pro.2xlarge: Pro 2XL

• ack.pro.4xlarge: Pro 4XL（カスタマーサービスによるホワイトリスト承認が必要）

Pro XL、Pro 2XL、および Pro 4XL は、ACK Pro Provisioned Control Plane によって提供される 3 つのティアです。これらのティアでは、コントロールプレーンリソースを事前に割り当てて専有することで、一貫して高い API 同時実行数と Pod スケジューリングパフォーマンスを確保します。AI トレーニングおよび推論、超大規模クラスター、ミッションクリティカルなワークロードに適しています。

Pro 版およびプロビジョニング済みコントロールプレーンクラスターのクラスター管理料金については、「クラスター管理料金」をご参照ください。

cluster_type を ManagedKubernetes（ACK マネージドクラスター）に設定する場合、クラスターサブタイプをさらに指定できます。

• Default: ACK マネージドクラスター（Pro 版、Basic Edition を含む）

• Edge: ACK Edge クラスター（Pro 版、Basic Edition を含む）

• Serverless: ACK サーバーレスクラスター（Pro 版、Basic Edition を含む）

• Lingjun: ACK LINGJUN クラスター（Pro 版でのみ利用可能）

クラスターバージョンで、Kubernetes コミュニティのベースラインバージョンに準拠しています。最新バージョンの使用を推奨します。指定しない場合、デフォルトで最新バージョンが使用されます。

最新の 3 つのバージョンのいずれかを使用してクラスターを作成できます。DescribeKubernetesVersionMetadata API を使用して、サポートされているクラスターバージョンを照会できます。

ACK でサポートされている Kubernetes バージョンの詳細については、「Kubernetes バージョンリリースの概要」をご参照ください。

クラスターが属するリソースグループ ID で、異なるリソースを分離するために使用されます。

クラスター削除保護機能は、コンソールまたは API による誤ったクラスター削除を防止します。有効値は次のとおりです。

• true: 削除保護を有効にします。コンソールまたは API からクラスターを削除できなくなります。

• false: 削除保護を無効にします。コンソールまたは API からクラスターを削除できます。

デフォルト値: false

クラスターで使用する VPC です。クラスター作成時に必ず指定する必要があります。

クラスターの IP スタックです。

Pod ネットワークの CIDR ブロックです。有効なプライベート CIDR ブロック（10.0.0.0/8、172.16.0.0/12～172.31.0.0/16、または 192.168.0.0/16）である必要があります。VPC または VPC 内の既存の Kubernetes クラスターの CIDR ブロックと重複してはなりません。クラスター作成後は変更できません。

クラスターネットワーク計画の詳細については、「ACK マネージドクラスターのネットワーク計画」をご参照ください。

サービスネットワークの CIDR ブロックです。有効範囲：10.0.0.0/16-24、172.16.0.0/16-24～172.31.0.0/16-24、192.168.0.0/16-24。 VPC CIDR ブロック 10.1.0.0/21 または VPC 内の既存の Kubernetes クラスターの CIDR ブロックと重複してはなりません。クラスター作成後は変更できません。

デフォルト値: 172.19.0.0/20

クラスター作成時に既存のセキュリティグループ ID を指定します。is_enterprise_security_group パラメーターとのいずれか一方を指定します。クラスターノードは自動的にこのセキュリティグループに追加されます。

高度セキュリティグループを自動作成します。security_group_id が空の場合に有効になります。

• true: 高度セキュリティグループを作成して使用します。

• false: 基本セキュリティグループを使用します。

デフォルト値: true

VPC 用の SNAT を構成します。有効値は次のとおりです。

• true: NAT Gateway を自動作成し、SNAT ルールを構成します。クラスター内のノードまたはアプリケーションがパブリックネットワークアクセスを必要とする場合、これを true に設定します。

• false: NAT Gateway および SNAT ルールを作成しません。クラスター内のノードおよびアプリケーションはパブリックネットワークにアクセスできません。

デフォルト値: false

パブリックネットワークアクセスを有効にするかどうかを指定します。EIP を介して API Server を公開し、クラスターへのパブリックネットワークアクセスを許可します。

• true: パブリックネットワークアクセスを有効にします。

• false: パブリックネットワークアクセスを無効にします。無効にした場合、外部ネットワークからクラスター API Server にアクセスできません。

デフォルト値: false

API Server アクセス用の CLB インスタンス ID を指定します。指定した場合、新しい API Server CLB は自動作成されません。

パブリック SSH ログインを有効にするかどうかを指定します。ACK 専用クラスターのマスターノードへのログインに使用されます。このパラメーターはマネージドクラスターでは有効になりません。

• true: 有効にします。

• false: 無効にします。

デフォルト値: false

クラスターで使用するタイムゾーンです。「サポートされているタイムゾーン」をご参照ください。

ノード IP アドレス数で、指定された CIDR マスクによって決定されます。これは Flannel ネットワーククラスターにのみ適用されます。

デフォルト値: 26

kube-proxy プロキシモード

• iptables: 成熟かつ安定した kube-proxy モードです。Kubernetes サービス検出および負荷分散は iptables ルールを使用します。パフォーマンスは中程度で、多数のサービスがある場合にスケーラビリティが低くなります。サービス数が少ないクラスターに適しています。

• ipvs: パフォーマンス専有型の kube-proxy モードです。Kubernetes サービス検出および負荷分散は Linux IPVS モジュールを使用します。多数のサービスがあり、高性能な負荷分散を必要とするクラスターに適しています。

• nftables: Linux nftables をベースとした次世代 kube-proxy モードで、サービス検出および負荷分散に使用されます。iptables の現代的な代替です。iptables と比較して、ネットワークパフォーマンス、ルール更新速度、多数のサービスに対するスケーラビリティが優れています。
  Kubernetes バージョン 1.35 以降のクラスターでのみサポートされています。Kubernetes コミュニティはバージョン 1.35 以降で IPVS を非推奨としています。新規クラスターでは長期的なコミュニティサポートを確保するために nftables の使用を推奨します。
  
  

デフォルト値: ipvs

コントロールプレーンコンポーネントログの保持日数です。

コントロールプレーンコンポーネントログ用の SLS Project です。既存の Project をログストレージに使用するか、システムに自動作成させることができます。自動作成の場合、Project 名は k8s-log-{ClusterID} になります。

クラスターのローカルドメイン名です。

命名規則: ドメイン名は、ドット (.) で区切られた 1 つ以上の部分で構成されます。各部分の長さは最大 63 文字で、小文字、数字、ハイフン (-) を含めることができます。各部分は小文字または数字で開始および終了する必要があります。

データディスクを暗号化するための KMS キー ID です。詳細については、「Key Management Service」をご参照ください。

ServiceAccount は、Pod がクラスター API Server と通信する際に使用するアクセス認証情報です。service-account-issuer は、serviceaccount token 内の発行者 ID で、token payload の iss フィールドで表されます。

ServiceAccount の詳細については、「サービスアカウントトークンボリュームプロジェクションのデプロイ」をご参照ください。

ServiceAccount は、Pod がクラスター API Server と通信する際に使用するアクセス認証情報です。api-audiences は、apiserver 側でリクエストを認証するための有効な token ID を指定します。複数の audience 値をカンマ (,) で区切って設定できます。

ServiceAccount の詳細については、「サービスアカウントトークンボリュームプロジェクションのデプロイ」をご参照ください。

クラスターメンテナンスウィンドウです。

カスタムクラスター CA です。

[非推奨] extra_sans パラメーターを使用してください。

カスタム証明書 SAN です。複数の IP アドレスまたはドメイン名をカンマ (,) で区切ります。

クラスターのコンテナランタイムです。containerd、サンドボックスコンテナ、Docker をサポートしています。

詳細については、「Docker、containerd、サンドボックスコンテナランタイムの比較」をご参照ください。

[非推奨] nodepool の kubernetes_config 下の node_name_mode パラメーターを使用してください。

[非推奨] カスタムノードデータです。

[非推奨] コントロールプレーン構成では、control_plane_config 下の image_id パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の image_id パラメーターを使用してください。

カスタムノードイメージです。デフォルトではシステムイメージが使用されます。カスタムイメージを選択すると、デフォルトのシステムイメージが置き換えられます。「カスタムイメージ」をご参照ください。

[非推奨] コントロールプレーンノード構成では、control_plane_config 下の cloud_monitor_flags パラメーターを使用してください。ノードプール構成では、nodepool の kubernetes_config 下の cms_enabled パラメーターを使用してください。

クラスターに CloudMonitor エージェントをインストールするかどうかを指定します。有効値は次のとおりです。

• true: CloudMonitor エージェントをインストールします。

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

デフォルト値: false

[非推奨] ノードプール構成では、nodepool の scaling_group 下の platform パラメーターを使用してください。

オペレーティングシステムディストリビューションです。有効値は次のとおりです。

• CentOS

• AliyunLinux

• QbootAliyunLinux

• Qboot

• Windows

• WindowsCore

デフォルト値: CentOS

[非推奨] コントロールプレーンノード構成では、control_plane_config 下の image_type パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の image_type パラメーターを使用してください。

オペレーティングシステムプラットフォームタイプです。有効値は次のとおりです。

• Windows

• Linux

デフォルト値: Linux

[非推奨] コントロールプレーンノード構成では、control_plane_config 下の soc_enabled パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の soc_enabled パラメーターを使用してください。

MLPS 2.0 セキュリティ強化です。詳細については、「ACK での MLPS 2.0 セキュリティ強化の使用」をご参照ください。

有効値は次のとおりです。

• true: MLPS 2.0 セキュリティ強化を有効にします。

• false: MLPS 2.0 セキュリティ強化を無効にします。

デフォルト値: false

[非推奨] コントロールプレーン構成では、control_plane_config 下の security_hardening_os パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の security_hardening_os パラメーターを使用してください。

Alibaba Cloud OS セキュリティ強化です。有効値は次のとおりです。

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

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

デフォルト値: false

[非推奨] コントロールプレーン構成では、control_plane_config 下の security_hardening_os パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の security_hardening_os パラメーターを使用してください。

[非推奨] コントロールプレーン構成では、control_plane_config 下の cpu_policy パラメーターを使用してください。ノードプール構成では、nodepool の kubernetes_config 下の cpu_policy パラメーターを使用してください。

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

• static: ノード上で特定のリソース特性を持つ Pod の CPU アフィニティおよび排他性を強化します。

• none: デフォルトの CPU アフィニティスキームを使用します。

デフォルト値: none

ノードサービスポート範囲: [30000,65535]。

デフォルト値: 30000-32767

[非推奨] コントロールプレーン構成では、control_plane_config 下の key_pair パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の key_pair パラメーターを使用してください。

キーペア名です。login_password パラメーターとのいずれか一方を指定します。

[非推奨] コントロールプレーン構成では、control_plane_config 下の login_password パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の login_password パラメーターを使用してください。

SSH ログインパスワードです。key_pair パラメーターとのいずれか一方を指定します。パスワードルール: 8～30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。

[非推奨] コントロールプレーン構成では、control_plane_config 下の size パラメーターを使用してください。

マスターノード数です。有効値: 3 または 5。

デフォルト値: 3

[非推奨] コントロールプレーン構成では、control_plane_config 下の system_disk_category パラメーターを使用してください。

マスターノードシステムディスクタイプです。有効値は次のとおりです。

• cloud_efficiency: Ultra ディスク

• cloud_ssd: 標準 SSD

• cloud_essd: ESSD

デフォルト値: cloud_ssd。ゾーンによってデフォルト値が異なる場合があります。

[非推奨] コントロールプレーンの構成には、control_plane_config 配下の system_disk_size パラメーターをご使用ください。

有効値：[40, 500]。

デフォルト値：120。

[非推奨] コントロールプレーン構成では、control_plane_config 下の system_disk_performance_level パラメーターを使用してください。

マスターノードシステムディスクのパフォーマンスレベルです。ESSD ディスクにのみ適用されます。ディスクパフォーマンスレベルはディスクサイズに依存します。詳細については、「ESSD」をご参照ください。

[非推奨] コントロールプレーン構成では、control_plane_config 下の system_disk_snapshot_policy_id パラメーターを使用してください。

マスターノードシステムディスクの自動スナップショットポリシー ID です。

[非推奨] コントロールプレーン構成では、control_plane_config 下の instance_charge_type パラメーターを使用してください。

マスターノード課金タイプです。有効値は次のとおりです。

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

• PostPaid: 従量課金

デフォルト値: PostPaid

[非推奨] コントロールプレーン構成では、control_plane_config 下の period_unit パラメーターを使用してください。

マスターノード課金サイクルです。master_instance_charge_type が PrePaid の場合に必須です。

有効値: Month。月単位の課金のみサポートされています。

[非推奨] コントロールプレーン構成では、control_plane_config 下の unit パラメーターを使用してください。

マスターノードのサブスクリプション期間（月単位）です。master_instance_charge_type が PrePaid の場合に必須で有効です。

有効値: {1, 2, 3, 6, 12, 24, 36, 48, 60}

デフォルト値: 1

[非推奨] コントロールプレーン構成では、control_plane_config 下の auto_renew パラメーターを使用してください。

マスターノードの自動更新を有効にするかどうかを指定します。master_instance_charge_type が PrePaid の場合にのみ有効です。有効値は次のとおりです。

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

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

デフォルト値: true

[非推奨] コントロールプレーン構成では、control_plane_config 下の auto_renew_period パラメーターを使用してください。

マスターノードの自動更新期間（月単位）です。サブスクリプション課金を選択した場合に必須で有効です。

有効値: {1, 2, 3, 6, 12}

デフォルト値: 1

[非推奨] ノードプール構成では、nodepool の scaling_group 下の desired_size パラメーターを使用してください。

ワーカーノード数です。範囲: [0,100]。

[非推奨] ノードプール構成では、nodepool の scaling_group 下の system_disk_category パラメーターを使用してください。

ワーカーノードシステムディスクタイプです。詳細については、「Elastic Block Storage の概要」をご参照ください。

有効値は次のとおりです。

• cloud_efficiency: Ultra ディスク

• cloud_ssd: 標準 SSD

デフォルト値: cloud_ssd

[非推奨] ノードプール構成では、nodepool の scaling_group 下の system_disk_size パラメーターを使用してください。

ワーカーノードシステムディスクサイズ（GiB 単位）です。

有効範囲: [40,500]。

この値は max{40, ImageSize} 以上である必要があります。

デフォルト値: 120

[非推奨] ノードプール構成では、nodepool の scaling_group 下の system_disk_snapshot_policy_id パラメーターを使用してください。

ワーカーノードシステムディスクの自動スナップショットポリシー ID です。

[非推奨] ノードプール構成では、nodepool の scaling_group 下の system_disk_performance_level パラメーターを使用してください。

システムディスクが ESSD の場合、パフォーマンスレベル (PL) を設定できます。詳細については、「ESSD」をご参照ください。

有効値は次のとおりです。

• PL0

• PL1

• PL2

• PL3

[非推奨] ノードプール構成では、nodepool の scaling_group 下の instance_charge_type パラメーターを使用してください。

ワーカーノード課金タイプです。有効値は次のとおりです。

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

• PostPaid: 従量課金

デフォルト値: 従量課金

[非推奨] ノードプール構成では、nodepool の scaling_group 下の period_unit パラメーターを使用してください。

ワーカーノード課金サイクルです。worker_instance_charge_type が PrePaid の場合に必須です。

有効値: Month。月単位の課金のみサポートされています。

[非推奨] ノードプール構成では、nodepool の scaling_group 下の period パラメーターを使用してください。

ワーカーノードのサブスクリプション期間（月単位）です。worker_instance_charge_type が PrePaid の場合に必須で有効です。

有効値: {1, 2, 3, 6, 12, 24, 36, 48, 60}

デフォルト値: 1

[非推奨] ノードプール構成では、nodepool の scaling_group 下の auto_renew パラメーターを使用してください。

ワーカーノードの自動更新を有効にするかどうかを指定します。worker_instance_charge_type が PrePaid の場合にのみ有効です。有効値は次のとおりです。

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

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

デフォルト値: true

[非推奨] ノードプール構成では、nodepool の scaling_group 下の auto_renew_period パラメーターを使用してください。

ワーカーノードの自動更新期間（月単位）です。サブスクリプション課金を選択した場合に必須で有効です。

有効値: {1, 2, 3, 6, 12}

[非推奨] クラスター作成時に既存ノードの追加はサポートされていません。クラスターに既存ノードを追加するには、まずノードプールを作成し、その後 AttachInstancesToNodePool API を呼び出します。

既存インスタンスを使用してクラスターを作成する場合、データディスクをマウントするかどうかを指定します。有効値は次のとおりです。

• true: コンテナおよびイメージをデータディスクに保存します。データディスク上の既存データは失われます。データをバックアップしてください。

• false: コンテナおよびイメージをデータディスクに保存しません。

デフォルト値: false

データディスクマウントルール:

• ECS インスタンスにマウントされたデータディスクがあり、最後のデータディスクのファイルシステムが初期化されていない場合、システムは自動的に ext4 としてフォーマットし、/var/lib/docker および /var/lib/kubelet を保存します。

• ECS インスタンスにマウントされたデータディスクがない場合、新しいデータディスクはマウントされません。

[非推奨] クラスター作成時に既存ノードの追加はサポートされていません。クラスターに既存ノードを追加するには、まずノードプールを作成し、その後 AttachInstancesToNodePool API を呼び出します。

既存インスタンスを使用してクラスターを作成する場合、インスタンス名を保持するかどうかを指定します。

• true: 保持します。

• false: システム生成名に置き換えます。

デフォルト値: true

[非推奨] snat_entry パラメーターを使用してください。

[非推奨] zone_ids パラメーターを使用してください。

クラスターリージョン内のゾーン ID です。このパラメーターは ACK マネージドクラスターにのみ適用されます。

ACK マネージドクラスターを作成する際、vpc_id および vswitch_ids を指定しない場合は、zone_id を指定してこのゾーンに VPC ネットワークリソースを自動作成する必要があります。vpc_id および vswitch_ids を指定した場合、このパラメーターは無視されます。

[非推奨] クラスターに対して SLS を有効にします。ACK Serverless クラスターにのみ適用され、SLS に設定する必要があります。

[非推奨] デフォルトでは、クラスター作成失敗時にロールバックされません。失敗したクラスターを手動でクリーンアップする必要があります。

クラスター作成失敗時にロールバックするかどうかを指定します。有効値は次のとおりです。

• true: 失敗時にロールバックします。

• false: 失敗時にロールバックしません。

デフォルト値: true

[非推奨] デフォルトでは、クラスター作成失敗時にロールバックされません。失敗したクラスターを手動でクリーンアップする必要があります。

クラスター作成タイムアウト（分単位）です。

デフォルト値: 60

[非推奨] コントロールプレーン構成では、control_plane_config 下の image_type パラメーターを使用してください。ノードプール構成では、nodepool の scaling_group 下の image_type パラメーターを使用してください。

オペレーティングシステムディストリビューションタイプです。ノードオペレーティングシステムを指定するためにこのパラメーターの使用を推奨します。有効値は次のとおりです。

• CentOS

• AliyunLinux

• AliyunLinux Qboot

• AliyunLinuxUEFI

• AliyunLinux3

• Windows

• WindowsCore

• AliyunLinux3Arm64

• ContainerOS

デフォルト値: CentOS

[非推奨] CLB は使用量に基づいて課金されます。このパラメーターは効果がありません。

ロードバランサ仕様です。有効値は次のとおりです。

• slb.s1.small

• slb.s2.small

• slb.s2.medium

• slb.s3.small

• slb.s3.medium

• slb.s3.large

デフォルト値: slb.s2.small

[非推奨] rrsa_config パラメーターを使用してください。

RRSA を有効にするかどうかを指定します。

• true: 有効にします。

• false: 無効にします。

[非推奨]

API Server で使用される CLB インスタンスの課金タイプです。デフォルト値: PostPaid。有効値は次のとおりです。

• PostPaid: 従量課金

• PrePaid: サブスクリプション。新規 CLB インスタンスはサブスクリプション課金をサポートしなくなりましたが、既存インスタンスは影響を受けません。

[非推奨]

課金サイクルです。課金タイプが PrePaid の場合に必須です。

有効値: Month。月単位の課金のみサポートされています。

このパラメーターは 2024 年 10 月 15 日に変更されました。詳細については、「CreateCluster API パラメーター変更に関するお知らせ」をご参照ください。

[非推奨]

サブスクリプション期間（月単位）です。charge_type が PrePaid の場合に必須で有効です。

有効値: {1, 2, 3, 6, 12, 24, 36, 48, 60}

デフォルト値: 1

このパラメーターは 2024 年 10 月 15 日に変更されました。詳細については、「CreateCluster API パラメーター変更に関するお知らせ」をご参照ください。

[非推奨]

自動更新を有効にするかどうかを指定します。charge_type が PrePaid の場合にのみ有効です。有効値は次のとおりです。

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

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

デフォルト値: false

このパラメーターは 2024 年 10 月 15 日に変更されました。詳細については、「CreateCluster API パラメーター変更に関するお知らせ」をご参照ください。

[非推奨]

自動更新期間（月単位）です。プリペイドおよび自動更新が有効な場合にのみ有効です。PeriodUnit=Month の場合、有効値は {1, 2, 3, 6, 12} です。

デフォルト値: 1

このパラメーターは 2024 年 10 月 15 日に変更されました。詳細については、「CreateCluster API パラメーター変更に関するお知らせ」をご参照ください。

クラスター ID です。

リクエスト ID です。

タスク ID です。