すべてのプロダクト
Search
ドキュメントセンター

Container Service for Kubernetes:CreateCluster

最終更新日:Sep 10, 2026

ACK クラスターを作成します。対象には、ACK マネージドクラスター、サーバーレス Kubernetes クラスター、ACK Edge クラスター、および登録済みクラスターが含まれます。クラスター作成時に、クラスター情報、クラスターコンポーネント、および ACK 関連のクラウドリソースを構成します。

操作説明

コンソールを使用した OpenAPI リクエストパラメーターの生成

CreateCluster 操作を呼び出してクラスターを作成する際、リクエストパラメーターの組み合わせが正しくないために API 呼び出しが失敗した場合、コンソールを使用して必須のリクエストパラメーターの組み合わせを生成できます。次の手順を実行します。

  1. コンテナサービス for Kubernetes (ACK) コンソール にログインし、左側のナビゲーションウィンドウで [クラスター] を選択します。

  2. [クラスター] ページで、[クラスターテンプレート] をクリックします。

  3. ダイアログボックスで、作成するクラスタータイプを選択し、[作成] をクリックして、クラスター構成ページでクラスター情報を構成します。

  4. 構成が完了したら、[構成の確認] ページの右上隅にある [同等のコード] をクリックします。ダイアログボックスに、クラスターの作成に必要なパラメーターの組み合わせが表示されます。これをコピーして使用できます。

重要 2026 年 7 月 4 日以降、一部のリクエストパラメーターは効果がなくなります。変更内容および代替パラメーターの詳細については、「ACK クラスター管理の OpenAPI リクエストおよび応答パラメーターの変更と OpenAPI のオフライン化に関するお知らせ」を参照してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cs:CreateCluster

