請(qǐng)求語(yǔ)法

POST /clusters HTTP/1.1 
Content-Type:application/json
{
  "name" : "String",
  "region_id" : "String",
  "cluster_type" : "String",
  "cluster_spec" : "String",
  "kubernetes_version" : "String",
  "resource_group_id" : "String",
  "vpcid" : "String",
  "vswitch_ids" : [ "String" ],
  "pod_vswitch_ids" : [ "String" ],
  "container_cidr" : "String",
  "service_cidr" : "String",
  "security_group_id" : "String",
  "is_enterprise_security_group" : Boolean,
  "node_cidr_mask" : "String",
  "snat_entry" : Boolean,
  "endpoint_public_access" : Boolean,
  "load_balancer_spec" :  "String",
  "timezone" : "String",
  "proxy_mode" : "String",
  "enable_rrsa" : Boolean,
  "tags" : [ {
    "key" : "String",
    "value" : "String"
  } ],
  "cluster_domain" : "String",
  "custom_san" : "String",
  "service_account_issuer" : "String",
  "api_audiences" : "String",
  "encryption_provider_key" : "String",
  "timeout_mins" : Long,
  "disable_rollback" : Boolean,
  "deletion_protection" : Boolean,
  "addons" : [ {
    "name" : "String",
    "config" : "String",
    "disabled" : Boolean
  } ],
  "controlplane_log_ttl" : "String",
  "controlplane_log_project" : "String",
  "controlplane_log_components" : [ "String" ],
  "nodepools" : [ {
    "auto_scaling" : {
      "enable" : Boolean,
      "max_instances" : Long,
      "min_instances" : Long,
      "type" : "String",
      "is_bond_eip" : Boolean,
      "eip_internet_charge_type" : "String",
      "eip_bandwidth" : Long
    },
    "kubernetes_config" : {
      "cms_enabled" : Boolean,
      "cpu_policy" : "String",
      "labels" : [ {
        "key" : "String",
        "value" : "String"
      } ],
      "runtime" : "String",
      "runtime_version" : "String",
      "taints" : [ {
        "key" : "String",
        "value" : "String",
        "effect" : "String"
      } ],
      "user_data" : "String"
    },
    "nodepool_info" : {
      "name" : "String",
      "resource_group_id" : "String"
    },
    "scaling_group" : {
      "auto_renew" : Boolean,
      "auto_renew_period" : Long,
      "data_disks" : [ {
        "category" : "String",
        "size" : Long,
        "encrypted" : "String",
        "auto_snapshot_policy_id" : "String"
      } ],
      "image_id" : "String",
      "instance_charge_type" : "String",
      "instance_types" : [ "String" ],
      "key_pair" : "String",
      "login_password" : "String",
      "period" : Long,
      "period_unit" : "String",
      "platform" : "String",
      "rds_instances" : [ "String" ],
      "spot_strategy" : "String",
      "spot_price_limit" : [ {
        "instance_type" : "String",
        "price_limit" : "String"
      } ],
      "scaling_policy" : "String",
      "security_group_id" : "String",
      "security_group_ids" : [ "String" ],
      "system_disk_category" : "String",
      "system_disk_size" : Long,
      "tags" : [ {
        "key" : "String",
        "value" : "String"
      } ],
      "vswitch_ids" : [ "String" ],
      "multi_az_policy" : "String",
      "on_demand_base_capacity" : Long,
      "on_demand_percentage_above_base_capacity" : Long,
      "spot_instance_pools" : Long,
      "spot_instance_remedy" : Boolean,
      "compensate_with_on_demand" : Boolean,
      "internet_charge_type" : "String",
      "internet_max_bandwidth_out" : Long
    },
    "tee_config" : {
      "tee_enable" : Boolean
    },
    "management" : {
      "enable" : Boolean,
      "auto_repair" : Boolean,
      "upgrade_config" : {
        "auto_upgrade" : Boolean,
        "surge" : Long,
        "surge_percentage" : Long,
        "max_unavailable" : Long
      }
    },
    "count" : Long
  } ]
}

請(qǐng)求參數(shù)

響應(yīng)體語(yǔ)法

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

響應(yīng)參數(shù)

創(chuàng)建ACK托管集群示例

請(qǐng)求示例

