Container Service for Kubernetes:CreateCluster

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

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

• Kubernetes: ACK 専用クラスター。

• ManagedKubernetes: ACK マネージドクラスタータイプ。ACK マネージドクラスター (プロ版 および Basic)、サーバーレス Kubernetes クラスター (プロ版 および Basic)、ACK エッジクラスター (プロ版 および Basic)、ACK Lingjun クラスター (プロ版) を含みます。

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

cluster_type を ManagedKubernetes に設定し、profile を設定した後、クラスターの仕様をさらに指定できます。有効な値:

• ack.standard: Basic (値が空の場合にデフォルトで選択されます)

• ack.pro.small: プロ版

• ack.pro.xlarge: Pro XL

• ack.pro.2xlarge: Pro 2XL

• ack.pro.4xlarge: Pro 4XL (ホワイトリストを有効にするにはカスタマーサービスにお問い合わせください)

Pro XL、Pro 2XL、および Pro 4XL は、コンテナサービス ACK Pro プロビジョニング済みコントロールプレーン が提供する 3 つのティアです。コントロールプレーンのリソースを事前に割り当てて固定することで、API の同時実行数と Pod のスケジューリング機能を確定的に高いレベルに維持し、AI トレーニングや推論、超大規模クラスター、ミッションクリティカルな作業負荷に適しています。

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

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

• Default: ACK マネージドクラスター。ACK クラスター (プロ版 および Basic) を含みます。

• Edge: ACK エッジクラスター。ACK エッジクラスター (プロ版 および Basic) を含みます。

• Serverless: サーバーレス Kubernetes クラスター。サーバーレス Kubernetes クラスター (プロ版 および Basic) を含みます。

• Lingjun: ACK Lingjun クラスター。プロ版 で利用可能です。

クラスターバージョンです。Kubernetes コミュニティのベースラインバージョンと一致します。最新バージョンを選択することを推奨します。このパラメーターを指定しない場合、デフォルトで最新バージョンが使用されます。

最新の 3 つのバージョンのクラスターを作成できます。サポートされているクラスターバージョンをクエリするには、 DescribeKubernetesVersionMetadata 操作を呼び出してください。

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

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

クラスターの削除保護を有効にするかどうかを指定します。これを有効にすると、コンソールまたは API を通じたクラスターの誤削除を防ぐことができます。有効な値:

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

• false: クラスターの削除保護を有効にしません。コンソールまたは API を通じてクラスターを削除できます。

デフォルト値: false。

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

クラスターの IP プロトコルスタックです。

Pod ネットワーク CIDR ブロックです。有効な非公開 CIDR ブロックである必要があり、具体的には以下の CIDR ブロックとそのサブネットです: 10.0.0.0/8、172.16-31.0.0/12-16、192.168.0.0/16。VPC CIDR ブロックや 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 や VPC 内の既存の Kubernetes クラスターで使用されている CIDR ブロックと重複することはできません。作成後は変更済みにはできません。

デフォルト値: 172.19.0.0/20。

セキュリティグループ ID です。既存のセキュリティグループを使用してクラスターを作成する場合にこのパラメーターを指定します。is_enterprise_security_group と相互排他です。クラスターノードはこのセキュリティグループに自動的に追加されます。

高度セキュリティグループの自動作成を使用するかどうかを指定します。security_group_id が空の場合に効果があります。

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

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

デフォルト値: true。

VPC の SNAT を設定するための設定項目です。有効な値:

• true: NAT ゲートウェイ の自動作成を使用し、SNAT ルールを設定します。クラスター内のノードやアプリケーションがインターネットにアクセスする必要がある場合は、これを true に設定します。

• false: NAT ゲートウェイ や SNAT ルールを作成しません。クラスター内のノードやアプリケーションはインターネットにアクセスできません。

デフォルト値: false。

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

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

• false: パブリックネットワークアクセスを許可しません。有効にしない場合、インターネットからクラスター API サーバーにアクセスできません。

デフォルト値: false。

API サーバーアクセス用の CLB インスタンス ID です。このパラメーターが指定されている場合、API サーバー 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 と比較して、nftables はより優れたネットワークパフォーマンス、より効率的なルール更新、および大規模サービスシナリオにおける改善された動作を提供します。
  バージョン 1.35 以降のクラスターでのみサポートされています。Kubernetes コミュニティはバージョン 1.35 から IPVS を非推奨としました。新規クラスターでは、長期的なコミュニティサポートを得るために nftables を使用してください。
  
  

