CDN：Java SDK調用樣本

步驟一：查看OpenAPI文檔

在調用OpenAPI前，建議您先閱讀對應介面文檔，瞭解、學習調用該介面所需要的參數及許可權等，更多資訊請參見API概覽。

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

如您已建立RAM使用者且已完成授權，可跳過此步驟。

• 使用阿里雲帳號登入RAM控制台。

• 建立RAM使用者。

  • 在左側導覽列，選擇身份管理 > 使用者。

  • 在使用者頁面，單擊建立使用者。

  • 在建立使用者頁面，設定登入名稱稱和顯示名稱，設定訪問方式為控制台訪問和使用永久 AccessKey訪問 ，單擊確定。

    重要

    RAM使用者的AccessKey Secret只在建立時顯示，不支援查看，請下載CSV檔案後妥善保管。

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

• 為RAM使用者授權。

  說明

  建立RAM使用者後，該RAM使用者無任何操作CDN的許可權。您需要為該RAM使用者授予系統策略（AliyunCDNFullAccess、AliyunCDNReadOnlyAccess）或自訂策略。本案例以授予RAM使用者AliyunCDNReadOnlyAccess策略為例，AliyunCDNReadOnlyAccess策略具備CDN資源的唯讀許可權。

  • 在使用者頁面，單擊目標RAM使用者對應的添加許可權。

  • 在新增授權面板，在系統策略中搜尋選中AliyunCDNReadOnlyAccess，然後單擊確認新增授權。

  • 確認授權結果，單擊關閉。

步驟三：調用OpenAPI

• 使用RAM使用者登入阿里雲OpenAPI開發人員門戶。

• 選擇雲產品為內容分發。

• 在頂部功能表列，選擇工具中心>線上調試。

• 在左側導覽列，找到並單擊DescribeUserDomains介面，服務地址選擇華東1（杭州），DomainName參數輸入要查詢的網域名稱，如果不輸入會顯示此帳號下所有的網域名稱。

  

• 單擊發起調用。

  在調用結果地區，您可以看到查詢結果、Request Header、Response Header等資訊，狀態代碼200表示調用成功。

  

步驟四：擷取SDK範例程式碼

OpenAPI平台提供了多種程式設計語言（Java、Go、Python、Node.js、TypeScript、PHP、C++ 等）的SDK。開發人員只需要整合SDK，通過SDK暴露的方法直接調用OpenAPI 。SDK統一封裝了簽名邏輯、逾時機制、重試機制，並根據文檔返回結構化 Response 對象，易於開發。

以擷取Java SDK範例程式碼為例，其他語言擷取方式相同。

• 在SDK樣本頁簽，選擇SDK版本和SDK語言。推薦使用V2.0版本。關於V2.0和V1.0的區別，請參見V1.0 SDK和V2.0 SDK區別。

• 單擊下載完整工程可以下載完整的SDK工程。下載完後完成解壓

  說明

  • 在SDK樣本顯示地區的右上方，單擊表徵圖可以複製SDK範例程式碼。

  • 單擊SDK資訊，可以擷取SDK包名稱、SDK包版本、SDK包管理平台、SDK安裝命令等基礎資訊，便於您整合開發。

  

步驟五：運行SDK範例程式碼

以運行Java SDK範例程式碼為例。

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

2. 在調用之前，需要先擷取訪問憑證AccessKey，建議使用前面建立的RAM使用者AccessKey。更多資訊，請參見建立RAM使用者的AccessKey。

   重要

   擷取RAM使用者的AccessKey之後，還需要在環境變數中設定AccessKey，具體操作步驟請參見在Linux、macOS和Windows系統配置環境變數。

3. 運行範例程式碼。

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

   

4. 查看運行結果。在底部控制台按下ctrl+f，搜尋statusCode，如果看到"statusCode":200表示調用成功。