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 マネージドクラスター（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。クラスター作成時に 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 マネージドクラスターのネットワーク計画」をご参照ください。

Service ネットワーク 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。

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

指定された CIDR マスクによって決定される、ノードごとの IP アドレス数。このパラメーターは 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。

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

コントロールプレーンコンポーネントログ用の Simple Log Service プロジェクト。既存のプロジェクトを使用するか、システムに自動作成させることができます。自動作成の場合、プロジェクト名は 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 管理ポリシー。Kubernetes バージョン 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] GiB。

デフォルト値：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 パラメーターを使用してください。

マスターノード課金サイクル。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 パラメーターを使用してください。

ワーカーノード課金サイクル。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 を指定した場合、このパラメーターは無効になります。

[このフィールドは非推奨です。] クラスターに対して Simple Log Service を有効にします。ACK サーバーレスクラスターにのみ適用され、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。