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

Container Service for Kubernetes:OpenAPI を使用した ACK エッジクラスターの作成

最終更新日:Jun 24, 2026

`profile=Edge` を指定して `CreateCluster` を呼び出し、ネットワーク、ランタイム、ワーカーノードを設定します。

デバッグ

この操作を OpenAPI Explorer で呼び出して、署名を自動計算し、SDK コードを動的に生成します。

リクエスト構文

POST /clusters HTTP/1.1
Content-Type:application/json
{
  "name" : "String",
  "cluster_type" : "String",
  "disable_rollback" : Boolean,
  "timeout_mins" : Long,
  "kubernetes_version" : "String",
  "runtime" : {
    "name" : "String",
    "version" : "String"
  },
  "region_id" : "String",
  "key_pair" : "String",
  "login_password" : "String",
  "num_of_nodes" : Long,
  "profile" : "String",
  "logging_type" : "String",
  "snat_entry" : Boolean,
  "vswitch_ids" : [ "String" ],
  "worker_system_disk_category" : "String",
  "worker_system_disk_size" : Long,
  "container_cidr" : "String",
  "cloud_monitor_flags" : Boolean,
  "endpoint_public_access" : Boolean,
  "service_cidr" : "String",
  "addons" : [ {
    "name" : "String",
    "config" : "String",
    "disabled" : Boolean
  } ],
  "tags" : [ {
    "key" : "String",
    "value" : "String"
  } ],
  "vpcid" : "String",
  "worker_data_disks" : [ {
    "category" : "String",
    "size" : Long,
    "encrypted" : "String",
    "auto_snapshot_policy_id" : "String"
  } ],
  "deletion_protection" : Boolean,
  "node_cidr_mask" : "String",
  "worker_instance_types" : [ "String" ],
  "worker_instance_charge_type" : "String",
  "security_group_id" : "String",
  "is_enterprise_security_group" : Boolean,
  "rds_instances" : [ "String" ]
}

リクエストパラメーター

表 1. リクエストボディパラメーター

パラメーター 必須 説明
name String はい demo-edge-cluster クラスター名。1~63 文字で、数字、英字、漢字、ハイフン (-) を使用できます。ハイフンで始めることはできません。
cluster_type String はい ManagedKubernetes クラスタータイプ。ACK Edge クラスターの場合は、ManagedKubernetes に設定します。
disable_rollback Boolean いいえ true 非推奨。クラスター作成の失敗時にロールバックするかどうかを指定します。有効値:true (ロールバックする)、false (ロールバックしない)。デフォルト値:false
timeout_mins Long いいえ 60 非推奨。リソース作成のタイムアウト期間。単位:分。デフォルト値:60。
kubernetes_version String いいえ 1.30.1-aliyun.1 Kubernetes バージョンのサポートKubernetes バージョン。デフォルトでは最新バージョンが使用されます。ACK はオープンソースの Kubernetes と同じバージョンをサポートします。コンソールでは最新の 3 つのバージョンが提供されます。それより前のバージョンを使用する場合は、API オペレーションを利用してください。詳細は、をご参照ください。
runtime Array of runtime いいえ {"name": "containerd", "version": "1.6.20"} コンテナランタイム。サポートされているランタイム:containerd および docker。フィールド:name (ランタイム名) および version (ランタイムバージョン)。
region_id String はい cn-beijing クラスターのリージョン ID。
key_pair String はい demo-key 非推奨。キーペアの名前。このパラメーターまたは login_password を設定します。
login_password String はい HelloWorld123 非推奨。SSH ログインパスワード。このパラメーターまたは key_pair を設定します。8~30 文字で、大文字、小文字、数字、特殊文字のうち、少なくとも 3 種類を含める必要があります。
num_of_nodes Long はい 1 非推奨。ワーカーノードの数。有効値:0~100。
profile String はい Edge クラスターが ACK Edge クラスターであることを示します。デフォルト値:Edge
logging_type String いいえ SLS Simple Log Service (SLS) を有効にするかどうかを指定します。SLS に設定すると有効になります。ACK Serverless クラスターでのみ有効です。
snat_entry Boolean いいえ true Virtual Private Cloud (VPC) の SNAT ルールを設定するかどうかを指定します。有効値:true (インターネットアクセス用に SNAT を設定)、false (SNAT なし)。VPC がすでにインターネットにアクセスできる場合は false に設定し、クラスターアプリケーションがインターネットにアクセスする必要がある場合は true に設定します。デフォルト値:false
vswitch_ids Array of String はい vsw-2ze48rkq464rsdts1\*\*\*\* vSwitch の ID。1~3 つの vSwitch を指定します。
worker_system_disk_category String はい cloud_efficiency 非推奨。ワーカーノードのシステムディスクタイプ。有効値:cloud_efficiency (Ultra ディスク)、cloud_ssd (標準 SSD)。デフォルト値:cloud_ssd
worker_system_disk_size Long はい 100 非推奨。ワーカーノードのシステムディスクサイズ。単位:GiB。有効値:40~500 (max{40, ImageSize} 以上の値である必要があります)。デフォルト値:120
container_cidr String いいえ 172.20.0.0 Pod の CIDR ブロック。VPC の CIDR ブロックと重複することはできません。デフォルト:VPC が自動作成される場合は 172.16.0.0/16。
重要

