Java SDK
本文介紹安裝云網(wǎng)管Java SDK及使用Java SDK完成常見(jiàn)操作的相關(guān)步驟。
前提條件
已開(kāi)通云網(wǎng)管。更多信息,請(qǐng)參見(jiàn)開(kāi)通使用云網(wǎng)管。
已創(chuàng)建并獲取AccessKey。更多信息,請(qǐng)參見(jiàn)訪問(wèn)密鑰。
已安裝Java開(kāi)發(fā)環(huán)境。
云網(wǎng)管Java SDK支持J2SE 6.0及以上的Java運(yùn)行環(huán)境,您可以執(zhí)行java -version命令檢查您已安裝的Java版本。如果未安裝,可以從Java官方網(wǎng)站下載安裝包并完成安裝。
步驟1:安裝Java SDK
您可以通過(guò)以下兩種方式安裝云網(wǎng)管Java SDK:
方式一:在Maven項(xiàng)目中加入依賴項(xiàng)(推薦方式)。
在Maven工程中使用云網(wǎng)管Java SDK,只需在pom.xml中加入相應(yīng)依賴即可。以0.0.1版本為例,在<dependencies>中加入如下內(nèi)容:
<dependency> <groupId>com.aliyun</groupId> <artifactId>cmn20200825</artifactId> <version>0.0.1</version> </dependency>
方式二:在Eclipse中導(dǎo)入JAR包。
以0.0.1版本為例,步驟如下:
下載Java SDK,下載鏈接請(qǐng)參見(jiàn)Aliyun CMN Java SDK
將cmn20200825-0.0.1.jar拷貝到您的項(xiàng)目中。
在Eclipse中選擇您的工程,右擊選擇Properties > Java Build Path > Add JARs。
選中步驟2中拷貝的JAR文件。
步驟2:創(chuàng)建云網(wǎng)管Client
Client是云網(wǎng)管的Java客戶端,用于管理Device,MonitorItem等云網(wǎng)管資源。使用Java SDK發(fā)起云網(wǎng)管請(qǐng)求,您需要初始化一個(gè)Client實(shí)例。
Config authConfig = new Config();
/**
* 阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限,建議您使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維。
* 強(qiáng)烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導(dǎo)致AccessKey泄露,威脅您賬號(hào)下所有資源的安全。
* 調(diào)用接口前請(qǐng)先配置身份認(rèn)證,具體操作請(qǐng)參見(jiàn)http://bestwisewords.com/document_detail/378657.html。
* 本示例使用了阿里云Credentials工具托管AccessKey,來(lái)實(shí)現(xiàn)API訪問(wèn)的身份驗(yàn)證。
*/
com.aliyun.credentials.Client credentialClient = new com.aliyun.credentials.Client();
authConfig.endpoint = "region_endpoint"; //在實(shí)際使用中,請(qǐng)按照您實(shí)際的服務(wù)入口和接入方式編寫。
authConfig.regionId = "cn-hangzhou"; //在實(shí)際使用中,請(qǐng)按照您實(shí)際的服務(wù)地域編寫。
authConfig.setCredential(credentialClient);
Client authClient = new Client(authConfig);
Java SDK示例
此處以分頁(yè)獲取資源管理下的所有設(shè)備列表為例。
//初始化ListDevices的請(qǐng)求類。
ListDevicesRequest request = new ListDevicesRequest();
request.setMaxResults(10); //分頁(yè)參數(shù),每頁(yè)獲取10行。
request.setDeviceFormName("網(wǎng)絡(luò)設(shè)備"); //設(shè)備形態(tài)名稱,在實(shí)際使用中,請(qǐng)按照您實(shí)際設(shè)備形態(tài)編寫。
//使用request實(shí)例調(diào)用ListDevices接口,且返回參數(shù)為對(duì)應(yīng)的Response實(shí)例。
ListDevicesResponse response = authClient.listDevices(request);
//其他代碼。