全部產品
Search
文件中心

:擷取OpenAPI SDK

更新時間:Jul 06, 2024

本文介紹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如下表所示。

地區名稱regionIddomain內網domain
公網publicacm.public.aliyuncs.com
華東 1(杭州)cn-hangzhouacm.cn-hangzhou.aliyuncs.comacm-vpc.cn-hangzhou.aliyuncs.com
華東 2(上海)cn-shanghaiacm.cn-shanghai.aliyuncs.comacm-vpc.cn-shanghai.aliyuncs.com
華北 1(青島)cn-qingdaoacm.cn-qingdao.aliyuncs.comacm-vpc.cn-qingdao.aliyuncs.com
華北 2(北京)cn-beijingacm.cn-beijing.aliyuncs.comacm-vpc.cn-beijing.aliyuncs.com
華北 3(張家口)cn-zhangjiakouacm.cn-zhangjiakou.aliyuncs.comacm-vpc.cn-zhangjiakou.aliyuncs.com
華南 1(深圳)cn-shenzhenacm.cn-shenzhen.aliyuncs.comacm-vpc.cn-shenzhen.aliyuncs.com
中國(香港)cn-hongkongacm.cn-hongkong.aliyuncs.comacm-vpc.cn-hongkong.aliyuncs.com
新加坡ap-southeast-1acm.ap-southeast-1.aliyuncs.comacm-vpc.ap-southeast-1.aliyuncs.com
德國(法蘭克福)eu-central-1acm.eu-central-1.aliyuncs.comacm-vpc.eu-central-1.aliyuncs.com
日本(東京)ap-northeast-1acm.ap-northeast-1.aliyuncs.comacm-vpc.ap-northeast-1.aliyuncs.com
美國(矽谷)us-west-1acm.us-west-1.aliyuncs.comacm-vpc.us-west-1.aliyuncs.com
美國(維吉尼亞)us-east-1acm.us-east-1.aliyuncs.comacm-vpc.us-east-1.aliyuncs.com
澳大利亞(雪梨)ap-southeast-2acm.ap-southeast-2.aliyuncs.comacm-vpc.ap-southeast-2.aliyuncs.com