本文介紹ACM OpenAPI的SDK擷取方法、調用樣本以及地區和存取點的設定。
說明 此OpenAPI的SDK主要用於對應用配置進行管理,如您需要在應用運行時操作和監聽配置,可考慮使用SDK簡介。
前提條件
在安裝和使用Alibaba Cloud SDK for Java前,確保您已經:
- 安裝Java環境。
Alibaba Cloud SDK for Java要求使用JDK1.6或更高版本。
- 註冊阿里雲帳號並產生存取金鑰(AccessKey)。
詳情參考建立AccessKey。
安裝Alibaba Cloud SDK for Java
您可以通過以下兩種方式擷取Alibaba Cloud SDK for Java。
- 通過Maven直接安裝(推薦):開啟Maven專案下的pom.xml檔案,添加aliyun-java-sdk-core和aliyun-java-sdk-acm依賴。
<dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-core</artifactId> <version>4.4.9</version> </dependency> <dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-acm</artifactId> <version>1.0.1</version> </dependency>
- 在整合式開發環境中匯入JAR檔案:無論您使用Eclipse還是IntelliJ作為整合式開發環境,都可以通過匯入JAR檔案的方式安裝Alibaba Cloud SDK for Java。您可在阿里雲開發套件(SDK)中下載ACM的SDK檔案。
使用Java SDK調用API
以下代碼展示了如何調用ACM的管控API。在實際使用時,請將樣本中的accessKey、secretKey、regionId等參數的值替換為您實際的參數值。
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.acm.model.v20200206.DescribeConfigurationRequest;
import com.aliyuncs.acm.model.v20200206.DescribeConfigurationResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.http.ProtocolType;
public class GetConfigurationExample {
public static void main(String[] args) {
String accessKey = <yourAccessKeyId>;//阿里雲主帳號或子帳號的 AccessKey ID。
String secretKey = <yourAccessKeySecret>;//阿里雲主帳號或子帳號的 AccessKey Secret。
String regionId = "cn-hangzhou";//要執行 API 呼叫的應用所在地區 ID。
String dataId = <yourDataId>;//配置項DataId值
String group = <yourGroup>;//配置項所在分組
String namespaceId = <yourNamespace>;//配置項所在命名空間
DefaultProfile defaultProfile = DefaultProfile.getProfile(regionId, accessKey, secretKey);
DefaultAcsClient defaultAcsClient = new DefaultAcsClient(defaultProfile);
DescribeConfigurationRequest request = new DescribeConfigurationRequest();
request.setSysProtocol(ProtocolType.HTTPS);//使用HTTPS協議(公網region暫不支援)
request.setNamespaceId(namespaceId);
request.setGroup(group);
request.setDataId(dataId);
try {
DescribeConfigurationResponse response = defaultAcsClient.getAcsResponse(request);
System.out.println("配置項內容為:" + response.getConfiguration().getContent());
} catch (ClientException e) {
e.printStackTrace();
}
}
}
地區和存取點列表
ACM API支援的地區,以及對應的regionId和domain如下表所示。
地區名稱 | regionId | domain | 內網domain |
公網 | public | acm.public.aliyuncs.com | 無 |
華東 1(杭州) | cn-hangzhou | acm.cn-hangzhou.aliyuncs.com | acm-vpc.cn-hangzhou.aliyuncs.com |
華東 2(上海) | cn-shanghai | acm.cn-shanghai.aliyuncs.com | acm-vpc.cn-shanghai.aliyuncs.com |
華北 1(青島) | cn-qingdao | acm.cn-qingdao.aliyuncs.com | acm-vpc.cn-qingdao.aliyuncs.com |
華北 2(北京) | cn-beijing | acm.cn-beijing.aliyuncs.com | acm-vpc.cn-beijing.aliyuncs.com |
華北 3(張家口) | cn-zhangjiakou | acm.cn-zhangjiakou.aliyuncs.com | acm-vpc.cn-zhangjiakou.aliyuncs.com |
華南 1(深圳) | cn-shenzhen | acm.cn-shenzhen.aliyuncs.com | acm-vpc.cn-shenzhen.aliyuncs.com |
中國(香港) | cn-hongkong | acm.cn-hongkong.aliyuncs.com | acm-vpc.cn-hongkong.aliyuncs.com |
新加坡 | ap-southeast-1 | acm.ap-southeast-1.aliyuncs.com | acm-vpc.ap-southeast-1.aliyuncs.com |
德國(法蘭克福) | eu-central-1 | acm.eu-central-1.aliyuncs.com | acm-vpc.eu-central-1.aliyuncs.com |
日本(東京) | ap-northeast-1 | acm.ap-northeast-1.aliyuncs.com | acm-vpc.ap-northeast-1.aliyuncs.com |
美國(矽谷) | us-west-1 | acm.us-west-1.aliyuncs.com | acm-vpc.us-west-1.aliyuncs.com |
美國(維吉尼亞) | us-east-1 | acm.us-east-1.aliyuncs.com | acm-vpc.us-east-1.aliyuncs.com |
澳大利亞(雪梨) | ap-southeast-2 | acm.ap-southeast-2.aliyuncs.com | acm-vpc.ap-southeast-2.aliyuncs.com |