Container Service for Kubernetes (ACK) サーバーレスクラスターを作成します。
リクエスト構文
POST /clusters HTTP/1.1
Content-Type: application/json
{
"cluster_type": "String",
"profile": "String",
"cluster_spec": "String",
"name": "String",
"kubernetes_version": "String",
"private_zone": Boolean,
"region_id": "String",
"endpoint_public_access": Boolean,
"service_discovery_types": ["String"],
"zoneid": "String",
"logging_type": "String",
"tags": [
{
"key": "String",
"value": "String"
}
],
"deletion_protection": Boolean,
"service_cidr": "String",
"timezone": "String",
"addons": [
{
"name": "String",
"config": "String",
"disabled": Boolean
}
],
"snat_entry": Boolean,
"vpcid": "String",
"vswitch_ids": ["String"],
"security_group_id": "String"
}
リクエストパラメーター
| パラメーター | タイプ | 必須 | 例 | 説明 |
|---|---|---|---|---|
cluster_type |
String | はい | ManagedKubernetes |
クラスタータイプです。ManagedKubernetes を指定してください。profile: Serverless と組み合わせることで、ACK サーバーレスクラスターが作成されます。 |
profile |
String | はい | Serverless |
クラスター識別子です。Serverless を指定してください。cluster_type: ManagedKubernetes と組み合わせることで、ACK サーバーレスクラスターが作成されます。 |
cluster_spec |
String | いいえ | ack.pro.small |
ACK サーバーレスクラスターのエディションです。有効値:ack.pro.small(プロフェッショナル ACK サーバーレスクラスター)、ack.standard(スタンダード ACK サーバーレスクラスター)。デフォルト値:ack.standard。詳細については、「クラスター概要」をご参照ください。 |
name |
String | はい | cluster-demo |
クラスター名です。1~63 文字で、数字、英字、ハイフン (-) を使用できます。ハイフンで始めることはできません。 |
kubernetes_version |
String | いいえ | 1.32.1-aliyun.1 |
ACK がサポートする Kubernetes バージョンの概要Kubernetes バージョンです。指定しない場合、最新の安定版が使用されます。以前のバージョンでクラスターを作成する場合は、このパラメーターを使用してください。サポートされているバージョンについては、「」をご参照ください。 |
private_zone |
ブール値 | いいえ | false |
サービス検出に Alibaba Cloud DNS PrivateZone を有効にするかどうかを指定します。有効値:true(有効)、false(無効)。詳細については、「Alibaba Cloud DNS PrivateZone に基づくサービス検出の有効化」をご参照ください。 |
region_id |
String | はい | cn-beijing |
クラスターを配置するリージョンです。 |
endpoint_public_access |
ブール値 | いいえ | true |
API サーバーをインターネット上に公開するかどうかを指定します。有効値:true(インターネット上で公開)、false(VPC 内からのみアクセス可能)。デフォルト値:true。 |
service_discovery_types |
String の配列 | いいえ | PrivateZone |
クラスターのサービス検出方法です。有効値:CoreDNS(Kubernetes ネイティブ DNS。CPU コア 0.25、メモリ 512 MiB の弾性コンテナインスタンス (ECI) を 2 つデプロイ)、PrivateZone(Alibaba Cloud DNS PrivateZone。使用前に有効化が必要)。デフォルト値:未設定。 |
zoneid |
String | いいえ | cn-beiji**** |
ゾーン ID です。 重要
|
logging_type |
String | いいえ | SLS |
Simple Log Service (SLS) を有効にするかどうかを指定します。SLS を指定して有効にしてください。ACK サーバーレスクラスターでのみ適用されます。 |
tags |
タグの配列 | いいえ | [{"key": "env", "value": "prod"}] |
クラスターにアタッチするタグです。各タグには key および value が含まれます。 |
deletion_protection |
ブール値 | いいえ | true |
削除保護を有効にするかどうかを指定します。有効にすると、ACK コンソールまたは API からクラスターを削除できなくなります。有効値:true(有効)、false(無効)。デフォルト値:false。 |
service_cidr |
String | いいえ | 172.21.0.0/20 |
Service CIDR ブロックです。有効範囲:10.0.0.0/16~24、172.16~31.0.0/16~24、192.168.0.0/16~24。VPC CIDR ブロックまたは VPC 内の既存クラスター CIDR ブロックと重複してはいけません。クラスター作成後は変更できません。デフォルト値:172.19.0.0/20。 |
timezone |
String | いいえ | Asia/Shanghai |
クラスターのタイムゾーンです。サポートされている値については、「サポートされているタイムゾーン」をご参照ください。 |
addons |
アドオンの配列 | いいえ | [{"name":"logtail-ds","config":"{\"sls_project_name\":\"your_sls_project_name\"}"}] |
インストールするアドオンです。各アドオンエントリは次の 3 つのフィールドをサポートしています:name(必須)、config(オプション。構成が不要な場合は空のままにしてください)、disabled(オプション。true を指定すると自動インストールをスキップします)。詳細については、「アドオン構成」をご参照ください。 |
snat_entry |
ブール値 | いいえ | true |
NAT ゲートウェイを作成し、ソースネットワークアドレス変換 (SNAT) ルールを構成するかどうかを指定します。有効値:true(NAT ゲートウェイおよび SNAT ルールを作成し、VPC からのインターネットアクセスを有効化)、false(NAT ゲートウェイおよび SNAT ルールを作成しません)。デフォルト値:false。 |
vpcid |
String | いいえ | vpc-2zeik9h3ahvv2zz95**** |
クラスターをデプロイする VPC の ID です。指定する場合は、vswitch_ids も指定する必要があります。 |
vswitch_ids |
String の配列 | いいえ | ["vsw-2ze97jwri7cei0mpw****"] |
vSwitch ID です。1~3 個の vSwitch を指定してください。 |
security_group_id |
String | いいえ | sg-bp1bdue0qc1g7k**** |
使用するセキュリティグループの ID です。ノードは自動的にこのグループに追加されます。このパラメーターまたは is_enterprise_security_group のいずれかを指定する必要があります。 |
resource_group_id |
String | いいえ | rg-acfm3mkrure**** |
リソースグループ ID です。異なるリソースグループ間でクラスターを分離するために使用します。 |
アドオン構成
Log Service アドオン (logtail-ds): オプションです。Simple Log Service を有効にしないと、クラスター監査機能は利用できません。
-
既存の SLS プロジェクトを使用する場合:
[{"name": "logtail-ds", "config": "{\"IngressDashboardEnabled\":\"true\",\"sls_project_name\":\"your_sls_project_name\"}"}] -
新しい SLS プロジェクトを作成する場合:
[{"name": "logtail-ds", "config": "{\"IngressDashboardEnabled\":\"true\"}"}]
Ingress コントローラー (nginx-ingress-controller): オプションです。ACK 専用クラスターではデフォルトでインストールされます。
-
インターネットアクセスを有効にしてインストールする場合:
[{"name": "nginx-ingress-controller", "config": "{\"IngressSlbNetworkType\":\"internet\"}"}] -
インストールをスキップする場合:
[{"name": "nginx-ingress-controller", "config": "", "disabled": true}]
レスポンス要素
HTTP/1.1 200
Content-Type: application/json
{
"cluster_id": "String",
"request_id": "String",
"task_id": "String"
}
| パラメーター | タイプ | 例 | 説明 |
|---|---|---|---|
cluster_id |
String | cb95aa626a47740afbf6aa099b650**** |
クラスター ID です。 |
request_id |
String | 687C5BAA-D103-4993-884B-C35E4314A1E1 |
リクエスト ID です。 |
task_id |
String | T-5a54309c80282e39ea00002f |
タスク ID です。 |
使用例
例 1:自動作成された VPC を使用してクラスターを作成する
この例では、中国 (杭州) にスタンダード ACK サーバーレスクラスターを作成します。VPC および NAT ゲートウェイは自動的に作成され、Simple Log Service が有効になります。
リクエスト:
POST /clusters HTTP/1.1
<Common request headers>
{
"cluster_type": "ManagedKubernetes",
"profile": "Serverless",
"cluster_spec": "ack.standard",
"name": "test-ask",
"region_id": "cn-hangzhou",
"endpoint_public_access": false,
"logging_type": "SLS",
"private_zone": false,
"snat_entry": true,
"tags": [
{
"key": "k-aa",
"value": "v-aa"
}
],
"deletion_protection": false,
"addons": [
{
"name": "logtail-ds"
}
],
"zoneid": "cn-hangzhou-i"
}
レスポンス:
{
"cluster_id": "cb95aa626a47740afbf6aa099b650****",
"RequestId": "687C5BAA-D103-4993-884B-C35E4314A1E1",
"task_id": "T-5a54309c80282e39ea00002f"
}
例 2:既存の VPC にクラスターを作成する
この例では、中国 (深セン) の既存 VPC にプロフェッショナル ACK サーバーレスクラスターを作成します。API サーバーはインターネットからアクセス可能で、削除保護が有効になり、サービス検出に Alibaba Cloud DNS PrivateZone が使用されます。
リクエスト:
POST /clusters HTTP/1.1
<Common request headers>
{
"cluster_type": "ManagedKubernetes",
"profile": "Serverless",
"cluster_spec": "ack.pro.small",
"name": "ask-cluster",
"region_id": "cn-shenzhen",
"endpoint_public_access": true,
"logging_type": "SLS",
"private_zone": true,
"tags": [
{
"key": "tier",
"value": "frontend"
}
],
"deletion_protection": true,
"addons": [
{
"name": "logtail-ds"
}
],
"vpcid": "vpc-wz984yvbd6lck22z3****",
"vswitch_ids": [
"vsw-wz9uwxhawmtzg7u9h****"
],
"security_group_id": "sg-wz9b86l4s7nthi1k****"
}
レスポンス:
{
"cluster_id": "cb95aa626a47740afbf6aa099b650****",
"RequestId": "687C5BAA-D103-4993-884B-C35E4314A1E1",
"task_id": "T-5a54309c80282e39ea00002f"
}
エラーコード
エラーコードの詳細については、「Error Center」をご参照ください。