`profile=Edge` を指定して `CreateCluster` を呼び出し、ネットワーク、ランタイム、ワーカーノードを設定します。
デバッグ
リクエスト構文
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。クラスター作成に必須です。
説明
|
| 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"
}
エラーコード
エラーセンターをご参照ください。
詳細は、「サービスエラーコード」をご参照ください。