243      阿裏雲

接入指南__Open API_消息隊列 MQ-阿裏雲

本文檔介紹 MQ Open API 的接入步驟以及注意事項，包含 SDK 的獲取，以及初始化參數的設置。

1. SDK 獲取

公測期間，MQ Open API 的 SDK 獲取方法有2種，一種是下載 SDK 源碼，編譯後加入到本地的 Maven 倉庫中，另一種是下載打包好的 Jar 包，直接導入工程中。

• 下載 SDK 源碼：下載鏈接

  <dependencies>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-ons</artifactId>
            <version>1.2.1-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>2.2.0</version>
        </dependency>
  </dependencies>

  注意：由於公測期間 aliyun-java-sdk-ons 的 lib 目前還沒有部署到軟件倉庫中，所以是從官網上下載 SDK 到本地，編譯部署到本地的軟件倉庫中。

• 下載 Jar 包：SDK Jar 包下載鏈接

  <dependencies>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>2.2.0</version>
        </dependency>
  </dependencies>

  其中 aliyun-java-sdk-ons 的 Jar 包是從官網上下載 SDK 到本地。

2. 公共參數設置

Open API 使用時需要啟動 Open API 的客戶端，而客戶端啟動時需要設置接入點和 AccessKey，SecretKey 等參數信息，具體示例如下:

    /**
    *Open API的接入點，設置為目標Region
    */
    String regionId = "XXXXX";
    /**
    *鑒權使用的AccessKey，由阿裏雲官網控製台獲取
    */
    String accessKey = "XXXXXXXXXXXXXXXXX";
    /**
    *鑒權使用的SecretKey，由阿裏雲官網控製台獲取
    */
    String secretKey = "XXXXXXXXXXXXXXXXX";
    /*
    *通過Open API訪問的雲產品名稱，此處設置為Ons即可
    */
    String productName ="Ons";
    /**
    *對應endPoint接入點的接入點域名
    */
    String domain ="ons.XXXXX.aliyuncs.com";
    try {
        DefaultProfile.addEndpoint(regionId，regionId，productName，domain);
    } catch (ClientException e) {
        e.printStackTrace();
    }
    IClientProfile profile= DefaultProfile.getProfile(regionId，accessKey，secretKey);
    IAcsClient iAcsClient= new DefaultAcsClient(profile);

參數說明

• regionId：指的是 API 的網關所在區域，目前支持的有 cn-beijing，cn-hangzhou，cn-qingdao，cn-shenzhen 等。
• accessKey：指的是用戶在阿裏雲服務器管理控製台上獲取的 AK。
• secretKey：指的是用戶在阿裏雲服務器管理控製台上獲得的 SK。
• endPointName：接入點名稱，同 RegionId 一致即可。
• productName：Open API 的產品名稱，直接寫 Ons 即可。
• domain：Open API 的接入點 Domain，規則是ons.${RegionId}.aliyuncs.com，目前 MQ 支持 Open API 的 Region 請參考下表。

最後更新：2016-11-23 16:04:19

  上一篇： 曆史版本__Open API_消息隊列 MQ-阿裏雲

  下一篇： 公共術語__Open API_消息隊列 MQ-阿裏雲