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

Container Service for Kubernetes:CreateCluster を呼び出して ACK サーバーレスクラスターを作成する

最終更新日:Mar 27, 2026

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 です。
重要

vpcid および vswitch_ids のいずれも指定されていない場合は必須です。

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」をご参照ください。