擁抱API經濟:教你三步使用SDK玩轉阿裏雲API
眾所周知,阿裏雲提供了全方位、多層次的雲計算產品體係。阿裏巴巴技術委員會主席王堅博士說過,要讓雲計算像水電一樣方便獲得。為了開發者無縫銜接阿裏雲的眾多服務,將它們集成到自己的應用係統,阿裏雲開放了API和用來訪問API的工具SDK。
什麼是阿裏雲SDK?
阿裏雲Java SDK讓您不用複雜編程即可訪問雲服務器、CDN(內容分發網絡)、OSS(對象存儲)等豐富又強大的雲計算基礎設施。它是麵向開發者的編程庫,能夠直接應用在開發者的應用程序裏,被應用邏輯調用。打個簡單的比方,應用程序是家用電器,阿裏雲的服務就是提供電能的發電站和電網,阿裏雲API就是插孔,SDK就是插頭。
家電有不同的型號,插頭也是各式各樣的;自然,應用程序用各種編程語言開發,運行在應用程序內的SDK自然也有各種編程語言版本。阿裏雲SDK支持了包括Java, Python, PHP, C#等在內的各種語言,滿足各種編程語言的開發者的需要。
小編會在本文向大家介紹一下如何使用Java SDK訪問阿裏雲的API,進行實際的操作,您很快就會發現,原來使用SDK訪問阿裏雲API如此簡單易行。如果您使用了其他語言,歡迎訪問阿裏雲SDK主頁,阿裏雲所有產品的SDK都在這裏哦!
例子:獲取雲服務器的IP地址
第一步:環境準備
阿裏雲Java SDK適用於JDK 6及以上版本。
要使用阿裏雲Java SDK,您需要一個雲賬號以及一對Access Key ID和Access Key Secret。 請在阿裏雲控製台中的AccessKey管理頁麵上創建和查看您的Access Key。
阿裏雲控製台右上角中獲取Access Key的位置
第二步:獲取阿裏雲SDK
獲取阿裏雲Java SDK的方式有很多,小編這裏就介紹大家都常用的開發環境IntelliJ上如何獲取阿裏雲的SDK。其他方式呢,阿裏雲的官網上有詳細介紹,傳送門在這裏,這裏篇幅原因就不多講了。
現在開始!
在阿裏雲Java SDK列表中下載您需要的SDK,例如SDK核心庫和雲服務器的Java SDK。
您將下載到2個文件,aliyun-java-sdk-core-3.2.6.jar和aliyun-java-sdk-ecs-3.3.0.jar。
第三步:調用SDK
為了給大家展示,小編先創建一個空白的Java項目
然後在IntelliJ中,依次選擇菜單:File, Project Structure, Modules, 然後選擇 Dependencies 選項卡。在出現的列表中選擇“添加”(對話框右方的綠色“+”號),再選擇 “JARs or directories”。
最後,彈出的對話框中選中您剛才下載到的兩個Jar包,點擊[OK],您將會在項目中看到這兩個Jar包已經被添加進來了:
將下麵這段代碼Copy到Main.java裏
package com.testprogram
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.ecs.model.v20140526.*;
public class Main {
public static void main(String[] args) {
// 創建DefaultAcsClient實例並初始化
DefaultProfile profile = DefaultProfile.getProfile(
"<your-region-id>", // 您的可用區ID
"<your-access-key-id>", // 您的Access Key ID
"<your-access-key-secret>"); // 您的Access Key Secret
IAcsClient client = new DefaultAcsClient(profile);
// 創建API請求並設置參數
DescribeInstancesRequest request = new DescribeInstancesRequest();
request.setPageSize(10);
// 發起請求並處理異常
DescribeInstancesResponse response;
try {
response = client.getAcsResponse(request);
for (DescribeInstancesResponse.Instance instance:response.getInstances()) {
System.out.println(instance.getPublicIpAddress());
}
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}
然後替換這個樣例代碼中的3個參數,、和。其中Region ID是你的地域,如果不知道怎麼填,就先填cn-hangzhou就好啦。另外2個參數就是您剛剛從阿裏雲控製台獲得的訪問密鑰(Access Key)。
最後就可以開始運行我們令人激動的樣例程序了!
在控製台輸出中您就可以看到您的雲服務器IP地址:
成功了!
在這個例子中,小編事先在華東1(杭州,ID: cn-hangzhou)這個區域購買了2個雲服務器,所以能看到2個IP地址哦。趕緊在阿裏雲控製台購買你的雲服務器吧!
到底發生了什麼?
是不是很神奇?有沒有很驚喜?哈哈,讓小編給大家解釋一下上麵這個樣例都幹了些什麼。
接下來
試了一下上麵獲取雲服務器IP地址的例子,您肯定感覺不夠過癮,沒關係,雲服務器(又稱ECS)服務提供了非常全麵的API,隻要您能想到的API,涵蓋對服務器、磁盤、快照、鏡像、網絡等等。這裏都有:ECS API
除了ECS之外,其他阿裏雲眾多產品也都開放了API哦。https://develop.aliyun.com/tools/openapilist
通過阿裏雲SDK,您可以靈活地控製阿裏雲給您提供的基礎設施、資源和服務,幫助您的業務快速搭建和上線。小編就不多說了,祝您有一個愉快的開發體驗!有任何問題和建議,歡迎到阿裏雲的聆聽平台寫下您的寶貴意見哦。
最後更新:2017-08-19 01:33:04