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–31.0.0/12–16、または 192.168.0.0/16）である必要があります。VPC または既存の Kubernetes クラスターの CIDR ブロックと重複してはなりません。クラスター作成後は変更できません。

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

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

デフォルト値: 172.19.0.0/20。

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

security_group_id が空の場合、エンタープライズセキュリティグループを自動的に作成します。

• true: エンタープライズセキュリティグループを作成して使用します。

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

デフォルト値: true。

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

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

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

デフォルト値: false。

パブリックネットワークアクセスを有効化します。API Server を EIP 経由で公開し、パブリックアクセスを許可します。

• 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 モードです。Linux IPVS モジュールを使用してサービスの検出および負荷分散を行います。多数のサービスがあり、高性能な負荷分散を必要とするクラスターに最適です。

• nftables: Linux nftables をベースにした次世代 kube-proxy モードで、サービスの検出および負荷分散を行います。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 の有効性を認証するための有効なリクエスト 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 パラメーターを使用してください。

キーペア名です。key_pair または login_password のいずれか一方を使用します。

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

SSH ログインパスワードです。key_pair または login_password のいずれか一方を使用します。パスワードルール: 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 パラメーターを使用してください。

マスターノードの課金サイクルです。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 マネージドクラスターにのみ適用されます。

vSwitch をこのゾーン内に自動作成するには、vpc_id および vswitch_ids を指定せずに ACK マネージドクラスターを作成する際に zone_id を指定します。vpc_id および vswitch_ids が指定されている場合は、このパラメーターは無視されます。

[非推奨] クラスターに対して Simple Log Service を有効化します。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 です。