本文介紹如何通過SDK調用OpenAPI建立一個ACK託管叢集。
步驟一:查看OpenAPI文檔
在調用OpenAPI前,建議您先閱讀對應的介面文檔通過OpenAPI建立Kubernetes託管版叢集,瞭解、學習調用該介面所需要的參數及許可權等,更多參數請參見API概覽。
步驟二:建立RAM使用者並完成授權
您可以使用阿里雲帳號(主帳號)、RAM使用者、RAM角色調用該介面,有關各種身份的差異請參見身份。
阿里雲帳號擁有所有API的存取權限,建議您建立並使用RAM使用者進行API訪問或日常營運。
使用阿里雲帳號登入RAM存取控制。
在左側導覽列,選擇。
在使用者頁面,單擊建立使用者。
在建立使用者頁面,設定登入名稱稱和顯示名稱、訪問方式為控制台訪問。
單擊確定。
建立RAM使用者成功後,請記錄使用者登入名稱稱和密碼。在調用OpenAPI時,需要使用該RAM使用者登入阿里雲OpenAPI開發人員門戶。
為RAM使用者授予AliyunCSFullAccess許可權。具體操作,請參見為RAM使用者授權。
說明AliyunCSFullAccess:管理Container Service for Kubernetes的許可權。
AliyunCSReadOnlyAccess:唯讀訪問Container Service for Kubernetes的許可權。
如果您需要建立自訂許可權,請參見授權資訊。
進入對應的RAM使用者詳情頁,在認證管理頁簽,單擊建立 AccessKey。具體操作,請參見建立AccessKey。
步驟三:調用OpenAPI
本樣本使用RAM使用者調用CreateCluster建立一個ACK叢集Pro版,通過Java語言SDK為例介紹,其他語言SDK的用法類似,更多資訊請參見Container ServiceKubernetes版SDK。您也可根據業務的實際需要選擇其他調用方式,更多調用方法請參見調用方式。
配置環境變數
調用介面前,您需要配置環境變數以擷取訪問憑證。環境變數配置操作,請參見在Linux、macOS和Windows系統配置環境變數。
下載SDK範例程式碼
在左側參數配置地區,填寫需要的參數資訊,然後單擊發起調用。
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****
在右側SDK樣本頁簽,選擇SDK版本為2.0和SDK語言,然後單擊下載完整工程,下載後在本地完成解壓。
說明SDK版本推薦使用V2.0版本。關於V2.0和V1.0的區別,請參見V1.0 SDK和V2.0 SDK區別。

運行SDK範例程式碼
開啟IntelliJ IDEA,單擊File->Open,選擇解壓後的工程檔案夾,等待Maven自動安裝依賴資訊。
運行範例程式碼。
雙擊開啟Sample,確認無報錯後,運行代碼。
查看運行結果。
在底部控制台搜尋
statusCode,如果看到"statusCode":202表示調用成功已開始建立叢集。您可以在Container Service管理主控台的叢集列表頁面看到新建立的叢集。