本文介紹如何通過SDK調用OpenAPI創建一個ACK托管集群。
步驟一:查看OpenAPI文檔
在調用OpenAPI前,建議您先閱讀對應的接口文檔通過OpenAPI創建Kubernetes托管版集群,了解、學習調用該接口所需要的參數及權限等,更多參數請參見API概覽。
步驟二:創建RAM用戶并完成授權
您可以使用阿里云賬號(主賬號)、RAM用戶、RAM角色調用該接口,有關各種身份的差異請參見身份。
阿里云賬號擁有所有API的訪問權限,建議您創建并使用RAM用戶進行API訪問或日常運維。
使用阿里云賬號登錄RAM訪問控制。
在左側導航欄,選擇
。在用戶頁面,單擊創建用戶。
在創建用戶頁面,設置登錄名稱和顯示名稱、訪問方式為控制臺訪問。
單擊確定。
創建RAM用戶成功后,請記錄用戶登錄名稱和密碼。在調用OpenAPI時,需要使用該RAM用戶登錄阿里云OpenAPI開發者門戶。
為RAM用戶授予AliyunCSFullAccess權限。具體操作,請參見為RAM用戶授權。
說明AliyunCSFullAccess:管理容器服務 Kubernetes 版的權限。
AliyunCSReadOnlyAccess:只讀訪問容器服務 Kubernetes 版的權限。
如果您需要新建自定義權限,請參見授權信息。
進入對應的RAM用戶詳情頁,在認證管理頁簽,單擊創建 AccessKey。具體操作,請參見創建AccessKey。
步驟三:調用OpenAPI
本示例使用RAM用戶調用CreateCluster創建一個ACK集群Pro版,通過Java語言SDK為例介紹,其他語言SDK的用法類似,更多信息請參見容器服務Kubernetes版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
表示調用成功已開始創建集群。您可以在容器服務管理控制臺的集群列表頁面看到新創建的集群。