ACK マネージドクラスター、サーバーレス Kubernetes クラスター、ACK Edge クラスター、登録済みクラスターを含む ACK クラスターを作成します。クラスターの作成時に、クラスター情報 (フォーマット)、クラスターコンポーネント、および ACK 関連のクラウドリソースを構成します。
操作説明
コンソールを使用した OpenAPI リクエストパラメーターの生成
CreateCluster 操作を呼び出してクラスターを作成する際、リクエストパラメーターの組み合わせが正しくないために呼び出しが失敗した場合は、コンソールを使用して必須のリクエストパラメーターの組み合わせを生成できます。次の手順を実行します。
-
コンテナサービス for Kubernetes (ACK) コンソール にログインし、左側のナビゲーションウィンドウで [クラスター] を選択します。
-
[クラスター] ページで、[クラスターテンプレート] をクリックします。
-
ダイアログボックスで、作成するクラスタータイプを選択し、[作成] をクリックして、クラスター構成ページでクラスター情報を構成します。
-
構成が完了したら、[構成の確認] ページの右上隅にある [同等のコード] をクリックします。ダイアログボックスに、クラスターの作成に必要なパラメーターの組み合わせ (フォーマット) が表示されます。これをコピーして使用できます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cs:CreateCluster |
create |
*Cluster
|
|
なし |
リクエスト構文
POST /clusters HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| body |
object |
任意 |
リクエスト本文のパラメーター。 |
クラスターデモ |
access_control_list
deprecated
|
array |
任意 |
[非推奨] 登録済みクラスターの API サーバー用の SLB インスタンスのアクセスコントロールリスト (ACL)。 |
|
|
string |
任意 |
登録済みクラスターの API サーバー用の SLB インスタンスのアクセスコントロールリスト (ACL)。 |
192.168.XX.XX/24 |
|
| addons |
array |
任意 |
クラスターコンポーネントのリスト。クラスターの作成時に、 ネットワークコンポーネント: 必須。Flannel と Terway の 2 種類のネットワークタイプが利用可能です。クラスターの作成時にいずれかを選択します。
ストレージコンポーネント: 任意。
ログコンポーネント: 任意。このコンポーネントを有効にすることを推奨します。Log Service を有効にしない場合、クラスター監査機能を使用できません。
Ingress コンポーネント: 任意。デフォルトでは、Ingress コンポーネント
イベントセンター: 任意。デフォルトで有効。 イベントセンターは、Kubernetes イベントの保存、クエリ、アラート機能を提供します (ノード)。Kubernetes イベントセンターに関連付けられた Logstore は、90 日間、無料です。無料枠の詳細については、「Kubernetes イベントセンターの作成と使用」を参照してください。 イベントセンターを有効にする例: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}]。 |
|
| addon |
任意 |
クラスターコンポーネントのリスト。クラスターの作成時に、 |
||
| api_audiences |
string |
任意 |
ServiceAccount は、Pod がクラスター API サーバーと通信するために使用するアクセス認証情報です。
|
kubernetes.デフォルト.svc |
| audit_log_config |
object |
任意 |
クラスター監査ログ構成。 |
|
| enabled |
boolean |
任意 |
クラスター監査ログ機能を有効にするかどうかを指定します。有効な値:
|
true |
| sls_project_name |
string |
任意 |
クラスター監査ログ用の Logstore を含む Log Service プロジェクト (プロ版)。
|
k8s-log-c2345xxxxxxxxxxxx |
| auto_mode |
object |
任意 |
インテリジェントマネージドモード の構成。 |
|
| enable |
boolean |
任意 |
インテリジェントマネージドモードを有効にするかどうかを指定します。有効な値:
|
true |
auto_renew
deprecated
|
boolean |
任意 |
[非推奨] 自動更新を有効にするかどうかを指定します。このパラメーターは、
デフォルト値: このパラメーターは 2024 年 10 月 15 日に変更されました。詳細については、「CreateCluster パラメーターの動作変更に関するお知らせ」を参照してください。 |
true |
auto_renew_period
deprecated
|
integer |
任意 |
[非推奨] 自動更新期間。このパラメーターは、課金方法が前払いで自動更新が有効な場合にのみ効果を発揮します。 デフォルト値: 1。 このパラメーターは 2024 年 10 月 15 日に変更されました。詳細については、「CreateCluster パラメーターの動作変更に関するお知らせ」を参照してください。 |
1 |
charge_type
deprecated
|
string |
任意 |
[非推奨] API サーバーが使用する CLB インスタンスの課金方法。デフォルト値: PostPaid。有効な値:
重要
詳細については、「Classic Load Balancer (CLB) の課金変更に関するお知らせ」を参照してください。 |
PostPaid |
cis_enabled
deprecated
|
boolean |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに |
false |
| client_token |
string |
任意 |
クライアントトークン。 |
0a287651-1277-4c0d-80d2-623a4***** |
cloud_monitor_flags
deprecated
|
boolean |
任意 |
[非推奨] クラスターのコントロールプレーンノードの構成には、代わりに クラスターに CloudMonitor エージェントをインストールするかどうかを指定します。有効な値:
デフォルト値: |
false |
| cluster_domain |
string |
任意 |
クラスターローカルドメイン名。 命名ルール: ドメイン名は、ピリオド (.) で区切られた 1 つ以上の部分で構成されます。各部分の長さは最大 63 文字で、小文字、数字、およびハイフン (-) を含めることができます。各部分は小文字または数字で始まり、小文字または数字で終わる必要があります。 |
クラスター.local |
| cluster_spec |
string |
任意 |
プロ版 XL、プロ版 2XL、およびプロ版 4XL は、コンテナサービス ACK Pro Provisioned Control Plane によって提供される 3 つのティアです。コントロールプレーンリソースを事前に割り当てて専有することで、これらのティアは API の同時実行数と Pod のスケジューリング機能が一貫して高いレベルに維持されることを保証します。AI トレーニングおよび推論、超大規模クラスター、およびミッションクリティカルな作業に適しています。 プロ版および Provisioned Control Plane エディションのクラスター管理料金の詳細については、クラスター管理料金 (プロダクト概要)を参照してください。 |
ack.pro.small |
| cluster_type |
string |
任意 |
有効な値:
|
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。CIDR ブロックは、VPC CIDR ブロックまたは VPC 内の既存の Kubernetes クラスターで使用されている CIDR ブロックと重複できません。クラスターの作成後、この CIDR ブロックを変更する操作はできません。 クラスターネットワーク計画の詳細については、「ACK マネージドクラスターのネットワークの計画」を参照してください。 説明
このパラメーターは Flannel クラスターに必須です。 |
172.20.0.0/16 |
| control_plane_config |
object |
任意 |
ACK 専用クラスターのコントロールプレーン構成。 |
|
| auto_renew |
boolean |
任意 |
コントロールプレーンノードの自動更新を有効にするかどうかを指定します。このパラメーターは、課金方法が
デフォルト値: true。 |
true |
| auto_renew_period |
integer |
任意 |
コントロールプレーンノードの自動更新期間。 有効な値: {1, 2, 3, 6, 12}。単位: 月。 デフォルト値: 1。 |
1 |
| charge_type |
string |
任意 |
コントロールプレーンノードの課金方法。
デフォルト値: |
PostPaid |
| cloud_monitor_flags |
boolean |
任意 |
CloudMonitor をノードにインストールするかどうかを指定します。
デフォルト値: false。 |
false |
| cpu_policy |
string |
任意 |
ノード 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 |
任意 |
キーペア名。key_pair と login_password のいずれかを設定する必要があります。 |
ack |
| login_password |
string |
任意 |
SSH ログインパスワード。パスワードの長さは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。login_password と key_pair のいずれかを設定する必要があります。 |
******** |
| node_port_range |
string |
任意 |
[非推奨] ノードサービスポート範囲。 |
30000-32767 |
| period |
integer |
任意 |
コントロールプレーンノードのサブスクリプション期間。このパラメーターは必須であり、課金方法が 有効な値: {1, 2, 3, 6, 12, 24, 36, 48, 60}。単位: 月。 デフォルト値: 1。 |
1 |
| period_unit |
string |
任意 |
コントロールプレーンノードのサブスクリプション期間の単位。このパラメーターは必須であり、課金方法が 有効な値: |
Month |
| runtime |
string |
任意 |
[非推奨] コントロールプレーンノードのランタイム名。有効な値: containerd: すべてのクラスターバージョンでサポートされている containerd コンテナランタイム。 |
コンテナ |
| security_hardening_os |
boolean |
任意 |
Alibaba Cloud Linux のセキュリティ強化を有効にするかどうかを指定します。
デフォルト値: false。 |
false |
| size |
integer |
任意 |
コントロールプレーンノードの数。 有効な値: |
3 |
| soc_enabled |
boolean |
任意 |
MLPS セキュリティ強化を有効にするかどうかを指定します。
デフォルト値: false。 |
false |
| system_disk_bursting_enabled |
boolean |
任意 |
ノードシステムクラウドディスクのバーストパフォーマンスを有効にするかどうかを指定します。
このパラメーターは、 |
true |
| system_disk_category |
string |
任意 |
ノードシステムクラウドディスクタイプ。
デフォルト値: |
cloud_ssd |
| system_disk_performance_level |
string |
任意 |
ノードシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクに対してのみ有効です。 パフォーマンスレベルはクラウドディスクのサイズによって異なります。詳細については、「ESSD クラウドディスク」を参照してください。 |
PL1 |
| system_disk_provisioned_iops |
integer |
任意 |
ノードシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。 有効な値: 0 ~ min{50,000, 1000 × capacity - ベースラインパフォーマンス}。ベースラインパフォーマンス = min{1,800 + 50 × capacity, 50,000}。 このパラメーターは、 |
1000 |
| system_disk_size |
integer |
任意 |
ノードシステムクラウドディスクのサイズ。 有効な値: [40, 500]。単位: GiB。 デフォルト値: |
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 |
任意 |
エンドポイントタイプ。 |
private |
| load_balancer_id |
string |
任意 |
NLB インスタンス ID。 |
nlb-0ogk9aaxxxxxxx |
| controlplane_log_components |
array |
任意 |
ログを収集するコントロールプレーンコンポーネントを指定するコンポーネント名のリスト。 デフォルトでは、kube-apiserver、kube-controller-manager、kube-scheduler、cloud-controller-manager からログが収集されます。 |
|
|
string |
任意 |
ログを収集するコントロールプレーンコンポーネントを指定するコンポーネント名のリスト。 デフォルトでは、kube-apiserver、kube-controller-manager、kube-scheduler、cloud-controller-manager からログが収集されます。 |
["apiserver","kcm","scheduler"] |
|
| controlplane_log_project |
string |
任意 |
コントロールプレーンコンポーネントログ用の Simple Log Service プロジェクト。ログストレージに既存のプロジェクトを使用するか、システムがプロジェクトを自動的に作成します。自動作成を選択した場合、 |
k8s-log-xxx |
| controlplane_log_ttl |
string |
任意 |
コントロールプレーンコンポーネントログの保持期間 (日数)。 |
30 |
cpu_policy
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーン構成には ノード CPU 管理ポリシー。バージョン 1.12.6 以降のクラスターでは、以下のポリシーがサポートされています。
デフォルト値: |
none |
custom_san
deprecated
|
string |
任意 |
[非推奨] 代わりに カスタム証明書の Subject Alternative Name (SAN)。複数の IP アドレスまたはドメイン名はコンマ (,) で区切ります。 |
cs.aliyun.com |
| deletion_protection |
boolean |
任意 |
クラスターの削除保護を有効にするかどうかを指定します。削除保護を有効にすると、コンソールまたは API 操作の呼び出しによる意図しないイベントによるクラスターの誤削除を防止できます。有効な値:
デフォルト値: |
true |
disable_rollback
deprecated
|
boolean |
任意 |
[非推奨] クラスターの作成に失敗した場合、デフォルトではロールバックは実行されません。失敗したクラスターを手動でクリーンアップする必要があります。 クラスターの作成に失敗した場合にクラスターをロールバックするかどうかを指定します。有効な値:
デフォルト値: |
true |
enable_rrsa
deprecated
|
boolean |
任意 |
[非推奨] 代わりに RRSA 特徴を有効にするかどうかを指定します。
|
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 |
| extra_sans |
array |
任意 |
API サーバー証明書のカスタム Subject Alternative Name (SAN)。 |
|
|
string |
任意 |
証明書の SAN。カスタム IP アドレスまたはドメイン名をサポートします。 |
192.168.xx.xx |
|
format_disk
deprecated
|
boolean |
任意 |
[非推奨] クラスターの作成時に既存のノードを選択することはサポートされていません。既存のノードをクラスターに追加するには、最初にノードプールを作成し、 AttachInstancesToNodePool 操作を呼び出してください。 既存のインスタンスを使用してクラスターを作成するときに、既存のインスタンスにデータディスクをマウントするかどうかを指定します。有効な値:
デフォルト値: データディスクのマウントルール:
|
false |
image_id
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに ノード用のカスタムイメージ。デフォルトではシステムイメージが使用されます。カスタムイメージを選択すると、デフォルトのシステムイメージが置き換えられます。詳細については、「カスタムイメージ」を参照してください。 |
m-bp16z7xko3vvv8gt**** |
image_type
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに オペレーティングシステムのディストリビューションタイプ。ノードのオペレーティングシステムを指定するには、このフィールドを使用することを推奨します。有効な値:
デフォルト値: |
AliyunLinux |
instances
deprecated
|
array |
任意 |
[非推奨] クラスターの作成時に既存のノードを選択することはサポートされていません。既存のノードをクラスターに追加するには、最初にノードプールを作成し、 AttachInstancesToNodePool 操作を呼び出してください。 既存のノードを使用してクラスターを作成するときに使用する ECS インスタンスのリスト。これらのインスタンスはワーカーノードとしてクラスターに追加されます。 説明
このフィールドは、既存のインスタンスを使用してクラスターを作成する場合に必須です。 |
|
|
string |
任意 |
既存のノードを使用してクラスターを作成するときに使用する ECS インスタンスのリスト。これらのインスタンスはワーカーノードとしてクラスターに追加されます。 説明
このフィールドは、既存のインスタンスを使用してクラスターを作成する場合に必須です。 |
i-2ze4zxnm36vq00xn**** |
|
| ip_stack |
string |
任意 |
クラスターの IP プロトコルスタック。 |
有効な値: ipv4 (シングルスタック) dual (デュアルスタック)。デフォルト値: ipv4 |
| is_enterprise_security_group |
boolean |
任意 |
アドバンストセキュリティグループの自動作成を有効にするかどうかを指定します。このパラメーターは、 説明
基本セキュリティグループを使用する場合、クラスター内のノードと Terway Pod の合計数は 2000 を超えることはできません。したがって、Terway ネットワークタイプのクラスターを作成する場合は、アドバンストセキュリティグループを使用してください。
デフォルト値: |
true |
keep_instance_name
deprecated
|
boolean |
任意 |
[非推奨] クラスターの作成時に既存のノードを選択することはサポートされていません。既存のノードをクラスターに追加するには、最初にノードプールを作成し、 AttachInstancesToNodePool 操作を呼び出してください。 既存のインスタンスを使用してクラスターを作成するときにインスタンス名を保持するかどうかを指定します。
デフォルト値: |
true |
key_pair
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに キーペアの名前。 |
security-key |
| 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 インスタンスはサポートされていません。 |
lb-wz9t256gqa3vbouk**** |
load_balancer_spec
deprecated
|
string |
任意 |
[非推奨] CLB は使用量ベースの課金を使用します。このパラメーターは効果がありません。 負荷分散の仕様。有効な値:
デフォルト値: |
slb.s2.small |
logging_type
deprecated
|
string |
任意 |
[非推奨] クラスターのログサービスを有効にします。このパラメーターはサーバーレス Kubernetes クラスターでのみ効果があり、値は |
SLS |
login_password
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに SSH ログインパスワード。 |
null |
| maintenance_window | maintenance_window |
任意 |
クラスターの O&M ウィンドウ。 |
|
master_auto_renew
deprecated
|
boolean |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードの自動更新を有効にするかどうかを指定します。このパラメーターは、
デフォルト値: |
true |
master_auto_renew_period
deprecated
|
integer |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードの自動更新のエポック。このパラメーターは、サブスクリプション課金方法が選択されている場合にのみ効果があり、必須です。 有効な値: {1, 2, 3, 6, 12}。 デフォルト値: 1。 |
1 |
master_count
deprecated
|
integer |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードの数。有効な値: デフォルト値: |
3 |
master_instance_charge_type
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードの課金方法。有効な値:
デフォルト値: |
PrePaid |
master_instance_types
deprecated
|
array |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードのインスタンスタイプ。詳細については、「インスタンスファミリー」を参照してください。 |
|
|
string |
任意 |
マスターノードのインスタンスタイプ。指定するインスタンスタイプの数は |
ecs.n4.xlarge |
|
master_period
deprecated
|
integer |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードのサブスクリプション期間。このパラメーターは、 有効な値: {1, 2, 3, 6, 12, 24, 36, 48, 60}。 デフォルト値: 1。 |
1 |
master_period_unit
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードのサブスクリプション期間の単位。このパラメーターは、課金方法が 有効な値: |
Month |
master_system_disk_category
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードのシステムクラウドディスクタイプ。有効な値:
デフォルト値: |
cloud_ssd |
master_system_disk_performance_level
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードのシステムクラウドディスクのパフォーマンスレベル (PL)。このパラメーターは、ESSD クラウドディスクに対してのみ効果があります。パフォーマンスレベルはディスクサイズに関連しています。詳細については、「ESSD クラウドディスク」を参照してください。 |
PL1 |
master_system_disk_size
deprecated
|
integer |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードのシステムクラウドディスクサイズ。有効な値: [40, 500]。単位: GiB。 デフォルト値: |
120 |
master_system_disk_snapshot_policy_id
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンの構成には、代わりに マスターノードのシステムクラウドディスクの自動スナップショットポリシーの ID。 |
sp-2zej1nogjvovnz4z**** |
master_vswitch_ids
deprecated
|
array |
任意 |
[非推奨] 代わりに マスターノード用の vSwitch ID のリスト。vSwitch の数の有効値は [1, 3] です。高可用性を確保するため、異なるゾーンに分散された 3 つの vSwitch を選択してください。 指定するインスタンスタイプの数は |
|
|
string |
任意 |
マスターノード用の vSwitch ID のリスト。vSwitch の数の有効値は [1, 3] です。高可用性を確保するため、異なるゾーンに分散された 3 つの vSwitch を選択してください。 指定するインスタンスタイプの数は |
vsw-2ze3ds0mdip0hdz8i**** |
|
| name |
string |
必須 |
カスタムクラスター名。名前には数字、漢字、英字、ハイフン (-) を含めることができます。長さは 1~63 文字で、ハイフン (-) で始めることはできません。 |
cluster-demo |
nat_gateway
deprecated
|
boolean |
任意 |
[非推奨] 代わりに |
true |
| node_cidr_mask |
string |
任意 |
ネットワーク CIDR ブロックを指定することで決定される、ノードごとの IP アドレスの数。このパラメーターは、Flannel ネットワークタイプのクラスターに対してのみ効果があります。 デフォルト値: |
25 |
node_name_mode
deprecated
|
string |
任意 |
[非推奨] ノードプールの構成には、代わりに |
null |
node_port_range
deprecated
|
string |
任意 |
ノードサービスポートのポート範囲。有効なポート範囲: [30000, 65535]。 デフォルト値: |
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 |
任意 |
クラスターの自動アップグレードチャネル。有効な値:
|
stable |
| enabled |
boolean |
任意 |
クラスターの自動アップグレードを有効にするかどうかを指定します。
|
true |
os_type
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーンノード構成には、代わりに control_plane_config の下にあるイメージタイプパラメーターを使用してください。ノードプール構成には、代わりにノードプールのスケーリンググループの下にあるイメージタイプパラメーターを使用してください。 オペレーティングシステムプラットフォームタイプ。有効な値:
デフォルト値: |
Linux |
period
deprecated
|
integer |
任意 |
[非推奨] サブスクリプション期間。このパラメーターは、充電タイプが 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 |
任意 |
[非推奨] ノードプール構成には、代わりにノードプールのスケーリンググループの下にあるプラットフォームパラメーターを使用してください。 オペレーティングシステムのディストリビューション。有効な値:
デフォルト値: |
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 マネージドクラスターの
|
Default |
| proxy_mode |
string |
任意 |
kube-proxy プロキシモード。
デフォルト値: |
ipvs |
rds_instances
deprecated
|
array |
任意 |
[非推奨] ノードプール構成には、代わりにノードプールのスケーリンググループの下にある rds_instances パラメーターを使用してください。 クラスターノードをホワイトリストに追加する ApsaraDB RDS インスタンスのリスト。コンテナ Pod CIDR ブロックとノード CIDR ブロックを RDS ホワイトリストに直接追加します。インスタンスが実行中でない場合、RDS インスタンスの構成が失敗する可能性があります。 |
|
|
string |
任意 |
クラスターノードをホワイトリストに追加する ApsaraDB 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 Service Accounts (RRSA) 機能の構成。 |
|
| enabled |
boolean |
任意 |
RRSA 機能を有効にするかどうかを指定します。
|
true |
runtime
deprecated
|
runtime |
任意 |
クラスターで使用されるコンテナランタイム。サポートされているランタイムには、containerd、サンドボックスコンテナ、Docker が含まれます。 説明
Kubernetes 1.24 では、Docker は組み込みコンテナランタイムとしてサポートされなくなりました。 詳細については、「Docker、containerd、サンドボックスコンテナランタイムの比較」を参照してください。 |
|
| security_group_id |
string |
任意 |
既存のセキュリティグループの ID。このパラメーターは |
sg-bp1bdue0qc1g7k**** |
security_hardening_os
deprecated
|
boolean |
任意 |
[非推奨] クラスターのコントロールプレーン構成には、代わりに control_plane_config の下にある security_hardening_os パラメーターを使用してください。ノードプール構成には、代わりにノードプールのスケーリンググループの下にある security_hardening_os パラメーターを使用してください。 Alibaba Cloud OS のセキュリティ強化を有効にするかどうかを指定します。有効な値:
デフォルト値: |
false |
| service_account_issuer |
string |
任意 |
ServiceAccount は、Pod とクラスター API サーバー間の通信に使用されるアクセス認証情報です。
|
kubernetes.default.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 |
任意 |
[非推奨] クラスター内のサービス検出タイプ。
デフォルト値: 有効化されていません。 |
|
|
string |
任意 |
クラスター内のサービス検出タイプ。
デフォルト値: 有効化されていません。 |
PrivateZone |
|
| snat_entry |
boolean |
任意 |
VPC の SNAT を構成するための設定項目。有効な値:
説明
クラスター作成時にこれが有効になっておらず、後でインターネットアクセスが必要になった場合は、手動で有効にする ことができます。 デフォルト値: |
false |
soc_enabled
deprecated
|
boolean |
任意 |
[非推奨] クラスターのコントロールプレーンノード構成には、代わりに control_plane_config の下にある soc_enabled パラメーターを使用してください。ノードプール構成には、代わりにノードプールのスケーリンググループの下にある soc_enabled パラメーターを使用してください。 MLPS 2.0 セキュリティ強化を有効にするかどうかを指定します。詳細については、「ACK の中国等級保護コンプライアンス」を参照してください。 有効な値:
デフォルト値: |
false |
| ssh_flags |
boolean |
任意 |
パブリック SSH ログインを有効にするかどうかを指定します。これは、ACK 専用クラスターのマスターノードにログインするために使用されます。このパラメーターは、マネージドクラスターには効果がありません。
デフォルト値: |
true |
| tags |
array |
任意 |
ノードタグ。タグ定義ルール:
|
|
| tag |
任意 |
ノードタグ。タグ定義ルール:
|
||
taints
deprecated
|
array |
任意 |
[非推奨] ノードプール構成には、代わりにノードプールの kubernetes_config の下にある taints パラメーターを使用してください。 ノード Taint 情報。Taint と Toleration は連携して、Pod が不適切なノードにスケジューリングされるのを防ぎます。詳細については、「テイントとトレレーション (エビクション)」を参照してください。 |
|
| taint |
任意 |
ノード Taint 情報。Taint と Toleration は連携して、Pod が不適切なノードにスケジューリングされるのを防ぎます。詳細については、「テイントとトレレーション (エビクション)」を参照してください。 |
||
timeout_mins
deprecated
|
integer |
任意 |
[非推奨] デフォルトでは、クラスターの作成が失敗してもシステムはロールバックしません。失敗したクラスターを手動でクリーンアップする必要があります。 クラスター作成のタイムアウト期間 (分単位)。 デフォルト値: |
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。このパラメーターは、ゼロノードマネージドクラスターを作成する際に必須です。 |
|
|
string |
任意 |
クラスターノード用の vSwitch。このパラメーターは、ゼロノードマネージドクラスターを作成する際に必須です。 |
vsw-2ze3ds0mdip0hdz8i**** |
|
worker_auto_renew
deprecated
|
boolean |
任意 |
[非推奨] ノードプール構成には、代わりにノードプールのスケーリンググループ配下の auto_renew パラメーターを使用してください。 作業ノードの自動更新を有効にするかどうかを指定します。このパラメーターは、インスタンス充電タイプ (
デフォルト値: |
true |
worker_auto_renew_period
deprecated
|
integer |
任意 |
[非推奨] ノードプール構成には、代わりにノードプールのスケーリンググループ配下の 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 |
| performance_level |
string |
任意 |
ノードのデータクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスク に対してのみ有効です。 |
PL1 |
| size |
string |
必須 |
データクラウドディスクのサイズ。有効な値: 40 ~ 32767。単位: GiB。 |
120 |
worker_instance_charge_type
deprecated
|
string |
任意 |
[非推奨] 代わりにノードプールのスケーリンググループの instance_charge_type パラメーターを使用してください。 作業インスタンスの充電タイプ。有効な値:
デフォルト値: 従量充電。 |
PrePaid |
worker_instance_types
deprecated
|
array |
任意 |
[非推奨] 代わりにノードプールのスケーリンググループの instance_types パラメーターを使用してください。 作業ノードのインスタンス構成。 |
|
|
string |
任意 |
ワーカーノードのインスタンスタイプ。少なくとも 1 つのインスタンスタイプを指定します。詳細については、「インスタンスファミリー」を参照してください。 説明
インスタンスタイプの優先度は、配列内の位置が後ろになるほど低くなります。優先度の高いインスタンスタイプに基づいてインスタンスを作成できない場合、システムは自動的に次の優先度のインスタンスタイプを使用します。 |
ecs.n4.large |
|
worker_period
deprecated
|
integer |
任意 |
[非推奨] 代わりにノードプールのスケーリンググループの period パラメーターを使用してください。 作業ノードのサブスクリプション期間。このパラメーターは、インスタンス充電タイプ ( 有効な値: {1, 2, 3, 6, 12, 24, 36, 48, 60}。 デフォルト値: 1。 |
1 |
worker_period_unit
deprecated
|
string |
任意 |
[非推奨] 代わりにノードプールのスケーリンググループの period_unit パラメーターを使用してください。 作業ノードの充電期間。このパラメーターは、充電方法が 有効な値: |
Month |
worker_system_disk_category
deprecated
|
string |
任意 |
[非推奨] 代わりにノードプールのスケーリンググループの system_disk_category パラメーターを使用してください。 作業ノードのシステムクラウドディスクタイプ。詳細については、「ブロックストレージの概要」を参照してください。 有効な値:
デフォルト値: |
cloud_efficiency |
worker_system_disk_performance_level
deprecated
|
string |
任意 |
[非推奨] 代わりにノードプールのスケーリンググループの system_disk_performance_level パラメーターを使用してください。 システムクラウドディスクが ESSD の場合、ESSD のパフォーマンスレベル (PL) を設定できます。詳細については、「ESSD クラウドディスク」を参照してください。 有効な値:
|
PL1 |
worker_system_disk_size
deprecated
|
integer |
任意 |
[非推奨] 代わりにノードプールのスケーリンググループの system_disk_size パラメーターを使用してください。 作業ノードのシステムクラウドディスクサイズ。単位: GiB。 有効な値: [40,500]。 このパラメーターの値は、max{40, ImageSize} 以上である必要があります。 デフォルト値: |
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 のマネージドクラスターを作成する場合、 |
|
|
string |
任意 |
作業ノードの vSwitch のリスト。有効な値: [1,20]。高可用性を確保するため、異なるゾーンの vSwitch を選択してください。 ノード数が 0 のマネージドクラスターを作成する場合、 |
vsw-2ze3ds0mdip0hdz8i**** |
|
zone_id
deprecated
|
string |
任意 |
[非推奨] 代わりに クラスターが属するリージョンの利用可能なゾーン ID。このパラメーターは ACK マネージドクラスターに固有です。 ACK マネージドクラスターを作成する際、 |
cn-beiji**** |
| zone_ids |
array |
任意 |
クラスターが属するリージョン内の複数のゾーンの ID。このパラメーターは ACK マネージドクラスターに固有です。 |
|
|
string |
任意 |
クラスターが属するリージョンの利用可能なゾーン ID。このゾーンでは vSwitch が自動作成の対象となります。 ACK マネージドクラスターを作成する際、 |
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****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。