デフォルト値: ipvs。

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

コントロールプレーンコンポーネントログ用の Simple Log Service プロジェクトです。ロギングに既存のプロジェクトを使用するか、システムにプロジェクトを自動作成させることができます。自動作成を選択した場合、k8s-log-{ClusterID} という名前の Simple Log Service プロジェクトが作成されます。

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

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

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

ServiceAccount は、Pod とクラスター API サーバー間の通信のためのアクセス認証情報です。service-account-issuer は serviceaccount token の発行者 ID であり、token payload の iss フィールドです。

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

ServiceAccount は、Pod とクラスター API サーバー間の通信のためのアクセス認証情報です。api-audiences は有効なリクエスト token ID であり、apiserver がリクエスト token の有効性を認証するために使用されます。カンマ (,) で区切られた複数の audiences がサポートされています。

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

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

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

This field is deprecated. Use the extra_sans parameter instead.

The custom certificate Subject Alternative Name (SAN). Separate multiple IP addresses or domain names with commas (,).

The container runtime of the cluster. Supported runtimes include containerd, sandboxed containers, and Docker.

For more information, see Comparison among Docker, containerd, and sandboxed container runtimes.

This field is deprecated. For node pool configurations, use the node_name_mode parameter under kubernetes_config in nodepool instead.

This field is deprecated. The custom node data.

This field is deprecated. For control plane configurations, use the image_id parameter under control_plane_config instead. For node pool configurations, use the image_id parameter under scaling_group in nodepool instead.

The custom node image. The system image is used by default. When a custom image is selected, it replaces the default system image. For more information, see Custom images.

This field is deprecated. For control plane node configurations, use the cloud_monitor_flags parameter under control_plane_config instead. For node pool configurations, use the cms_enabled parameter under kubernetes_config in nodepool instead.

Specifies whether to install the CloudMonitor agent on the cluster. Valid values:

• true: Installs the CloudMonitor agent.

• false: Does not install the CloudMonitor agent.

Default value: false.

This field is deprecated. For node pool configurations, use the platform parameter under scaling_group in nodepool instead.

The operating system distribution. Valid values:

• CentOS

• AliyunLinux

• QbootAliyunLinux

• Qboot

• Windows

• WindowsCore

Default value: CentOS.

This field is deprecated. For control plane node configurations, use the image_type parameter under control_plane_config instead. For node pool configurations, use the image_type parameter under scaling_group in nodepool instead.

The operating system platform type. Valid values:

• Windows

• Linux

Default value: Linux.

This field is deprecated. For control plane node configurations, use the soc_enabled parameter under control_plane_config instead. For node pool configurations, use the soc_enabled parameter under scaling_group in nodepool instead.

MLPS 2.0 security hardening. For more information, see ACK MLPS 2.0 security hardening usage instructions.

Valid values:

• true: Enables MLPS 2.0 security hardening.

• false: Does not enable MLPS 2.0 security hardening.

Default value: false.

This field is deprecated. For control plane configurations, use the security_hardening_os parameter under control_plane_config instead. For node pool configurations, use the security_hardening_os parameter under scaling_group in nodepool instead.

Alibaba Cloud OS security hardening. Valid values:

• true: Enables Alibaba Cloud OS security hardening.

• false: Does not enable Alibaba Cloud OS security hardening.

Default value: false.

This field is deprecated. For control plane configurations, use the security_hardening_os parameter under control_plane_config instead. For node pool configurations, use the security_hardening_os parameter under scaling_group in nodepool instead.

This field is deprecated. For control plane configurations, use the cpu_policy parameter under control_plane_config instead. For node pool configurations, use the cpu_policy parameter under kubernetes_config in nodepool instead.

The node CPU management policy. The following policies are supported for cluster versions 1.12.6 and later:

• static: Allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.

• none: Uses the existing default CPU affinity scheme.

Default value: none.

The node service port range. Valid values: [30000,65535].

Default value: 30000-32767.

This field is deprecated. For control plane configurations, use the key_pair parameter under control_plane_config instead. For node pool configurations, use the key_pair parameter under scaling_group in nodepool instead.

The key pair name. Mutually exclusive with login_password.

This field is deprecated. For control plane configurations, use the login_password parameter under control_plane_config instead. For node pool configurations, use the login_password parameter under scaling_group in nodepool instead.

The SSH logon password. Mutually exclusive with key_pair. The password must be 8 to 30 characters in length and contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.

