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 トレーニングや推論、超大規模クラスター、ミッションクリティカルな作業負荷に適しています。

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

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

• 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。CIDR ブロックは VPC CIDR ブロックや VPC 内の既存の Kubernetes クラスターで使用されている CIDR ブロックと重複できません。クラスター作成後はこの CIDR ブロックを変更できません。

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

サービス CIDR ブロックです。有効値: 10.0.0.0/16-24、172.16-31.0.0/16-24、192.168.0.0/16-24。CIDR ブロックは VPC CIDR ブロック 10.1.0.0/21 や VPC 内の既存の Kubernetes クラスターで使用されている CIDR ブロックと重複できません。クラスター作成後はこの 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 サーバーを公開し、クラスターへのパブリックネットワークアクセスを可能にします。

• 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} という名前のプロジェクトが作成されます。

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

命名規則: ドメイン名はピリオド (.) で区切られた 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 の有効性を検証するために使用されます。カンマ (,) で区切って複数の audience 値を設定できます。

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

クラスターの O&M ウィンドウです。

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

This field is deprecated. Use the extra_sans parameter instead.

Custom certificate SAN. Multiple IP addresses or domain names are separated by commas (,).

The container runtime for the cluster. Supports containerd, sandboxed containers, and Docker.

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

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

This field is deprecated. Custom node data.

This field is deprecated. For cluster 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 image for nodes. 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 cluster 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: Install the CloudMonitor agent.

• false: Do 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 cluster 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 cluster 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.

Valid values:

• true: Enable MLPS 2.0 security hardening.

• false: Do not enable MLPS 2.0 security hardening.

Default value: false.

This field is deprecated. For cluster 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: Enable Alibaba Cloud OS security hardening.

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

Default value: false.

This field is deprecated. For cluster 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 cluster 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 CPU management policy for nodes. 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 cluster 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 cluster 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 cluster 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 cluster 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 cloud disk.

Default value: cloud_ssd. The default value may vary based on the active zone.

This field is deprecated. For cluster 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 cluster 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 is related to the cloud disk size. For more information, see ESSD cloud disks (standard SSDs).

This field is deprecated. For cluster 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 cluster 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 cluster control plane configurations, use the period_unit parameter under control_plane_config instead.

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

Valid values: Month. Currently, only monthly billing is supported.

This field is deprecated. For cluster 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 cluster 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: Enable auto-renewal.

• false: Disable auto-renewal.

Default value: true.

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

The auto-renewal epoch 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.

The performance level (PL) of the ESSD used as the system cloud disk can be configured when the system cloud disk is an ESSD cloud disk. 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 cycle.

This field is deprecated. Use the period parameter under scaling_group in nodepool for node pool configuration instead.

The subscription duration of worker nodes. This parameter takes effect and is required only when worker_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. Use the auto_renew parameter under scaling_group in nodepool for node pool configuration 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: Enables auto-renewal.

• false: Disables auto-renewal.

Default value: true.

This field is deprecated. Use the auto_renew_period parameter under scaling_group in nodepool for node pool configuration instead.

The auto-renewal epoch of 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 to existing instances when creating a cluster with existing instances. Valid values:

• true: Stores containers and images on a data cloud disk. Existing data on the data cloud disk will be lost. Back up your data in advance.

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

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 disk is 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: Retains the instance names.

• false: Does not retain the instance names. The system replaces them based on system rules.

Default value: true.

This field is deprecated. Use the snat_entry parameter instead.

This field is deprecated. Use the zone_ids parameter instead.

The active 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 zone. This parameter is ignored 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 a rollback when cluster creation fails.

• false: Does not perform a 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. Use the image_type parameter under control_plane_config for cluster control plane configuration, or use the image_type parameter under scaling_group in nodepool for node pool configuration 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, and 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: Enables auto-renewal.

• false: Disables auto-renewal.

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.