ACK クラスターを作成します。対象には、ACK マネージドクラスター、サーバーレス Kubernetes クラスター、ACK Edge クラスター、および登録済みクラスターが含まれます。クラスター作成時に、クラスター情報、クラスターコンポーネント、および ACK 関連のクラウドリソースを構成します。
操作説明
コンソールを使用した OpenAPI リクエストパラメーターの生成
CreateCluster 操作を呼び出してクラスターを作成する際、リクエストパラメーターの組み合わせが正しくないために API 呼び出しが失敗した場合、コンソールを使用して必須のリクエストパラメーターの組み合わせを生成できます。次の手順を実行します。
-
コンテナサービス for Kubernetes (ACK) コンソール にログインし、左側のナビゲーションウィンドウで [クラスター] を選択します。
-
[クラスター] ページで、[クラスターテンプレート] をクリックします。
-
ダイアログボックスで、作成するクラスタータイプを選択し、[作成] をクリックして、クラスター構成ページでクラスター情報を構成します。
-
構成が完了したら、[構成の確認] ページの右上隅にある [同等のコード] をクリックします。ダイアログボックスに、クラスターの作成に必要なパラメーターの組み合わせが表示されます。これをコピーして使用できます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cs:CreateCluster |
create |
*Cluster
|
|
なし |
リクエスト構文
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 |
任意 |
クラスターコンポーネントのリスト。クラスターの作成時に、 ネットワークコンポーネント: 必須。Flannel と Terway の 2 種類のネットワークタイプが利用可能です。クラスターの作成時にいずれかを選択します。
ストレージコンポーネント: 任意。
ログコンポーネント: 任意。このコンポーネントを有効にすることを推奨します。ログサービスを有効にしない場合、クラスター監査の特徴を使用できません。
Ingress コンポーネント: 任意。デフォルトでは、ACK 専用クラスターには 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.default.svc |
| audit_log_config |
object |
任意 |
クラスター監査ログの構成。 |
|
| enabled |
boolean |
任意 |
クラスター監査ログの特徴を有効にするかどうかを指定します。
|
true |
| sls_project_name |
string |
任意 |
クラスター監査ログ用の Logstore を含む SLS プロジェクト。
|
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 文字で、小文字、数字、およびハイフン (-) を含めることができます。各部分は、小文字または数字で始まり、小文字または数字で終わる必要があります。 |
cluster.local |
| cluster_spec |
string |
任意 |
Pro XL、Pro 2XL、および Pro 4XL は、コンテナサービス ACK Pro プロビジョニング済みコントロールプレーンによって提供される 3 つのティアです。コントロールプレーンリソースを事前割り当ておよび専有することで、これらのティアは API の同時実行数と Pod のスケジューリング機能が一貫して高いレベルに維持されることを保証します。AI トレーニングおよび推論、超大規模クラスター、および重要な作業に適しています。 Pro エディションおよびプロビジョニング済みコントロールプレーンエディションのクラスター管理料金の詳細については、クラスター管理料金を参照してください。 |
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。VPC または VPC 内の既存の Kubernetes クラスターで使用されている 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 |
任意 |
キーペア名。このパラメーターまたは login_password のいずれかを指定する必要があります。 |
ack |
| login_password |
string |
任意 |
SSH ログインパスワード。パスワードの長さは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。このパラメーターまたは 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 コンテナランタイム。 |
containerd |
| security_hardening_os |
boolean |
任意 |
Alibaba Cloud OS のセキュリティ強化を有効にするかどうかを指定します。
デフォルト値: false。 |
false |
| size |
integer |
任意 |
コントロールプレーンノードの数。 有効な値: 3 または 5。 |
3 |
| soc_enabled |
boolean |
任意 |
MLPS セキュリティ強化を有効にするかどうかを指定します。
デフォルト値: false。 |
false |
| system_disk_bursting_enabled |
boolean |
任意 |
ノードシステムクラウドディスクのバーストパフォーマンスを有効にするかどうかを指定します。
このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみサポートされます。 |
true |
| system_disk_category |
string |
任意 |
ノードシステムクラウドディスクのディスクタイプ。
デフォルト値: 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 以降を実行中のクラスターでは、以下のポリシーがサポートされています。
デフォルト値: none。 |
none |
custom_san
deprecated
|
string |
任意 |
[非推奨] 代わりに extra_sans パラメーターを使用してください。 カスタム証明書のネイティブな Subject Alternative Name (SAN)。複数の IP アドレスまたはドメイン名はコンマ (,) で区切ります。 |
cs.aliyun.com |
| deletion_protection |
boolean |
任意 |
クラスターの削除保護を有効にするかどうかを指定します。削除保護を有効にすると、コンソールまたは API 操作の呼び出しによるクラスターの意図しない削除を防ぎます。有効な値:
デフォルト値: false。 |
true |
disable_rollback
deprecated
|
boolean |
任意 |
[非推奨] クラスターの作成に失敗した場合、デフォルトではロールバックは実行されません。失敗したクラスターを手動でクリーンアップする必要があります。 クラスターの作成に失敗した場合にクラスターをロールバックするかどうかを指定します。有効な値:
デフォルト値: true。 |
true |
enable_rrsa
deprecated
|
boolean |
任意 |
[非推奨] 代わりに rrsa_config パラメーターを使用してください。 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 サーバーを公開し、クラスターへのパブリックネットワークアクセスを可能にします。
デフォルト値: false。 |
true |
| extra_sans |
array |
任意 |
API サーバー証明書のネイティブなカスタム Subject Alternative Name (SAN)。 |
|
|
string |
任意 |
証明書の SAN。カスタム IP アドレスまたはドメイン名をサポートします。 |
192.168.xx.xx |
|
format_disk
deprecated
|
boolean |
任意 |
[非推奨] クラスター作成時の既存ノードの選択はサポートされていません。既存のノードをクラスターに追加するには、最初にノードプールを作成し、 AttachInstancesToNodePool 操作を呼び出してください。 既存のインスタンスを使用してクラスターを作成する際に、既存のインスタンスにデータディスクをマウントするかどうかを指定します。有効な値:
デフォルト値: false。 データディスクのマウントルール:
|
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 |
instances
deprecated
|
array |
任意 |
[非推奨] クラスター作成時の既存ノードの選択はサポートされていません。既存のノードをクラスターに追加するには、最初にノードプールを作成し、 AttachInstancesToNodePool 操作を呼び出してください。 既存のノードを使用してクラスターを作成する際に使用する ECS インスタンスのリスト。これらのインスタンスはワーカーノードとしてクラスターに追加されます。 説明
このフィールドは、既存のインスタンスを使用してクラスターを作成する場合に必須です。 |
|
|
string |
任意 |
既存のノードを使用してクラスターを作成する際に使用する ECS インスタンスのリスト。これらのインスタンスはワーカーノードとしてクラスターに追加されます。 説明
このフィールドは、既存のインスタンスを使用してクラスターを作成する場合に必須です。 |
i-2ze4zxnm36vq00xn**** |
|
| ip_stack |
string |
任意 |
クラスターの IP プロトコルスタック。 |
有効な値: ipv4 (シングルスタック) dual (デュアルスタック)。デフォルト値: ipv4 |
| is_enterprise_security_group |
boolean |
任意 |
高度なセキュリティグループの自動作成を有効にするかどうかを指定します。このパラメーターは、 説明
基本セキュリティグループを使用する場合、クラスター内のノードと Terway Pod の合計数は 2,000 を超えることはできません。したがって、Terway ネットワークタイプのクラスターを作成する際は、高度なセキュリティグループを使用してください。
デフォルト値: |
true |
keep_instance_name
deprecated
|
boolean |
任意 |
[非推奨] クラスター作成時の既存ノードの選択はサポートされていません。既存のノードをクラスターに追加するには、最初にノードプールを作成し、 AttachInstancesToNodePool 操作を呼び出してください。 既存のインスタンスを使用してクラスターを作成する際にインスタンス名を保持するかどうかを指定します。
デフォルト値: |
true |
key_pair
deprecated
|
string |
任意 |
[非推奨] クラスターのコントロールプレーン構成には、代わりに キーペアの名前。 |
セキュリティキー |
| 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.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 |
任意 |
[非推奨] クラスターのコントロールプレーン構成には、代わりに マスターノードのシステムクラウドディスクのパフォーマンスレベル。このパラメーターは 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 文字で、ハイフン (-) で始めることはできません。 |
クラスターデモ |
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 配下の image_type パラメーターを使用してください。ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の image_type パラメーターを使用してください。 オペレーティングシステムイメージのプラットフォームタイプ。有効な値:
デフォルト値: 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。 |
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 |
| proxy_mode |
string |
任意 |
kube-proxy プロキシモード。
デフォルト値: 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 |
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 のセキュリティ強化を有効にするかどうかを指定します。有効な値:
デフォルト値: 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 クラスターでのサービス検出メソッドを指定します。
デフォルト値: 有効化されていません。 |
|
|
string |
任意 |
クラスター内のサービス検出タイプ。このパラメーターは、サーバーレス Kubernetes クラスターでのサービス検出メソッドを指定します。
デフォルト値: 有効化されていません。 |
PrivateZone |
|
| snat_entry |
boolean |
任意 |
VPC の SNAT を構成するための設定項目。有効な値:
説明
クラスター作成時にこのオプションを有効にせず、後でインターネットアクセスが必要になった場合は、手動で有効にすることができます。 デフォルト値: false。 |
false |
soc_enabled
deprecated
|
boolean |
任意 |
[非推奨] クラスターのコントロールプレーンノード構成には、代わりに control_plane_config 配下の soc_enabled パラメーターを使用してください。ノードプール構成には、代わりにノードプールの scaling_group (グループ) 配下の soc_enabled パラメーターを使用してください。 MLPS 2.0 セキュリティ強化を有効にするかどうかを指定します。詳細については、「ACK の中国等級保護コンプライアンス」を参照してください。 有効な値:
デフォルト値: false。 |
false |
| ssh_flags |
boolean |
任意 |
パブリック SSH ログインを有効にするかどうかを指定します。これは、ACK 専用クラスターのマスターノードにログインするために使用されます。このパラメーターはマネージドクラスターには効果がありません。
デフォルト値: false。 |
true |
| tags |
array |
任意 |
ノードタグ。タグ解像度ルール:
|
|
| tag |
任意 |
ノードタグ。タグ解像度ルール:
|
||
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 パラメーターを使用してください。 作業ノードの自動更新を有効にするかどうかを指定します。このパラメーターは、
デフォルト値: |
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 |
| 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 の場合のシステムクラウドディスクのパフォーマンスレベル (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 マネージドクラスターに固有です。
|
cn-beiji**** |
| zone_ids |
array |
任意 |
クラスターが属するリージョン内の複数のゾーンの ID。このパラメーターは ACK マネージドクラスターに固有です。 |
|
|
string |
任意 |
クラスターが属するリージョンのアクティブなゾーン ID。このゾーンでは、vSwitch の自動作成が主題となります。
|
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****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。