Java SDK調(diào)用示例
本文介紹如何使用OpenAPI調(diào)用DescribeEnsRegions查詢您可以使用的ENS節(jié)點(diǎn)列表。
步驟一：查看OpenAPI文檔
在調(diào)用OpenAPI前，建議您先閱讀對(duì)應(yīng)的接口文檔DescribeEnsRegions了解、學(xué)習(xí)調(diào)用該接口所需要的參數(shù)及權(quán)限等，更多信息請(qǐng)參見(jiàn)API概覽。
步驟二：創(chuàng)建RAM用戶并完成授權(quán)
阿里云賬號(hào)擁有所有API的訪問(wèn)權(quán)限，建議您創(chuàng)建并使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維。
您可以使用阿里云賬號(hào)（主賬號(hào)）、RAM用戶、RAM角色調(diào)用該接口，有關(guān)各種身份的差異請(qǐng)參見(jiàn)身份。
本案例中，我們使用RAM用戶進(jìn)行接口調(diào)用。
登錄RAM訪問(wèn)控制。
在左側(cè)導(dǎo)航欄，選擇。
在用戶頁(yè)面，單擊創(chuàng)建用戶。
在創(chuàng)建用戶頁(yè)面，設(shè)置登錄名稱和顯示名稱、訪問(wèn)方式為控制臺(tái)訪問(wèn)。
單擊確定。
創(chuàng)建RAM用戶成功后，請(qǐng)記錄用戶登錄名稱和密碼，您在調(diào)用OpenAPI時(shí)，需要使用該RAM用戶登錄阿里云OpenAPI開(kāi)發(fā)者門戶。
為RAM用戶授權(quán)。
說(shuō)明AliyunENSFullAccess：管理邊緣節(jié)點(diǎn)服務(wù)（ENS）的權(quán)限。
AliyunENSReadOnlyAccess：只讀訪問(wèn)邊緣節(jié)點(diǎn)服務(wù)（ENS）的權(quán)限。
如果您需要新建自定義權(quán)限，請(qǐng)參見(jiàn)授權(quán)信息。
訪問(wèn)RAM用戶列表。
單擊目標(biāo)RAM用戶操作列的添加權(quán)限。
在文本框中輸入關(guān)鍵字
ENS進(jìn)行搜索，選擇AliyunENSFullAccess 策略。單擊確定新增授權(quán)，完成授權(quán)操作。
進(jìn)入到對(duì)應(yīng)的RAM用戶詳情頁(yè)，在認(rèn)證管理頁(yè)簽，點(diǎn)擊創(chuàng)建 AccessKey。
更多操作詳情，請(qǐng)參見(jiàn)創(chuàng)建AccessKey。
步驟三：調(diào)用OpenAPI
本文以Java語(yǔ)言SDK調(diào)用OpenAPI，其他語(yǔ)言SDK的用法類似，更多信息請(qǐng)參見(jiàn)邊緣節(jié)點(diǎn)服務(wù) SDK。您也可根據(jù)業(yè)務(wù)的實(shí)際需要選擇其他調(diào)用方式，更多調(diào)用方法請(qǐng)參見(jiàn)調(diào)用方式。
配置環(huán)境變量
環(huán)境變量是操作系統(tǒng)特定的系統(tǒng)級(jí)參數(shù)，包含特定名稱和特定值，為運(yùn)行在操作系統(tǒng)上的應(yīng)用程序提供運(yùn)行環(huán)境設(shè)定。在不同系統(tǒng)的環(huán)境變量中設(shè)置阿里云AccessKey的方法，請(qǐng)參見(jiàn)在Linux、macOS和Windows系統(tǒng)配置環(huán)境變量。
下載示例代碼
訪問(wèn)DescribeEnsRegions。
在左側(cè)的參數(shù)配置頁(yè)簽，填寫需要的參數(shù)信息。
在右側(cè)的SDK示例頁(yè)簽，SDK版本選擇v2.0，語(yǔ)言選擇Java語(yǔ)言，單擊下載完整工程按鈕，下載示例代碼包。
本地解壓并進(jìn)入alibabacloud_sample目錄。
打開(kāi)項(xiàng)目
使用IntelliJ IDEA加載項(xiàng)目，待相關(guān)依賴加載完畢后，打開(kāi) src/main/java/com/aliyun/sample/Sample.java。根據(jù)代碼中的注釋提示自行添加打印返回值的代碼。
運(yùn)行項(xiàng)目
單擊IDE右上角的運(yùn)行按鈕，可查看輸出日志。本案例中的返回內(nèi)容如下：
{
"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": "重慶聯(lián)通"
}
]
},
"requestId": "1589E192-A47E-5224-95E2-A18F2D1ED186"
}
}