全部產品
Search
文件中心

Container Service for Kubernetes:Java SDK調用樣本

更新時間:Jul 30, 2024

本文介紹如何通過SDK調用OpenAPI建立一個ACK託管叢集

步驟一:查看OpenAPI文檔

在調用OpenAPI前,建議您先閱讀對應的介面文檔通過OpenAPI建立Kubernetes託管版叢集,瞭解、學習調用該介面所需要的參數及許可權等,更多參數請參見API概覽

步驟二:建立RAM使用者並完成授權

您可以使用阿里雲帳號(主帳號)、RAM使用者、RAM角色調用該介面,有關各種身份的差異請參見身份

重要

阿里雲帳號擁有所有API的存取權限,建議您建立並使用RAM使用者進行API訪問或日常營運。

  1. 建立RAM使用者

    1. 使用阿里雲帳號登入RAM存取控制

    2. 在左側導覽列,選擇身份管理 > 使用者

    3. 使用者頁面,單擊建立使用者

    4. 建立使用者頁面,設定登入名稱稱顯示名稱訪問方式控制台訪問

    5. 單擊確定

      建立RAM使用者成功後,請記錄使用者登入名稱稱和密碼。在調用OpenAPI時,需要使用該RAM使用者登入阿里雲OpenAPI開發人員門戶。

  2. 為RAM使用者授予AliyunCSFullAccess許可權。具體操作,請參見為RAM使用者授權

    說明

    AliyunCSFullAccess管理Container Service for Kubernetes的許可權。

    AliyunCSReadOnlyAccess:唯讀訪問Container Service for Kubernetes的許可權。

    如果您需要建立自訂許可權,請參見授權資訊

  3. 進入對應的RAM使用者詳情頁,在認證管理頁簽,單擊建立 AccessKey。具體操作,請參見建立AccessKey

步驟三:調用OpenAPI

本樣本使用RAM使用者調用CreateCluster建立一個ACK叢集Pro版,通過Java語言SDK為例介紹,其他語言SDK的用法類似,更多資訊請參見Container ServiceKubernetes版SDK。您也可根據業務的實際需要選擇其他調用方式,更多調用方法請參見調用方式

配置環境變數

調用介面前,您需要配置環境變數以擷取訪問憑證。環境變數配置操作,請參見在Linux、macOS和Windows系統配置環境變數

下載SDK範例程式碼

  1. 訪問CreateCluster

  2. 在左側參數配置地區,填寫需要的參數資訊,然後單擊發起調用

    • 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. 在右側SDK樣本頁簽,選擇SDK版本為2.0和SDK語言,然後單擊下載完整工程,下載後在本地完成解壓。

    說明

    SDK版本推薦使用V2.0版本。關於V2.0和V1.0的區別,請參見V1.0 SDK和V2.0 SDK區別

    image

運行SDK範例程式碼

  1. 開啟IntelliJ IDEA,單擊File->Open,選擇解壓後的工程檔案夾,等待Maven自動安裝依賴資訊。

  2. 運行範例程式碼。

    雙擊開啟Sample,確認無報錯後,運行代碼。

  3. 查看運行結果。

    在底部控制台搜尋statusCode,如果看到"statusCode":202表示調用成功已開始建立叢集。您可以在Container Service管理主控台叢集列表頁面看到新建立的叢集。image