このパラメーターは、クラスターがネットワークプラグインとして Flannel を使用する場合は必須ですが、Terway を使用する場合はオプションです。

cloud_monitor_flags Boolean いいえ true 非推奨。CloudMonitor エージェントをインストールするかどうかを指定します。有効値:true (インストールする)、false (スキップする)。デフォルト値:false
endpoint_public_access Boolean いいえ true API サーバーのインターネットアクセスを有効にするかどうかを指定します。有効値: true (有効) および false (無効。API サーバーは内部ネットワーク内でのみアクセス可能)。デフォルト値: true
重要

ACK Edge クラスターでは、エッジノードはインターネット経由でコントロールプレーンと通信します。ACK Edge クラスターを作成する際は、API サーバーのインターネットアクセスを有効にしてください。

service_cidr String はい 172.21.0.0 Service の CIDR ブロック。Pod または VPC の CIDR ブロックと重複することはできません。デフォルト:VPC が自動作成される場合は 172.19.0.0/20。
addons Array of addon いいえ \[{"name":"flannel","config":""},{"name":"logtail-ds-docker","config":""},{"name":"alibaba-log-controller","config":"{\"IngressDashboardEnabled\":\"false\"}"}\] クラスターアドオン。フィールド:name (必須)、config (オプション、使用しない場合は空のまま)、disabled (オプション、自動インストールを無効化)。ネットワークプラグイン (必須):Flannel または Terway。Flannel:[{"name":"flannel","config":""}]。Terway:[{"name":"terway-eniip","config":""}]ボリュームプラグイン (オプション):Container Storage Interface (CSI):[{"name":"csi-plugin","config":""},{"name":"csi-provisioner","config":""}] Log Service アドオン (オプション):SLS を無効にすると、クラスター監査も無効になります。既存のプロジェクト:[{"name":"logtail-ds","config":"{\"IngressDashboardEnabled\":\"true\",\"sls_project_name\":\"your_sls_project_name\"}"}]。新規プロジェクト:[{"name":"logtail-ds","config":"{\"IngressDashboardEnabled\":\"true\"}"}]Ingress コントローラー (オプション):ACK 専用クラスターではデフォルトでインストールされます。インターネットアクセスあり:[{"name":"nginx-ingress-controller","config":"{\"IngressSlbNetworkType\":\"internet\"}"}]。スキップ:[{"name":"nginx-ingress-controller","config":"","disabled":true}]イベントセンター (オプション):デフォルトで有効です。構成:[{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\"your_sls_project_name\"}"}]。詳細は、イベントセンターの作成と使用をご参照ください。
tags Array of tag いいえ \[{"key":"env","value":"prod"}\] クラスターに追加するラベル。key:ラベルキー。value:ラベル値。
vpcid String はい vpc-2zeik9h3ahvv2zz95\*\*\*\* VPC ID。クラスター作成に必須です。
説明

vpc_idvswitch_ids の両方を空にするか、vswitch_ids で指定した vSwitch が vpc_id で指定した VPC に属していることを確認してください。

worker_data_disks Array of data_disk いいえ 非推奨。ワーカーノードのデータディスク構成。ディスクタイプとサイズを含みます。
deletion_protection Boolean いいえ true 削除保護を有効にするかどうかを指定します。有効にすると、コンソールまたは API オペレーションによるクラスターの削除ができなくなります。有効値:true (有効)、false (無効)。デフォルト値:false
node_cidr_mask String いいえ 25 ノードの CIDR マスクサイズ。ノードあたりの Pod の IP アドレスの最大数を決定します。Flannel プラグインでのみ有効です。デフォルト値:25
worker_instance_types Array of String はい ecs.n4.large 非推奨。ワーカーノードの ECS インスタンスタイプ。少なくとも 1 つのタイプを優先度の高い順に指定します。利用できない場合は、システムは次のタイプにフォールバックします。詳細は、インスタンスファミリーの概要をご参照ください。
worker_instance_charge_type String はい PrePaid 非推奨。ワーカーノードの課金方法。有効値:PrePaid (サブスクリプション)、PostPaid (従量課金)。デフォルト値:PostPaid
security_group_id String いいえ sg-bp1bdue0qc1g7k\*\*\*\* 既存のセキュリティグループの ID。このパラメーターまたは is_enterprise_security_group を設定します。クラスターノードは自動的にこのセキュリティグループに追加されます。
is_enterprise_security_group Boolean いいえ true security_group_id が設定されていない場合にのみ有効な、高度セキュリティグループを作成するかどうかを指定します。 有効値: true (作成する) および false (スキップする)。デフォルト値: true
説明

