步驟一：查看OpenAPI文檔

在調(diào)用OpenAPI前，建議您先閱讀對應(yīng)的接口文檔通過OpenAPI創(chuàng)建Kubernetes托管版集群，了解、學(xué)習(xí)調(diào)用該接口所需要的參數(shù)及權(quán)限等，更多參數(shù)請參見API概覽。

步驟二：創(chuàng)建RAM用戶并完成授權(quán)

您可以使用阿里云賬號（主賬號）、RAM用戶、RAM角色調(diào)用該接口，有關(guān)各種身份的差異請參見身份。

1. 創(chuàng)建RAM用戶。

   1. 使用阿里云賬號登錄RAM訪問控制。

   2. 在左側(cè)導(dǎo)航欄，選擇身份管理 > 用戶。

   3. 在用戶頁面，單擊創(chuàng)建用戶。

   4. 在創(chuàng)建用戶頁面，設(shè)置登錄名稱和顯示名稱、訪問方式為控制臺訪問。

   5. 單擊確定。

      創(chuàng)建RAM用戶成功后，請記錄用戶登錄名稱和密碼。在調(diào)用OpenAPI時，需要使用該RAM用戶登錄阿里云OpenAPI開發(fā)者門戶。

2. 為RAM用戶授予AliyunCSFullAccess權(quán)限。具體操作，請參見為RAM用戶授權(quán)。

   說明

   AliyunCSFullAccess：管理容器服務(wù) Kubernetes 版的權(quán)限。

   AliyunCSReadOnlyAccess：只讀訪問容器服務(wù) Kubernetes 版的權(quán)限。

   如果您需要新建自定義權(quán)限，請參見授權(quán)信息。

3. 進(jìn)入對應(yīng)的RAM用戶詳情頁，在認(rèn)證管理頁簽，單擊創(chuàng)建 AccessKey。具體操作，請參見創(chuàng)建AccessKey。

步驟三：調(diào)用OpenAPI

本示例使用RAM用戶調(diào)用CreateCluster創(chuàng)建一個ACK集群Pro版，通過Java語言SDK為例介紹，其他語言SDK的用法類似，更多信息請參見容器服務(wù)Kubernetes版SDK。您也可根據(jù)業(yè)務(wù)的實際需要選擇其他調(diào)用方式，更多調(diào)用方法請參見調(diào)用方式。

配置環(huán)境變量

調(diào)用接口前，您需要配置環(huán)境變量以獲取訪問憑證。環(huán)境變量配置操作，請參見在Linux、macOS和Windows系統(tǒng)配置環(huán)境變量。

下載SDK示例代碼

1. 訪問CreateCluster。

2. 在左側(cè)參數(shù)配置區(qū)域，填寫需要的參數(shù)信息，然后單擊發(fā)起調(diào)用。

   • name示例值：test

   • region_id示例值：cn-beijing

   • cluster_type示例值：ManagedKubernetes

   • cluster_spec示例值：ack.pro.small

   • cluster_version示例值：1.30.1-aliyun.1

   • vpcid示例值：vpc-2zedl8cyb7tnkaux1****

   • container_cidr示例值：10.0.0.0/8

   • service_cidr示例值：172.21.0.0/20

   • vswitch_ids示例值：vsw-2ze7hfp0ah8rk1nz9****

3. 在右側(cè)SDK示例頁簽，選擇SDK版本為2.0和SDK語言，然后單擊下載完整工程，下載后在本地完成解壓。

   說明

   SDK版本推薦使用V2.0版本。關(guān)于V2.0和V1.0的區(qū)別，請參見V1.0 SDK和V2.0 SDK區(qū)別。

   

運行SDK示例代碼

1. 打開IntelliJ IDEA，單擊File->Open，選擇解壓后的工程文件夾，等待Maven自動安裝依賴信息。

2. 運行示例代碼。

   雙擊打開Sample，確認(rèn)無報錯后，運行代碼。

3. 查看運行結(jié)果。

   在底部控制臺搜索statusCode，如果看到"statusCode":202表示調(diào)用成功已開始創(chuàng)建集群。您可以在容器服務(wù)管理控制臺的集群列表頁面看到新創(chuàng)建的集群。