使用OpenAPI整合樣本 - ENS

本文介紹如何使用OpenAPI調用DescribeEnsRegions查詢您可以使用的ENS節點列表。

步驟一：查看OpenAPI文檔

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

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

重要

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

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

本案例中，我們使用RAM使用者進行介面調用。

建立RAM使用者。
1. 登入RAM存取控制。
2. 在左側導覽列，選擇身份管理 > 使用者。
3. 在使用者頁面，單擊建立使用者。
4. 在建立使用者頁面，設定登入名稱稱和顯示名稱、訪問方式為控制台訪問。
5. 單擊確定。
  建立RAM使用者成功後，請記錄使用者登入名稱稱和密碼，您在調用OpenAPI時，需要使用該RAM使用者登入阿里雲OpenAPI開發人員門戶。
為RAM使用者授權。
說明
AliyunENSFullAccess：管理邊緣節點服務（ENS）的許可權。
AliyunENSReadOnlyAccess：唯讀訪問邊緣節點服務（ENS）的許可權。
如果您需要建立自訂許可權，請參見授權資訊。
1. 訪問RAM使用者列表。
2. 單擊目標RAM使用者操作列的添加許可權。
3. 在文字框中輸入關鍵字ENS進行搜尋，選擇AliyunENSFullAccess 策略。
4. 單擊確定新增授權，完成授權操作。
進入到對應的RAM使用者詳情頁，在認證管理頁簽，點擊建立 AccessKey。
更多操作詳情，請參見建立AccessKey。

步驟三：調用OpenAPI

本文以Java語言SDK調用OpenAPI，其他語言SDK的用法類似，更多資訊請參見邊緣節點服務 SDK。您也可根據業務的實際需要選擇其他調用方式，更多調用方法請參見調用方式。

配置環境變數

環境變數是作業系統特定的系統級參數，包含特定名稱和特定值，為運行在作業系統上的應用程式提供運行環境設定。在不同系統的環境變數中設定阿里雲AccessKey的方法，請參見在Linux、macOS和Windows系統配置環境變數。

下載範例程式碼

訪問DescribeEnsRegions。
在左側的參數配置頁簽，填寫需要的參數資訊。
在右側的SDK樣本頁簽，SDK版本選擇v2.0，語言選擇Java語言，單擊下載完整工程按鈕，下載範例程式碼包。
本地解壓並進入alibabacloud_sample目錄。

開啟專案

使用IntelliJ IDEA附加元件目，待相關依賴載入完畢後，開啟 src/main/java/com/aliyun/sample/Sample.java。根據代碼中的注釋提示自行添加列印傳回值的代碼。

運行專案

單擊IDE右上方的運行按鈕，可查看輸出日誌。本案例中的返回內容如下：

{
  "headers": {
    "access-control-allow-origin": "*",
    "date": "Tue, 18 Jul 2023 15:26:50 GMT",
    "content-length": "92",
    "keep-alive": "timeout=25",
    "x-acs-request-id": "1589E192-A47E-5224-95E2-A18F2D1ED186",
    "connection": "keep-alive",
    "content-type": "application/json;charset=utf-8",
    "etag": "9fcxMGIK+zckvQOS1NfD6GA2",
    "access-control-expose-headers": "*",
    "x-acs-trace-id": "bdfecedff57c1e8fc1b7970e909bca31"
  },
  "statusCode": 200,
  "body": {
    "code": 0,
    "ensRegions": {
      "ensRegions": [
        {
          "Area": "SouthWestChina",
          "EnName": "",
          "EnsRegionId": "cn-chongqing-unicom",
          "Province": "重慶",
          "Name": "重慶聯通"
        }
      ]
    },
    "requestId": "1589E192-A47E-5224-95E2-A18F2D1ED186"
  }
}