基本セキュリティグループを使用するには、ノードと Terway Pod の合計が 2,000 を超えないようにしてください。Terway クラスターには、高度セキュリティグループを使用してください。

rds_instances rds_instances いいえ rm-2zev748xi27xc\*\*\*\* 非推奨。ApsaraDB RDS インスタンスの名前。
cluster_spec String いいえ ack.pro.small ACK マネージドクラスターのタイプ。有効値:ack.pro.small (ACK Edge プロ版) および ack.standard (ACK Edge ベーシック版)。デフォルト値:ack.standard。空のままにすると、ACK Edge ベーシック版クラスターが作成されます。ack.standard。詳細は、ACK Edge プロ版クラスターの概要をご参照ください。
resource_group_id String いいえ rg-acfm3mkrure\*\*\*\* リソースグループ ID。リソースグループ間でクラスターを分離するために使用します。

レスポンス構文

HTTP/1.1 200
Content-Type:application/json
{
  "cluster_id" : "String",
  "request_id" : "String",
  "task_id" : "String"
}

レスポンスパラメーター

表 2. レスポンスボディパラメーター

パラメーター 説明
cluster_id String cb95aa626a47740afbf6aa099b650\*\*\*\* クラスター ID。
request_id String 687C5BAA-D103-4993-884B-C35E4314A1E1 リクエスト ID。
task_id String T-5a54309c80282e39ea00002f タスク ID。

リクエスト例

POST /clusters
<Common request headers>
{
    "name":"ACK Edge cluster",
    "cluster_type":"ManagedKubernetes",
    "disable_rollback":true,
    "timeout_mins":60,
    "kubernetes_version":"1.14.8-aliyunedge.1",
    "region_id":"cn-zhangjiakou",
    "snat_entry":true,
    "cloud_monitor_flags":true,
    "endpoint_public_access":true,
    "deletion_protection":true,
    "node_cidr_mask":"25",
    "tags":[
        {
            "key":"tag-k",
            "value":"tag-v"
        }
    ],
    "addons":[
        {
            "name":"logtail-ds-docker"
        },
        {
            "name":"alibaba-log-controller",
            "config":"{\"IngressDashboardEnabled\":\"false\"}"
        },
        {
            "name":"flannel"
        },
        {
            "name":"alicloud-monitor-controller"
        }
    ],
    "profile":"Edge",            // クラスターが ACK エッジクラスターであることを指定します。
    "logging_type" : "SLS",
    "worker_instance_types":[
        "ecs.hfc6.large"
    ],
    "runtime":{                       // コンテナランタイムの構成。
        "name":"containerd",              // コンテナランタイムの名前。
        "version":"1.6.20"          // コンテナランタイムのバージョン。
    },
    "num_of_nodes":1,
    "worker_system_disk_category":"cloud_ssd",
    "worker_system_disk_size":40,
    "worker_data_disks":[
        {
            "category":"cloud_efficiency",
            "size":"40",
            "encrypted":"false",
            "auto_snapshot_policy_id":"",
        }
    ],
    "worker_instance_charge_type":"PostPaid",
    "vpcid":"vpc-8vb435kr467tnfj42****",
    "container_cidr":"172.20.0.0/16",
    "service_cidr":"172.21.0.0/20",
    "vswitch_ids":[
        "vsw-8vbhdhn461i65p32g****"
    ],
    "login_password":"Hello1234",
    "key_pair": "sin-name",
    "security_group_id":"sg-8vb7grbyvlb10j0i****",
    "is_enterprise_security_group":true,
    "rds_instances": ["rm-xx","rm-xx"]
}

成功レスポンス例

XML 形式

<cluster_id>cb95aa626a47740afbf6aa099b650****</cluster_id>
<task_id>T-5a54309c80282e39ea00002f</task_id>
<request_id>687C5BAA-D103-4993-884B-C35E4314A1E1</request_id>

JSON 形式

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

エラーコード

エラーセンターをご参照ください。

詳細は、「サービスエラーコード」をご参照ください。