This field is deprecated. For control plane configurations, use the size parameter under control_plane_config instead.

The number of master nodes. Valid values: 3 or 5.

Default value: 3.

This field is deprecated. For control plane configurations, use the system_disk_category parameter under control_plane_config instead.

The system cloud disk type for master nodes. Valid values:

• cloud_efficiency: ultra cloud disk.

• cloud_ssd: standard SSD.

• cloud_essd: ESSD.

Default value: cloud_ssd. The default value may vary by zone.

This field is deprecated. For control plane configurations, use the system_disk_size parameter under control_plane_config instead.

The system cloud disk size for master nodes. Valid values: [40,500]. Unit: GiB.

Default value: 120.

This field is deprecated. For control plane configurations, use the system_disk_performance_level parameter under control_plane_config instead.

The performance level of the system cloud disk for cluster master nodes. This parameter takes effect only for ESSD cloud disks. The performance level varies based on the cloud disk size. For more information, see ESSD cloud disks.

This field is deprecated. For control plane configurations, use the system_disk_snapshot_policy_id parameter under control_plane_config instead.

The automatic snapshot policy ID for the master node system cloud disk.

This field is deprecated. For control plane configurations, use the instance_charge_type parameter under control_plane_config instead.

The billing method for master nodes. Valid values:

• PrePaid: subscription.

• PostPaid: pay-as-you-go.

Default value: PostPaid.

This field is deprecated. For control plane configurations, use the period_unit parameter under control_plane_config instead.

The billing period unit for master nodes. This parameter is required when the billing method is PrePaid.

Valid values: Month. Only monthly billing is supported.

This field is deprecated. For control plane configurations, use the unit parameter under control_plane_config instead.

The subscription duration for master nodes. This parameter takes effect and is required only when master_instance_charge_type is set to PrePaid.

Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.

Default value: 1.

This field is deprecated. For control plane configurations, use the auto_renew parameter under control_plane_config instead.

Specifies whether to enable auto-renewal for master nodes. This parameter takes effect only when master_instance_charge_type is set to PrePaid. Valid values:

• true: Enables auto-renewal.

• false: Disables auto-renewal.

Default value: true.

This field is deprecated. For control plane configurations, use the auto_renew_period parameter under control_plane_config instead.

The auto-renewal period for master nodes. This parameter takes effect and is required when the subscription billing method is selected.

Valid values: {1, 2, 3, 6, 12}.

Default value: 1.

This field is deprecated. For node pool configurations, use the desired_size parameter under scaling_group in nodepool instead.

The number of worker nodes. Valid values: [0, 100].

This field is deprecated. For node pool configurations, use the system_disk_category parameter under scaling_group in nodepool instead.

The system cloud disk type for worker nodes. For more information, see Block storage overview.

Valid values:

• cloud_efficiency: ultra cloud disk.

• cloud_ssd: standard SSD.

Default value: cloud_ssd.

This field is deprecated. For node pool configurations, use the system_disk_size parameter under scaling_group in nodepool instead.

The system cloud disk size for worker nodes. Unit: GiB.

Valid values: [40,500].

The value must be greater than or equal to max{40, ImageSize}.

Default value: 120.

This field is deprecated. For node pool configurations, use the system_disk_snapshot_policy_id parameter under scaling_group in nodepool instead.

The automatic snapshot policy ID for the worker node system cloud disk.

This field is deprecated. For node pool configurations, use the system_disk_performance_level parameter under scaling_group in nodepool instead.

When the system cloud disk is an ESSD, you can set the performance level (PL) of the ESSD. For more information, see ESSD cloud disks.

Valid values:

• PL0

• PL1

• PL2

• PL3

This field is deprecated. For node pool configurations, use the instance_charge_type parameter under scaling_group in nodepool instead.

The billing method for worker nodes. Valid values:

• PrePaid: subscription.

• PostPaid: pay-as-you-go.

Default value: pay-as-you-go.

This field is deprecated. For node pool configurations, use the period_unit parameter under scaling_group in nodepool instead.

The billing period unit for worker nodes. This parameter is required when the billing method is PrePaid.

Valid values: Month. Only monthly billing is supported.

This field is deprecated. For node pool configurations, use the period parameter under scaling_group in nodepool instead.