create

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/*

  • cs:ClusterType
  • cs:ClusterSpec
  • cs:ClusterProfile
  • cs:EnableSecretEncryption
  • cs:EnableApiServerEip
  • cs:EnableAddonLogtailDs
  • cs:EnableCoreControlPlaneComponentsLog
  • cs:AddonNames
  • cs:EnableSNAT
  • cs:EnableNodePoolPublicIP
なし

リクエスト構文

POST /clusters HTTP/1.1

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

body

object

任意

リクエストボディパラメーター。

cluster-demo

access_control_list deprecated

array

任意

[非推奨] 登録済みクラスターの API サーバー用の SLB インスタンスのアクセスコントロールリスト (ACL)。

string

任意

登録済みクラスターの API サーバー用の SLB インスタンスのアクセスコントロールリスト (ACL)。

192.168.XX.XX/24

addons

array

任意

クラスターコンポーネントのリスト。クラスターの作成時に、addons を使用してインストールするコンポーネントを指定します。

ネットワークコンポーネント: 必須。Flannel と Terway の 2 種類のネットワークタイプが利用可能です。クラスターの作成時にいずれかを選択します。

  • Flannel: [{"name":"flannel","config":""}]。

  • Terway: [{"name": "terway-eniip","config": ""}]。

ストレージコンポーネント: 任意。csi タイプのみサポートされています。

csi: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}]。

ログコンポーネント: 任意。このコンポーネントを有効にすることを推奨します。ログサービスを有効にしない場合、クラスター監査の特徴を使用できません。

  • 既存の SLS プロジェクト を使用: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}]。

  • 新しい SLS プロジェクト を作成: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true"}"}]。

Ingress コンポーネント: 任意。デフォルトでは、ACK 専用クラスターには Ingress コンポーネント nginx-ingress-controller がインストールされます。

  • Ingress をインストールし、インターネットアクセスを有効化: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}]。

  • デフォルトで Ingress をインストールしない: [{"name": "nginx-ingress-controller","config": "","disabled": true}]。

イベントセンター: 任意。デフォルトで有効。

イベントセンターは、Kubernetes イベントの保存、クエリ、アラート構成機能を提供します。Kubernetes イベントセンターに関連付けられた Logstore は 90 日間は充電が無料です。無料ポリシーの詳細については、「Kubernetes イベントセンターの作成と使用」を参照してください。

イベントセンターを有効にする例: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}]。

addon

任意

クラスターコンポーネントのリスト。クラスターの作成時に、addons を使用してインストールするコンポーネントを指定します。

api_audiences

string

任意

ServiceAccount は、Pod がクラスター API サーバーと通信するために使用するアクセス認証情報です。api-audiences パラメーターは、apiserver がリクエスト token の正当性を認証するために使用する有効なリクエスト token ID を指定します。コンマ (,) で区切られた複数の audiences を構成できます。

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

kubernetes.default.svc

audit_log_config

object

任意

クラスター監査ログの構成。

enabled

boolean

任意

クラスター監査ログの特徴を有効にするかどうかを指定します。

  • true: 有効。

  • false: 無効。

true

sls_project_name

string

任意

クラスター監査ログ用の Logstore を含む SLS プロジェクト。

  • デフォルト値: k8s-log-{clusterid}。

  • クラスター監査ログの特徴が有効化されると、指定された SLS プロジェクトにクラスター監査ログ用の Logstore が作成されます。

k8s-log-c2345xxxxxxxxxxxx

auto_mode

object

任意

インテリジェントマネージドモード の構成。

enable

boolean

任意

インテリジェントマネージドモードを有効にするかどうかを指定します。

  • true: 有効。

  • false: 無効。

true

auto_renew deprecated

boolean

任意

[非推奨]

自動更新を有効にするかどうかを指定します。このパラメーターは、charge_type が PrePaid にセットされている場合にのみ効果があります。有効な値:

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

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

デフォルト値: false。

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

true

auto_renew_period deprecated

integer

任意

[非推奨]

自動更新期間。このパラメーターは、サブスクリプションと自動更新が選択されている場合にのみ効果があります。PeriodUnit=Month の場合、有効な値: {1, 2, 3, 6, 12}。

デフォルト値: 1。

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

1

charge_type deprecated

string

任意

[非推奨]

API サーバーが使用する CLB インスタンスの課金方法。デフォルト値: PostPaid。有効な値:

  • PostPaid: 従量課金。

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

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

  • 2024 年 12 月 1 日以降、新規作成された CLB インスタンスではサブスクリプション課金方法がサポートされなくなり、インスタンス料金が課金されます。

詳細については、「Classic Load Balancer (CLB) の課金変更に関するお知らせ」を参照してください。

PostPaid

cis_enabled deprecated

boolean

任意

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

false

client_token

string

任意

クライアントトークン。

0a287651-1277-4c0d-80d2-623a4*****

cloud_monitor_flags deprecated

boolean

任意

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

クラスターに CloudMonitor エージェントをインストールするかどうかを指定します。有効な値:

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

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

デフォルト値: false。

false

cluster_domain

string

任意

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

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

cluster.local

cluster_spec

string

任意

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 プロビジョニング済みコントロールプレーンによって提供される 3 つのティアです。コントロールプレーンリソースを事前割り当ておよび専有することで、これらのティアは API の同時実行数と Pod のスケジューリング機能が一貫して高いレベルに維持されることを保証します。AI トレーニングおよび推論、超大規模クラスター、および重要な作業に適しています。

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

ack.pro.small

cluster_type

string

任意

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

  • ManagedKubernetes: ACK マネージドクラスタータイプ。ACK マネージドクラスター (Pro エディション、Basic Edition)、サーバーレス Kubernetes クラスター (Pro エディション、Basic Edition)、ACK Edge クラスター (Pro エディション、Basic Edition)、および ACK Lingjun クラスター (Pro エディション) が含まれます。

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

Kubernetes

container_cidr

string

任意

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

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

説明

このパラメーターは Flannel クラスターに必須です。

172.20.0.0/16

control_plane_config

object

任意

ACK 専用クラスターのコントロールプレーン構成。

auto_renew

boolean

任意

コントロールプレーンノードの自動更新を有効にするかどうかを指定します。このパラメーターは、課金方法が PrePaid に設定されている場合にのみ効果が得られます。有効な値:

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

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

デフォルト値: true。

true

auto_renew_period

integer

任意

コントロールプレーンノードの自動更新期間。

有効な値: {1, 2, 3, 6, 12}。単位: 月。

デフォルト値: 1。

1

charge_type

string

任意

コントロールプレーンノードの課金方法。

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

  • PostPaid: 従量課金。

デフォルト値: PostPaid。

PostPaid

cloud_monitor_flags

boolean

任意

ノードに CloudMonitor をインストールするかどうかを指定します。

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

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

デフォルト値: false。

false

cpu_policy

string

任意

ノードの CPU 管理ポリシー。

  • static (静的): ノード上の特定のリソース特性 (文字) を持つ Pod に、強化された CPU アフィニティと排他性を付与できます。

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

デフォルト値: none。

none

deploymentset_id

string

任意

デプロイメントセットの ID。

ds-bp10b35imuam5amw****

image_id

string

任意

イメージの ID。

aliyun_3_x64_20G_alibase_20240819.vhd

image_type

string

任意

オペレーティングシステムイメージのタイプ。

AliyunLinux3

instance_metadata_options InstanceMetadataOptions

任意

ECS インスタンスメタデータのアクセス構成。

instance_types

array

任意

ノードのインスタンスタイプ。

string

任意

ノードのインスタンスタイプ。

ecs.g6.large

key_pair

string

任意

キーペア名。このパラメーターまたは login_password のいずれかを指定する必要があります。

ack

login_password

string

任意

SSH ログインパスワード。パスワードの長さは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。このパラメーターまたは key_pair のいずれかを指定する必要があります。

********

node_port_range

string

任意

[非推奨] ノードのサービスポート範囲。

30000-32767

period

integer

任意

コントロールプレーンノードのサブスクリプション期間。このパラメーターは必須であり、課金方法が PrePaid に設定されている場合にのみ効果が得られます。

有効な値: {1, 2, 3, 6, 12, 24, 36, 48, 60}。単位: 月。

デフォルト値: 1。

1

period_unit

string

任意

コントロールプレーンノードのサブスクリプション期間の単位。このパラメーターは必須であり、課金方法が PrePaid に設定されている場合にのみ効果が得られます。

有効な値: Month。現在、月単位の課金サイクルのみがサポートされています。

Month

runtime

string

任意

[非推奨] コントロールプレーンノードのランタイム名。有効な値:

containerd: すべてのクラスターバージョンをサポートする Containerd コンテナランタイム。

containerd

security_hardening_os

boolean

任意

Alibaba Cloud OS のセキュリティ強化を有効にするかどうかを指定します。

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

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

デフォルト値: false。

false

size

integer

任意

コントロールプレーンノードの数。

有効な値: 3 または 5。

3

soc_enabled

boolean

任意

MLPS セキュリティ強化を有効にするかどうかを指定します。

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

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

デフォルト値: false。

false

system_disk_bursting_enabled

boolean

任意

ノードシステムクラウドディスクのバーストパフォーマンスを有効にするかどうかを指定します。

  • true: 有効。

  • false: 無効。

このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみサポートされます。

true

system_disk_category

string

任意

ノードシステムクラウドディスクのディスクタイプ。

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • cloud_auto: ESSD AutoPL クラウドディスク。

  • cloud_essd_entry: ESSD Entry クラウドディスク。

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

cloud_ssd

system_disk_performance_level

string

任意

ノードシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクに対してのみ効果が得られます。

パフォーマンスレベルのフォーマットはクラウドディスクのサイズによって異なります。詳細については、「ESSD クラウドディスク」を参照してください。

PL1

system_disk_provisioned_iops

integer

任意

ノードシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。

有効な値: 0 ~ min{50,000, 1000 × capacity - baseline performance}。ベースラインパフォーマンス = min{1,800 + 50 × capacity, 50000}。

このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみサポートされます。

1000

system_disk_size

integer

任意

ノードシステムクラウドディスクのサイズ。

有効な値: [40, 500]。単位: GiB。

デフォルト値: 120。

120

system_disk_snapshot_policy_id

string

任意

ノードシステムクラウドディスクの自動スナップショットポリシー。

sp-2zej1nogjvovnz4z****

control_plane_endpoints_config

object

任意

クラスターエンドポイントの構成。

internal_dns_config

object

任意

クラスターの内部 DNS 構成。このパラメーターは ACK マネージドクラスターに適用されます。内部ドメイン名は、kubelet や kube-proxy などのノード側のシステムコンポーネントが API サーバーにアクセスするために使用されます。内部ドメイン名アクセスが有効になっていない場合、ノード側のシステムコンポーネントは CLB IP アドレスを通じて API サーバーにアクセスします。

bind_vpcs

array

任意

クラスターの内部 DNS レコードの効果が得られる VPC。

string

任意

クラスターの内部 DNS レコードの効果が得られる VPC。

vpc-xxxx

load_balancers_config

array<object>

任意

クラスターエンドポイントの構成。このパラメーターを指定すると、endpoint_public_access パラメーターと load_balancer_id パラメーターは効果が得られません。ACK は NLB インスタンスの自動作成のみをサポートしています。クラスターアクセスのロードバランサー構成で CLB または NLB インスタンスを指定するには、load_balancers_config を使用して対応するインスタンス ID を指定します。

object

任意

クラスターアクセスの負荷分散構成。

endpoint_type

string

任意

エンドポイントタイプ。

非公開

load_balancer_id

string

任意

NLB インスタンスの ID。

nlb-0ogk9aaxxxxxxx

controlplane_log_components

array

任意

ログを収集するコントロールプレーンコンポーネントを指定するコンポーネント名のリスト。

デフォルトでは、kube-apiserver (API サーバー)、kube-controller-manager、kube-scheduler (スケジューラ)、cloud-controller-manager からログが収集されます。

string

任意

ログを収集するコントロールプレーンコンポーネントを指定するコンポーネント名のリスト。

デフォルトでは、kube-apiserver (API サーバー)、kube-controller-manager、kube-scheduler (スケジューラ)、cloud-controller-manager からログが収集されます。

["API サーバー","kcm","スケジューラ"]

controlplane_log_project

string

任意

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

k8s-log-xxx

controlplane_log_ttl

string

任意

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

30

cpu_policy deprecated

string

任意

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

ノードの CPU 管理ポリシー。バージョン 1.12.6 以降を実行中のクラスターでは、以下のポリシーがサポートされています。

  • static (静的): ノード上の特定のリソース特性 (文字) を持つ Pod に、強化された CPU アフィニティと排他性を付与できます。

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

デフォルト値: none。

none

custom_san deprecated

string

任意

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

カスタム証明書のネイティブな Subject Alternative Name (SAN)。複数の IP アドレスまたはドメイン名はコンマ (,) で区切ります。

cs.aliyun.com

deletion_protection

boolean

任意

クラスターの削除保護を有効にするかどうかを指定します。削除保護を有効にすると、コンソールまたは API 操作の呼び出しによるクラスターの意図しない削除を防ぎます。有効な値:

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

  • false: クラスターの削除保護を無効にします。コンソールまたは API 操作の呼び出しでクラスターを削除できます。

デフォルト値: false。

true

disable_rollback deprecated

boolean

任意

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

クラスターの作成に失敗した場合にクラスターをロールバックするかどうかを指定します。有効な値:

  • true: クラスターの作成に失敗した場合、クラスターをロールバックします。

  • false: クラスターの作成に失敗した場合、クラスターをロールバックしません。

デフォルト値: true。

true

enable_rrsa deprecated

boolean

任意

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

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

  • true: 機能を有効にします。

  • false: 機能を有効にしません。

false

encryption_provider_key

string

任意

クラウドディスクを暗号化する際に使用される Key Management Service (KMS) キーの ID。詳細は、「Key Management Service」を参照してください。

説明

この機能は、コンテナサービス ACK Pro クラスターでのみ有効です。

0fe64791-55eb-4fc7-84c5-c6c7cdca****

endpoint_public_access

boolean

任意

パブリックネットワークアクセスを有効にするかどうかを指定します。Elastic IP Address (EIP) を使用して API サーバーを公開し、クラスターへのパブリックネットワークアクセスを可能にします。

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

  • false: パブリックネットワークアクセスを無効にします。パブリックネットワークアクセスを有効にしない場合、クラスターの API サーバーにはインターネット経由でアクセスできません。

デフォルト値: false。

true

extra_sans

array

任意

API サーバー証明書のネイティブなカスタム Subject Alternative Name (SAN)。

string

任意

証明書の SAN。カスタム IP アドレスまたはドメイン名をサポートします。

192.168.xx.xx

format_disk deprecated

boolean

任意

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

既存のインスタンスを使用してクラスターを作成する際に、既存のインスタンスにデータディスクをマウントするかどうかを指定します。有効な値:

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

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

デフォルト値: false。

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

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

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

false

image_id deprecated

string

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下の image_id パラメーターを使用してください。ノードプール構成には、代わりに nodepool のスケーリンググループの下の image_id パラメーターを使用してください。

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

m-bp16z7xko3vvv8gt****

image_type deprecated

string

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下の image_type パラメーターを使用してください。ノードプール構成には、代わりに nodepool のスケーリンググループの下の image_type パラメーターを使用してください。

オペレーティングシステムイメージのディストリビューションタイプ。ノードのオペレーティングシステムを指定するには、このフィールドを使用することを推奨します。有効な値:

  • CentOS

  • AliyunLinux

  • AliyunLinux Qboot

  • AliyunLinuxUEFI

  • AliyunLinux3

  • Windows

  • WindowsCore

  • AliyunLinux3Arm64

  • ContainerOS

デフォルト値: CentOS。

AliyunLinux

instances deprecated

array

任意

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

既存のノードを使用してクラスターを作成する際に使用する ECS インスタンスのリスト。これらのインスタンスはワーカーノードとしてクラスターに追加されます。

説明

このフィールドは、既存のインスタンスを使用してクラスターを作成する場合に必須です。

string

任意

既存のノードを使用してクラスターを作成する際に使用する ECS インスタンスのリスト。これらのインスタンスはワーカーノードとしてクラスターに追加されます。

説明

このフィールドは、既存のインスタンスを使用してクラスターを作成する場合に必須です。

i-2ze4zxnm36vq00xn****

ip_stack

string

任意

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

有効な値: ipv4 (シングルスタック) dual (デュアルスタック)。デフォルト値: ipv4

is_enterprise_security_group

boolean

任意

高度なセキュリティグループの自動作成を有効にするかどうかを指定します。このパラメーターは、security_group_id が空の場合に有効です。

説明

基本セキュリティグループを使用する場合、クラスター内のノードと Terway Pod の合計数は 2,000 を超えることはできません。したがって、Terway ネットワークタイプのクラスターを作成する際は、高度なセキュリティグループを使用してください。

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

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

デフォルト値: true。

true

keep_instance_name deprecated

boolean

任意

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

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

  • true: インスタンス名を保持します。

  • false: インスタンス名を保持しません。名前はシステム生成の名前に置き換えられます。

デフォルト値: true。

true

key_pair deprecated

string

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下の key_pair パラメーターを使用してください。ノードプール構成には、代わりに nodepool の scaling_group (グループ) の下の key_pair パラメーターを使用してください。

キーペアの名前。login_password (ログインパスワード) とは相互排他です。

セキュリティキー

kubernetes_version

string

任意

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

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

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

1.32.1-aliyun.1

load_balancer_id

string

任意

API サーバーアクセスに使用される Classic Load Balancer (CLB) インスタンスのインスタンス ID。このパラメーターが指定されている場合、API サーバー CLB インスタンスの自動作成はスキップされます。

説明

CLB インスタンスに他の依存関係 (リスナーやバックエンドサーバーなど) がないことを確認してください。共有 CLB インスタンスおよびインターネット向け CLB インスタンスはサポートされていません。

lb-wz9t256gqa3vbouk****

load_balancer_spec deprecated

string

任意

[非推奨] CLB は従量課金制を使用します。このパラメーターは有効ではありません。

負荷分散の仕様。有効な値:

  • slb.s1.small

  • slb.s2.small

  • slb.s2.medium (中間)

  • slb.s3.small

  • slb.s3.medium (中間)

  • slb.s3.large

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

slb.s2.small

logging_type deprecated

string

任意

[非推奨] クラスターのログサービスを有効にします。このパラメーターはサーバーレス Kubernetes クラスターでのみ有効であり、値は SLS である必要があります。

SLS

login_password deprecated

string

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下の login_password パラメーターを使用してください。ノードプール構成には、代わりに nodepool の scaling_group (グループ) の下の login_password パラメーターを使用してください。

SSH ログインパスワード。key_pair (キーペア) とは相互排他です。パスワードは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。

null

maintenance_window maintenance_window

任意

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

master_auto_renew deprecated

boolean

任意

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

マスターノードの自動更新を有効にするかどうかを指定します。このパラメーターは、master_instance_charge_type (インスタンス充電) が PrePaid に設定されている場合にのみ有効です。有効な値:

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

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

デフォルト値: true。

true

master_auto_renew_period deprecated

integer

任意

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

マスターノードの自動更新の期間。このパラメーターは、サブスクリプション課金方法が選択されている場合にのみ有効であり、必須です。

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

デフォルト値: 1。

1

master_count deprecated

integer

任意

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

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

デフォルト値: 3。

3

master_instance_charge_type deprecated

string

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下の instance_charge_type (インスタンス充電) パラメーターを使用してください。

マスターノードの課金方法。有効な値:

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

  • PostPaid: 従量課金。

デフォルト値: PostPaid。

PrePaid

master_instance_types deprecated

array

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下の instance_types パラメーターを使用してください。

マスターノードのインスタンスタイプ。詳細は、「インスタンスファミリー」を参照してください。

string

任意

マスターノードのインスタンスタイプ。指定するインスタンスタイプの数は master_count の値と一致し、master_instance_types の要素と 1 対 1 で対応している必要があります。詳細は、「インスタンスファミリー」を参照してください。

ecs.n4.xlarge

master_period deprecated

integer

任意

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

マスターノードのサブスクリプション期間。このパラメーターは、master_instance_charge_type (インスタンス充電) が PrePaid に設定されている場合にのみ有効であり、必須です。

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

デフォルト値: 1。

1

master_period_unit deprecated

string

任意

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

マスターノードの課金期間の単位。このパラメーターは、課金方法が PrePaid の場合に必須です。

有効な値: Month。現在、月額課金のみがサポートされています。

Month

master_system_disk_category deprecated

string

任意

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

マスターノードのシステムクラウドディスクタイプ。有効な値:

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD (エンタープライズ SSD)。

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

cloud_ssd

master_system_disk_performance_level deprecated

string

任意

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

マスターノードのシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクに対してのみ有効です。パフォーマンスレベルはディスクサイズに関連しています。詳細は、「ESSD クラウドディスク」を参照してください。

PL1

master_system_disk_size deprecated

integer

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下の system_disk_size パラメーターを使用してください。

マスターノードのシステムクラウドディスクサイズ。有効な値: [40,500]。単位: GiB。

デフォルト値: 120。

120

master_system_disk_snapshot_policy_id deprecated

string

任意

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

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

sp-2zej1nogjvovnz4z****

master_vswitch_ids deprecated

array

任意

[非推奨] 代わりに vswitch_ids パラメーターを使用してください。

マスターノード用の vSwitch ID のリスト。vSwitch の数は [1,3] の範囲内である必要があります。高可用性を確保するため、異なるゾーンに分散された 3 つの vSwitch を選択してください。

指定するインスタンスタイプの数は master_count の値と一致し、master_vswitch_ids の要素と 1 対 1 で対応している必要があります。

string

任意

マスターノード用の vSwitch ID のリスト。vSwitch の数は [1,3] の範囲内である必要があります。高可用性を確保するため、異なるゾーンに分散された 3 つの vSwitch を選択してください。

指定するインスタンスタイプの数は master_count の値と一致し、master_vswitch_ids の要素と 1 対 1 で対応している必要があります。

vsw-2ze3ds0mdip0hdz8i****

name

string

必須

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

クラスターデモ

nat_gateway deprecated

boolean

任意

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

true

node_cidr_mask

string

任意

ネットワーク CIDR ブロックを指定することで決定される、ノードごとの IP アドレスの数。このパラメーターは、Flannel ネットワークタイプのクラスターに対してのみ有効です。

デフォルト値: 26。

25

node_name_mode deprecated

string

任意

[非推奨] ノードプール構成には、代わりに nodepool の kubernetes_config の下の node_name_mode パラメーターを使用してください。

null

node_port_range deprecated

string

任意

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

デフォルト値: 30000-32767。

30000~32767

nodepools

array

任意

ノードプールのリスト。

nodepool

任意

ノードプール構成。

num_of_nodes deprecated

integer

任意

[非推奨] 代わりにノードプールの scaling_group (グループ) 配下の desired_size パラメーターを使用してください。

ワーカーノードの数。有効な値: 0 ~ 100。

3

operation_policy

object

任意

クラスターの自動 O&M ポリシー。

cluster_auto_upgrade

object

任意

クラスターの自動スペックアップ構成。

channel

string

任意

クラスターの自動スペックアップチャネル。有効な値:

  • patch: 現在のマイナーバージョン内で利用可能な最新のパッチバージョンに自動的にスペックアップします。新しい Kubernetes バージョンには破壊的変更は含まれません。

  • stable: 2 番目に新しいマイナーバージョンの最新のパッチバージョンに自動的にスペックアップします。新しい Kubernetes バージョンには API 呼び出しや特徴の変更が含まれる場合がありますが、その安定性は広範に検証されています。

  • rapid: 最新のマイナーバージョンの最新のパッチバージョンに自動的にスペックアップし、Kubernetes コミュニティの新しい特徴へのより迅速なアクセスを可能にします。

stable

enabled

boolean

任意

クラスターの自動スペックアップを有効にするかどうかを指定します。

  • true: 有効。

  • false: 無効。

true

os_type deprecated

string

任意

[非推奨] クラスターのコントロールプレーンノード構成には、代わりに control_plane_config 配下の image_type パラメーターを使用してください。ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の image_type パラメーターを使用してください。

オペレーティングシステムイメージのプラットフォームタイプ。有効な値:

  • Windows

  • Linux

デフォルト値: Linux。

Linux

period deprecated

integer

任意

[非推奨]

サブスクリプション期間。このパラメーターは、charge_type (充電) が PrePaid にセットされている場合にのみ効果が現れ、必須となります。

有効な値: 1、2、3、6、12、24、36、48、60。

デフォルト値: 1。

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

1

period_unit deprecated

string

任意

[非推奨]

課金サイクル。このパラメーターは、課金方法が PrePaid にセットされている場合に必須です。

有効な値: Month。現在、月単位の課金サイクルのみがサポートされています。

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

Month

platform deprecated

string

任意

[非推奨] ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の platform パラメーターを使用してください。

オペレーティングシステムのプラットフォーム。有効な値:

  • CentOS

  • AliyunLinux

  • QbootAliyunLinux

  • Qboot

  • Windows

  • WindowsCore

デフォルト値: CentOS。

CentOS

pod_vswitch_ids deprecated

array

任意

[非推奨] ネットワークプラグインとして Terway を選択する場合、Pod に IP アドレスを割り当てるために vSwitch を割り当てる必要があります。各 Pod vSwitch はワーカーノード vSwitch に対応し、Pod vSwitch は対応するワーカーノード vSwitch と同じゾーンにある必要があります。

説明

Pod vSwitch の CIDR ブロックのマスク長は 19 以下である必要があり、25 を超えてはなりません。そうでない場合、クラスターネットワークで利用可能な Pod IP アドレスの数が非常に制限され、通常のクラスター操作に影響を与えます。

string

任意

ネットワークプラグインとして Terway を選択する場合、Pod に IP アドレスを割り当てるために vSwitch を割り当てる必要があります。各 Pod vSwitch はワーカーノード vSwitch に対応し、Pod vSwitch は対応するワーカーノード vSwitch と同じゾーンにある必要があります。

説明

Pod vSwitch の CIDR ブロックのマスク長は 19 以下である必要があり、25 を超えてはなりません。そうでない場合、クラスターネットワークで利用可能な Pod IP アドレスの数が非常に制限され、通常のクラスター操作に影響を与えます。

vsw-2ze97jwri7cei0mpw****

profile

string

任意

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

  • Default: ACK マネージドクラスター。ACK クラスター (Pro エディションおよび Basic Edition) を含みます。

  • Edge: ACK Edge クラスター。ACK Edge クラスター (Pro エディションおよび Basic Edition) を含みます。

  • Serverless: サーバーレス Kubernetes クラスター。サーバーレス Kubernetes クラスター (Pro エディションおよび Basic Edition) を含みます。

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

Default

proxy_mode

string

任意

kube-proxy プロキシモード。

  • iptables: 成熟で安定した kube-proxy モード。Kubernetes サービスのサービス検出と負荷分散は、iptables ルールを使用して構成されます。パフォーマンスは中程度で、クラスター規模の影響を受けます。このモードは、サービス数が small のクラスター操作に適しています。

  • ipvs: 高性能な kube-proxy モード。Kubernetes サービスのサービス検出と負荷分散は、Linux IPVS モジュールを使用して構成されます。このモードは、高い負荷分散パフォーマンスを必要とするサービス数が large のクラスターに適しています。

  • nftables: Linux nftables に基づいてサービス検出と負荷分散を実装する次世代の kube-proxy モード。iptables の現代的な代替手段です。iptables と比較して、nftables はより優れたネットワークパフォーマンス、より効率的なルール更新、および大規模サービスシナリオにおける改善された動作を提供します。
    バージョン 1.35 以降を実行中のクラスターでのみサポートされています。Kubernetes コミュニティはバージョン 1.35 から IPVS を非推奨としました。新しいクラスターでは、長期的な term のコミュニティサポートのために nftables を使用してください。

デフォルト値: ipvs。

ipvs

rds_instances deprecated

array

任意

[非推奨] ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の rds_instances パラメーターを使用してください。

ApsaraDB RDS インスタンスのリスト。ホワイトリストに追加する RDS インスタンスを選択します。コンテナ Pod の CIDR ブロックとノードの CIDR ブロックを RDS ホワイトリストに直接追加します。インスタンスが実行中状態でない場合、RDS インスタンスの構成が失敗する可能性があります。

string

任意

ApsaraDB RDS インスタンスのリスト。ホワイトリストに追加する RDS インスタンスを選択します。コンテナ Pod の CIDR ブロックとノードの CIDR ブロックを RDS ホワイトリストに直接追加します。インスタンスが実行中状態でない場合、RDS インスタンスの構成が失敗する可能性があります。

rm-2zev748xi27xc****

region_id

string

必須

クラスターがデプロイされているリージョンの ID。詳細については、「コンテナサービスでサポートされているリージョン」を参照してください。

cn-beijing

resource_group_id

string

任意

クラスターが属するリソースグループの ID。このパラメーターを使用して、異なるリソースを分離します。

rg-acfm3mkrure****

rrsa_config

object

任意

RAM Roles for サービスアカウント (RRSA) 特徴の構成。

enabled

boolean

任意

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

  • true: 有効。

  • false: 無効。

true

runtime deprecated runtime

任意

クラスターで使用されるコンテナランタイム。サポートされているランタイムには、containerd、サンドボックスコンテナ、Docker などがあります。

説明

Kubernetes 1.24 では、Docker は組み込みコンテナランタイムとしてサポートされなくなりました。

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

security_group_id

string

任意

既存のセキュリティグループの ID。このパラメーターは is_enterprise_security_group と相互排他です。クラスターノードは自動的にこのセキュリティグループに追加されます。

sg-bp1bdue0qc1g7k****

security_hardening_os deprecated

boolean

任意

[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config 配下の security_hardening_os パラメーターを使用してください。ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の security_hardening_os パラメーターを使用してください。

Alibaba Cloud OS のセキュリティ強化を有効にするかどうかを指定します。有効な値:

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

  • false: Alibaba Cloud OS のセキュリティ強化を有効にしません。

デフォルト値: false。

false

service_account_issuer

string

任意

ServiceAccount は、Pod がクラスター API サーバーと通信するために使用するアクセス認証情報です。service-account-issuer は serviceaccount トークン内の発行者 ID であり、トークンペイロード内の iss フィールドです。

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

kubernetes.デフォルト.svc

service_cidr

string

任意

サービスネットワークの 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 ブロックと重複できません。この値は、クラスターの作成後に変更できません。

デフォルト値: 172.19.0.0/20。

172.21.0.0/20

service_discovery_types deprecated

array

任意

[非推奨] クラスター内のサービス検出タイプ。このパラメーターは、サーバーレス Kubernetes クラスターでのサービス検出メソッドを指定します。

  • CoreDNS: Kubernetes ネイティブの標準サービス検出コンポーネントである CoreDNS を使用します。DNS 解像度のために、クラスターに一連のコンテナをセットする必要があります。デフォルトでは、0.25 コア、512 MiB 仕様の 2 つの ECI インスタンスが使用されます。

  • PrivateZone: Alibaba Cloud PrivateZone を使用してサービス検出機能を提供します。PrivateZone サービスを有効化する必要があります。

デフォルト値: 有効化されていません。

string

任意

クラスター内のサービス検出タイプ。このパラメーターは、サーバーレス Kubernetes クラスターでのサービス検出メソッドを指定します。

  • CoreDNS: Kubernetes ネイティブの標準サービス検出コンポーネントである CoreDNS を使用します。DNS 解像度のために、クラスターに一連のコンテナをセットする必要があります。デフォルトでは、0.25 コア、512 MiB 仕様の 2 つの ECI インスタンスが使用されます。

  • PrivateZone: Alibaba Cloud PrivateZone を使用してサービス検出機能を提供します。PrivateZone サービスを有効化する必要があります。

デフォルト値: 有効化されていません。

PrivateZone

snat_entry

boolean

任意

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

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

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

説明

クラスター作成時にこのオプションを有効にせず、後でインターネットアクセスが必要になった場合は、手動で有効にすることができます。

デフォルト値: false。

false

soc_enabled deprecated

boolean

任意

[非推奨] クラスターのコントロールプレーンノード構成には、代わりに control_plane_config 配下の soc_enabled パラメーターを使用してください。ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の soc_enabled パラメーターを使用してください。

MLPS 2.0 セキュリティ強化を有効にするかどうかを指定します。詳細については、「ACK の中国等級保護コンプライアンス」を参照してください。

有効な値:

  • true: 等級保護コンプライアンス強化を有効にします。

  • false: 等級保護コンプライアンス強化を有効にしません。

デフォルト値: false。

false

ssh_flags

boolean

任意

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

  • true: 有効。

  • false: 無効。

デフォルト値: false。

true

tags

array

任意

ノードタグ。タグ解像度ルール:

  • タグは大文字と小文字が区別されるキーと値のペアです。最大 20 個のタグをセットできます。

  • タグキーは重複できず、最大 64 文字の長さにできます。タグ値は空にでき、最大 128 文字の長さにできます。タグキーとタグ値は "aliyun"、"acs:"、"https://"、または "http://" で始めることはできません。詳細については、「Labels and Selectors」の構文と文字セットを参照してください。

tag

任意

ノードタグ。タグ解像度ルール:

  • タグは大文字と小文字が区別されるキーと値のペアです。最大 20 個のタグをセットできます。

  • タグキーは重複できず、最大 64 文字の長さにできます。タグ値は空にでき、最大 128 文字の長さにできます。タグキーとタグ値は "aliyun"、"acs:"、"https://"、または "http://" で始めることはできません。詳細については、「Labels and Selectors」の構文と文字セットを参照してください。

taints deprecated

array

任意

[非推奨] ノードプール構成には、代わりにノードプールの kubernetes_config 配下の taints パラメーターを使用してください。

ノードの Taint 情報。Taint と Toleration は連携して作業し、Pod が不適切なノードにスケジューリングされるのを防ぎます。詳細については、「taint-and-toleration」のイベントとエビクションを参照してください。

taint

任意

ノードの Taint 情報。Taint と Toleration は連携して作業し、Pod が不適切なノードにスケジューリングされるのを防ぎます。詳細については、「taint-and-toleration」のイベントとエビクションを参照してください。

timeout_mins deprecated

integer

任意

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

クラスター作成のタイムアウト期間 (分単位)。

デフォルト値: 60。

60

timezone

string

任意

クラスターで使用されるタイムゾーン時間。詳細については、「サポートされているタイムゾーンフォーマット」を参照してください。

Asia/Shanghai

user_ca

string

任意

カスタムクラスター認証局 (CA)。

-----BEGIN CERTIFICATE-----****

user_data deprecated

string

任意

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

IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****

vpcid

string

任意

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

vpc-2zeik9h3ahvv2zz95****

vswitch_ids

array

任意

クラスターノード用の vSwitch。このパラメーターは、ノード数 0 のマネージドクラスターを作成するときに必須です。

string

任意

クラスターノード用の vSwitch。このパラメーターは、ノード数 0 のマネージドクラスターを作成するときに必須です。

vsw-2ze3ds0mdip0hdz8i****

worker_auto_renew deprecated

boolean

任意

[非推奨] ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の auto_renew パラメーターを使用してください。

作業ノードの自動更新を有効にするかどうかを指定します。このパラメーターは、worker_instance_charge_type (充電) が PrePaid にセットされている場合にのみ効果が現れます。有効な値:

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

  • false: 自動更新を有効にしません。

デフォルト値: true。

true

worker_auto_renew_period deprecated

integer

任意

[非推奨] ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の auto_renew_period パラメーターを使用してください。

ワーカーノードの自動更新期間。このパラメーターは、サブスクリプション課金方法が選択されている場合にのみ効果が現れ、必須となります。

有効な値: 1、2、3、6、12。

1

worker_data_disks deprecated

array<object>

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の data_disks パラメーターを使用してください。

ワーカーノードのデータクラウドディスクタイプ、サイズ、およびその他の構成の組み合わせ。

object

任意

データクラウドディスクの構成セット。

category

string

必須

データクラウドディスクタイプ。

cloud_essd

encrypted

string

任意

データクラウドディスクを暗号化するかどうかを指定します。有効な値:

  • true: データクラウドディスクを暗号化します。

  • false: データクラウドディスクを暗号化しません。

デフォルト値: false。

true

performance_level

string

任意

ノードデータクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスク に対してのみ効果を発揮します。

PL1

size

string

必須

データクラウドディスクサイズ。有効な値: 40 ~ 32767。単位: GiB。

120

worker_instance_charge_type deprecated

string

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の instance_charge_type パラメーターを使用してください。

作業インスタンスの充電メソッド。有効な値:

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

  • PostPaid: 従量課金。

デフォルト値: 従量課金。

PrePaid

worker_instance_types deprecated

array

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の instance_types パラメーターを使用してください。

ワーカーノードのインスタンス構成。

string

任意

ワーカーノードのインスタンスタイプ。少なくとも 1 つのインスタンスタイプを指定します。詳細については、「インスタンスファミリー」を参照してください。

説明

インスタンスタイプの優先度は、配列フォーマット内の位置が後ろになるほど低くなります。優先度の高いインスタンスタイプに基づいてインスタンス作成を呼び出せない場合、システムは自動的に次の優先度のインスタンスタイプを使用します。

ecs.n4.large

worker_period deprecated

integer

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の period パラメーターを使用してください。

作業ノードのサブスクリプション期間。このパラメーターは、worker_instance_charge_type (作業インスタンス充電タイプ) が PrePaid に設定されている場合にのみ効果を発揮し、必須となります。

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

デフォルト値: 1。

1

worker_period_unit deprecated

string

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の period_unit パラメーターを使用してください。

ワーカーノードの課金期間。このパラメーターは、メソッドが PrePaid の場合に必須です。

有効な値: Month。現在、月単位の課金期間のみがサポートされています。

Month

worker_system_disk_category deprecated

string

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の system_disk_category パラメーターを使用してください。

ワーカーノードのシステムクラウドディスクタイプ。詳細については、「ブロックストレージフォーマットの概要」を参照してください。

有効な値:

  • cloud_efficiency: ウルトラクラウドディスク。

  • cloud_ssd: 標準 SSD。

デフォルト値: cloud_ssd。

cloud_efficiency

worker_system_disk_performance_level deprecated

string

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の system_disk_performance_level パラメーターを使用してください。

システムクラウドディスクが ESSD の場合のシステムクラウドディスクのパフォーマンスレベル (PL) を構成します。詳細については、「ESSD クラウドディスクフォーマット」を参照してください。

有効な値:

  • PL0

  • PL1

  • PL2

  • PL3

PL1

worker_system_disk_size deprecated

integer

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の system_disk_size パラメーターを使用してください。

ワーカーノードのシステムクラウドディスクサイズ。単位: GiB。

有効な値: [40,500]。

このパラメーターの値は、max{40, ImageSize} 以上である必要があります。

デフォルト値: 120。

120

worker_system_disk_snapshot_policy_id deprecated

string

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の system_disk_snapshot_policy_id パラメーターを使用してください。

ワーカーノードのシステムクラウドディスクによって使用される自動スナップショットポリシーの ID。

sp-2zej1nogjvovnz4z****

worker_vswitch_ids deprecated

array

任意

[非推奨] ノードプールの構成には、代わりにノードプールのスケーリンググループ内の vswitch_ids パラメーターを使用してください。

クラスターの作業ノードによって使用される vSwitch のリスト。各ノードは 1 つの値に対応します。

ノード数が 0 のマネージドクラスターを作成する場合、worker_vswitch_ids フィールドは必須ではありませんが、vswitch_ids を指定する必要があります。

string

任意

作業ノードの vSwitch のリスト。有効な値: [1,20]。高可用性を確保するには、異なるゾーンの vSwitch を選択します。

ノード数が 0 のマネージドクラスターを作成する場合、worker_vswitch_ids フィールドは必須ではありませんが、vswitch_ids を指定する必要があります。

vsw-2ze3ds0mdip0hdz8i****

zone_id deprecated

string

任意

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

クラスターが属するリージョンのアクティブなゾーン ID。このパラメーターは ACK マネージドクラスターに固有です。

vpc_id と vswitch_ids を指定せずに ACK マネージドクラスターを作成する場合、クラスターが指定されたゾーンに VPC および関連するネットワークリソースを自動作成できるように、zone_id を指定する必要があります。vpc_id と vswitch_ids が指定されている場合、このパラメーターは無視され、VPC 作成の作業や API 呼び出しは不要です。

cn-beiji****

zone_ids

array

任意

クラスターが属するリージョン内の複数のゾーンの ID。このパラメーターは ACK マネージドクラスターに固有です。

string

任意

クラスターが属するリージョンのアクティブなゾーン ID。このゾーンでは、vSwitch の自動作成が主題となります。

vpc_id と vswitch_ids を指定せずに ACK マネージドクラスターを作成する場合、クラスターが複数のゾーンにまたがって VPC および関連するネットワークリソースを自動作成できるように、zone_ids を指定します。vpc_id と vswitch_ids が指定されている場合、このパラメーターは無視され、VPC 作成の作業や API 呼び出しは不要です。

cn-beijing-h

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスボディ。

cluster_id

string

クラスターの ID。

cb95aa626a47740afbf6aa099b650****

request_id

string

リクエストの ID。

687C5BAA-D103-4993-884B-C35E4314****

task_id

string

タスクの ID。

T-5a54309c80282e39ea****

例

成功レスポンス

JSONJSON

{
  "cluster_id": "cb95aa626a47740afbf6aa099b650****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea****"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。