配置
使用SDK與云網(wǎng)管的服務器端進行交互時需要指定一些基本配置,本文介紹SDK的基本配置信息。
目前,所有語言的SDK都定義了一個Client類作為入口類,這些基本配置信息在該入口類的構造時指定。
具體包括如下幾項:
服務入口(Endpoint):確認Client需要訪問的服務入口。
阿里云訪問密鑰(AccessKey ID,AccessKey secret):指定Client訪問云網(wǎng)管時使用的訪問密鑰。
下面詳細說明這兩個配置的使用方式。
服務入口(Endpoint)
當使用SDK時,首先需要明確訪問的云網(wǎng)管所在地域,例如華東1(杭州)等,然后選擇與其匹配的云網(wǎng)管入口初始化Client。該服務入口與API中的服務入口定義一致。
當選擇Client的Endpoint時,必須要保證您需要訪問的地域和Endpoint對應的地域一致,否則SDK將無法訪問您指定的地域。
由于Client實例只能在構造時指定該服務入口,如果需要訪問不同的地域,則需要用不同的Endpoint構建不同的Client實例。
目前,所有API的服務入口支持HTTPS協(xié)議。
如果在阿里云ECS虛擬機內(nèi)使用SDK,您還可以使用內(nèi)網(wǎng)Endpoint來避免公網(wǎng)帶寬開銷。
訪問密鑰(AccessKey)
所有和云網(wǎng)管端交互的請求都必須經(jīng)過安全驗證,而訪問密鑰就是用來對請求進行安全驗證的關鍵因子,且以AccessKey ID和AccessKey secret方式成對出現(xiàn)。在Client構造時需要指定兩個參數(shù):訪問密鑰對(AccessKey ID,AccessKey secret)。所以,在使用SDK前,請在阿里云控制臺密鑰管理頁面獲取(或者創(chuàng)建)合適的密鑰對。
您的賬號下可以擁有多組訪問密鑰對,但在構造Client時指定的AccessKey ID和AccessKey secret必須成對,否則無法通過服務端的安全驗證。
指定的訪問密鑰對必須處于啟用狀態(tài),否則會被服務端拒絕請求。同樣,您也可以到云控制臺查看訪問密鑰的狀態(tài)。
示例
如果您需要訪問某個地域的云網(wǎng)管,且當前已經(jīng)擁有一對處于啟用狀態(tài)的訪問密鑰對。如下所示:
AccessKeyId = "ywgiwfns**************"
AccessKeySecret = "4fdO2fTDDnZPU/*************"
則可以使用如下實例化對應的Client:
java
Config authConfig = new Config();
/**
* 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
* 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
* 調(diào)用接口前請先配置身份認證,具體操作請參見http://bestwisewords.com/document_detail/378657.html。
* 本示例使用了阿里云Credentials工具托管AccessKey,來實現(xiàn)API訪問的身份驗證。
*/
com.aliyun.credentials.Client credentialClient = new com.aliyun.credentials.Client();
authConfig.endpoint = "region_endpoint"; //在實際使用中,請按照您實際的服務入口和接入方式編寫。
authConfig.regionId = "cn-hangzhou"; //在實際使用中,請按照您實際的服務地域編寫。
authConfig.setCredential(credentialClient);
Client authClient = new Client(authConfig);