POST /clusters 
<公共請(qǐng)求頭>
{
    "name":"ACK托管版",                      // 集群名稱 #required
    "region_id":"cn-zhangjiakou",           // 地域ID, #required
    "cluster_type":"ManagedKubernetes",     // 集群類型 #required
    "cluster_spec":"ack.pro.small",        // 托管版集群類型。ack.pro.small：ACK Pro版集群；ack.standard：ACK基礎(chǔ)版集群。
    "kubernetes_version":"1.28.9-aliyun.1",  // 集群版本，只維護(hù)最新的3個(gè)版本。
    "resource_group_id":"rg-acfm3mkrure****",
    "vpcid":"vpc-8vbh3b9a2f38urhls****",          // 集群專有網(wǎng)絡(luò)ID。 #required
    "vswitch_ids":[                               // 集群虛擬交換機(jī)ID。 #required
        "vsw-8vbmoffowsztjaawj****"
    ],
    "pod_vswitch_ids":[                                // Terway網(wǎng)絡(luò)類型的集群，需要指定Pod所在的虛擬交換，因?yàn)镻od獨(dú)占一個(gè)機(jī)器IP。                     
        "vsw-8vbo5fwyqiw0bbtlq****"
    ],
    "container_cidr":"172.20.0.0/16",             // 集群Pod網(wǎng)段#required, 網(wǎng)絡(luò)模式是terway插件的情況下不必須。
    "service_cidr":"172.21.0.0/20",               // 集群Service網(wǎng)段。 #required
    "security_group_id":"sg-8vb7grbyvlb10j0i****",     // 使用已有安全組。和is_enterprise_security_group二選一。
    "is_enterprise_security_group":true,               // 自動(dòng)創(chuàng)建企業(yè)安全組，和security_group_id二選一。
    "node_cidr_mask":"25",                // 節(jié)點(diǎn)IP數(shù)量，通過(guò)指定節(jié)點(diǎn)網(wǎng)段的掩碼來(lái)決定。  
    "snat_entry":true,                 // 為專有網(wǎng)絡(luò)配置SNAT規(guī)則，以開(kāi)啟集群公網(wǎng)訪問(wèn)。
    "endpoint_public_access":true,      // 開(kāi)啟公網(wǎng)訪問(wèn)。
    "load_balancer_spec":slb.s2.small,   
    "timezone":"Asia/Shanghai",   // 時(shí)區(qū)
    "proxy_mode":"ipvs",           // kube-proxy代理模式，取值：iptables或者ipvs。
    "enable_rrsa":true,
    "tags":[                       // 集群標(biāo)簽。標(biāo)簽將同時(shí)作用于 ACK集群、ECS實(shí)例和Kubernetes節(jié)點(diǎn)。
        {
            "key":"tag-k",
            "value":"tag-v"
        }
    ],
    "cluster_domain":"cluster.local",    // 集群本地域名，默認(rèn)：cluster.local。
    "custom_san":"cs.aliyuncs.com",      // 集群自定義證書(shū)SAN。
    "service_account_issuer":"kubernetes.default.svc", // 服務(wù)賬戶令牌卷投影。serviceaccount token中的簽發(fā)身份，即token payload中的iss字段。
    "api_audiences":"kubernetes.default.svc",          // 服務(wù)賬戶令牌卷投影。合法的請(qǐng)求token身份，用于apiserver服務(wù)端認(rèn)證請(qǐng)求token是否合法。
    "encryption_provider_key":"8734596c-c0d6-4a63-a76e-fe72c7b0****", // Secret落盤(pán)加密的密鑰ID。
    "timeout_mins":60,                      // 集群創(chuàng)建超時(shí)時(shí)間。
    "disable_rollback":true,                // 失敗是否回滾。
    "deletion_protection":true,    // 集群刪除保護(hù)。
    "addons":[                    // 組件配置
        {
            "name":"flannel"      // 當(dāng)集群網(wǎng)絡(luò)類型是Terway時(shí)，設(shè)置為{"name":"terway-eniip"}。
        },
        {
            "name":"csi-plugin"
        },
        {
            "name":"csi-provisioner"
        },
        {
            "name":"logtail-ds",
            "config":"{\"IngressDashboardEnabled\":\"true\"}"
        },
        {
            "name":"ack-node-problem-detector",
            "config":"{\"sls_project_name\":\"\"}"
        },
        {
            "name":"nginx-ingress-controller",                      // 組件名稱
            "config":"{\"IngressSlbNetworkType\":\"internet\"}",    // 組件配置
            "disabled": true                                        // 是否禁止默認(rèn)安裝。
        },
        {
            "name":"arms-prometheus"
        }
    ],
    "controlplane_log_ttl" : "30",
    "controlplane_log_project" : "k8s-log-xxx",
    "controlplane_log_components" : ["apiserver","kcm","scheduler"],
    "nodepools" : [ {
      "auto_scaling" : {
        "enable" : true,
        "max_instances" : 10,
        "min_instances" : 1,
        "type" : "cpu"
      },
      "kubernetes_config" : {
        "cms_enabled" : true,
        "cpu_policy" : "none",
        "labels" : [ {
          "key" : "env",
          "value" : "prod"
        } ],
        "runtime" : "containerd",
        "runtime_version" : "1.6.20",
        "taints" : [ {
          "key" : "key",
          "value" : "value",
          "effect" : "NoSchedule"
        } ],
        "user_data" : "dGhpcyBpcyBhIGV4YW1wbGU=",
        "node_name_mode" : "aliyun.com00055test"
      },
      "nodepool_info" : {
        "name" : "cluster-demo",
        "resource_group_id" : "rg-acfmyvw3wjmb****",
        "type" : "ess"
      },
      "scaling_group" : {
        "auto_renew" : true,
        "auto_renew_period" : 1,
        "data_disks" : [ {
          "category" : "cloud_ssd",
          "size" : 40,
          "encrypted" : "true",
          "auto_snapshot_policy_id" : "sp-2zej1nogjvovnz4z****",
          "performance_level" : "PL1"
        } ],
        "image_id" : "aliyun_2_1903_x64_20G_alibase_20200529.vhd",
        "instance_charge_type" : "PrePaid",
        "instance_types" : [ "ecs.d1ne.2xlarge" ],
        "key_pair" : "np-key-name",
        "login_password" : "Hello1234",
        "period" : 1,
        "period_unit" : "Month",
        "platform" : "AliyunLinux",
        "rds_instances" : [ "rds-****" ],
        "spot_strategy" : "NoSpot",
        "spot_price_limit" : [ {
          "instance_type" : "ecs.c6.large",
          "price_limit" : "0.39"
        } ],
        "scaling_policy" : "release",
        "security_group_id" : "sg-wz9a8g2mt6x5llu0****",
        "security_group_ids" : [ "sg-wz9a8g2mt6x5llu0****" ],
        "system_disk_category" : "cloud_efficiency",
        "system_disk_size" : 120,
        "system_disk_performance_level" : "PL1",
        "tags" : [ {
          "key" : "node-k-1",
          "value" : "node-v-1"
        } ],
        "vswitch_ids" : [ "vsw-wz9mfnhmssud6eicu****" ],
        "multi_az_policy" : "COST_OPTIMIZED",
        "on_demand_base_capacity" : 0,
        "on_demand_percentage_above_base_capacity" : 20,
        "spot_instance_pools" : 5,
        "spot_instance_remedy" : false,
        "compensate_with_on_demand" : true,
        "internet_charge_type" : "PayByTraffic",
        "internet_max_bandwidth_out" : 5,
        "image_type" : "AliyunLinux",
        "deploymentset_id" : "ds-bp1d19mmbsv3jf6xxxxx",
        "desired_size" : 0
      },
      "tee_config" : {
        "tee_enable" : true
      },
      "management" : {
        "enable" : false,
        "auto_repair" : false,
        "upgrade_config" : {
          "auto_upgrade" : false,
          "surge" : 0,
          "surge_percentage" : 0,
          "max_unavailable" : 1
        }
      },
      "count" : 1,
      "interconnect_mode" : "basic",
      "interconnect_config" : {
        "cen_id" : "cen-ey9k9nfhz0f*******",
        "ccn_id" : "ccn-qm5i0i0q9yi*******",
        "ccn_region_id" : "cn-shanghai",
        "bandwidth" : 10,
        "improved_period" : "1"
      },
      "max_nodes" : 10
  } ]
}

返回示例

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

JSON格式

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

錯(cuò)誤碼

訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。

開(kāi)發(fā)者資源

• SDK

  阿里云為您提供多種語(yǔ)言的SDK，幫助您快速通過(guò)API集成阿里云的產(chǎn)品和服務(wù)，推薦您使用SDK調(diào)用API，已免除您手動(dòng)簽名驗(yàn)證，詳情請(qǐng)參見(jiàn)SDK參考文檔鏈接。

• OpenAPI Explorer

  快速檢索，可視化調(diào)試API，在線命令行工具，同步動(dòng)態(tài)生成可執(zhí)行的SDK代碼示例。

• 阿里云CLI

  阿里云資產(chǎn)管理和配置工具，可通過(guò)命令方式同時(shí)管理多個(gè)阿里云產(chǎn)品和服務(wù)，簡(jiǎn)單快捷，是您上云好幫手。