The subscription duration for worker nodes. This parameter takes effect and is required only when `worker_

This field is deprecated. Use the auto_renew parameter under scaling_group in nodepool instead.

Specifies whether to enable auto-renewal for worker nodes. This parameter takes effect only when worker_instance_charge_type is set to PrePaid. Valid values:

• true: Auto-renewal is enabled.

• false: Auto-renewal is disabled.

Default value: true.

This field is deprecated. Use the auto_renew_period parameter under scaling_group in nodepool instead.

The auto-renewal epoch for worker nodes. This parameter takes effect and is required only when the subscription billing method is selected.

Valid values: {1, 2, 3, 6, 12}.

This field is deprecated. Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the AttachInstancesToNodePool operation.

Specifies whether to mount data cloud disks when creating a cluster with existing instances. Valid values:

• true: Stores containers and images on data cloud disks. Existing data on the data cloud disks is lost. Back up your data in advance.

• false: Does not store containers and images on data cloud disks.

Default value: false.

Data cloud disk mounting rules:

• If the ECS instance has data cloud disks attached and the file system of the last data cloud disk is not initialized, the system automatically formats the data cloud disk as ext4 to store /var/lib/docker and /var/lib/kubelet.

• If the ECS instance has no data cloud disks attached, no new data cloud disks are mounted.

This field is deprecated. Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the AttachInstancesToNodePool operation.

Specifies whether to retain instance names when creating a cluster with existing instances.

• true: Retained.

• false: Not retained. Instance names are replaced by system-generated names.

Default value: true.

This field is deprecated. Use the snat_entry parameter instead.

This field is deprecated. Use the zone_ids parameter instead.

The zone ID of the region where the cluster resides. This parameter is specific to ACK managed clusters.

When creating an ACK managed cluster, if vpc_id and vswitch_ids are not specified, you must specify zone_id for the cluster to automatically create a VPC and related network resources in the specified active zone. This parameter does not take effect when vpc_id and vswitch_ids are specified.

This field is deprecated. Enables Simple Log Service for the cluster. This parameter takes effect only for ACK Serverless clusters, and the value must be SLS.

This field is deprecated. By default, rollback is not performed when cluster creation fails. You must manually clean up the failed cluster.

Specifies whether to roll back when cluster creation fails. Valid values:

• true: Performs rollback when cluster creation fails.

• false: Does not perform rollback when cluster creation fails.

Default value: true.

This field is deprecated. By default, rollback is not performed when cluster creation fails. You must manually clean up the failed cluster.

The timeout period for cluster creation, in minutes.

Default value: 60.

This field is deprecated. For cluster control plane configuration, use the image_type parameter under control_plane_config instead. For node pool configuration, use the image_type parameter under scaling_group in nodepool instead.

The operating system distribution type. We recommend that you use this field to specify the node operating system. Valid values:

• CentOS

• AliyunLinux

• AliyunLinux Qboot

• AliyunLinuxUEFI

• AliyunLinux3

• Windows

• WindowsCore

• AliyunLinux3Arm64

• ContainerOS

Default value: CentOS.

This parameter is deprecated. CLB uses pay-by-usage billing. This parameter does not take effect.

The load balancing specification. Valid values:

• slb.s1.small

• slb.s2.small

• slb.s2.medium

• slb.s3.small

• slb.s3.medium

• slb.s3.large

Default value: slb.s2.small.

This field is deprecated. Use the rrsa_config parameter instead.

Specifies whether to enable the RRSA feature.

• true: Enabled.

• false: Disabled.

This field is deprecated.

The billing method of the CLB instance used by the API server. Default value: PostPaid. Valid values:

• PostPaid: pay-as-you-go.

• PrePaid: subscription. The subscription billing method is no longer supported for newly created CLB instances. Existing instances are not affected.

This field is deprecated.

The billing cycle. This parameter is required when the billing method is PrePaid.

Valid values: Month. Currently, only monthly billing cycles are supported.

This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter.

This field is deprecated.

The subscription duration. This parameter takes effect and is required only when charge_type is set to PrePaid.

Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.

Default value: 1.

This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter.

This field is deprecated.

Specifies whether to enable auto-renewal. This parameter takes effect only when charge_type is set to PrePaid. Valid values:

• true: Auto-renewal is enabled.

• false: Auto-renewal is disabled.

Default value: false.

This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter.

This field is deprecated.

The auto-renewal epoch. This parameter takes effect only when the upfront billing method and auto-renewal are selected. When PeriodUnit=Month, valid values: {1, 2, 3, 6, 12}.

Default value: 1.

This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter.

The cluster ID.

The request ID.

The task ID.