在線調(diào)試和生成SDK示例

OpenAPI門戶提供在線調(diào)用云產(chǎn)品API、動(dòng)態(tài)生成SDK示例代碼和快速檢索接口等功能，可以顯著降低使用API的難度。

前提條件

• 已創(chuàng)建AccessKey，詳情請(qǐng)參見創(chuàng)建AccessKey。

• 已安裝Java環(huán)境。Hologres SDK for Java要求使用JDK1.6或更高版本。

• 授予賬號(hào)相應(yīng)權(quán)限，詳情請(qǐng)參見授予RAM用戶權(quán)限。

安裝Alibaba Cloud SDK for Java

您可以通過添加Maven依賴或者其他方式導(dǎo)入依賴，詳細(xì)說明請(qǐng)參見其他方式和開始使用。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>hologram20220601</artifactId>
  <version>1.0.5</version>
</dependency>

請(qǐng)求步驟

1. 導(dǎo)入相關(guān)產(chǎn)品的SDK。

   import com.aliyun.tea.*;
   import com.aliyun.hologram20220601.*;

2. 設(shè)置AccessKey和域名，域名詳情請(qǐng)參見Hologres服務(wù)區(qū)域列表。

   說明

   建議使用環(huán)境變量的方式調(diào)用用戶名和密碼，降低密碼泄露風(fēng)險(xiǎn)。

   Config config = new Config()
       // 您的AccessKey ID
       .setAccessKeyId(System.getenv("ALIBABA_CLOUD_USER"))
       // 您的AccessKey Secret
       .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_PASSWORD"));
   // 訪問的域名
   config.endpoint = "hologram.cn-hangzhou.aliyuncs.com";

3. 新建AcsClient。

   Client client = new Client(config);

4. 創(chuàng)建Request對(duì)象，并設(shè)置請(qǐng)求參數(shù)。

   GetInstanceRequest request = new GetInstanceRequest();

5. 調(diào)用返回結(jié)果。

   GetInstanceResponse response = client.getInstance("your_instance_id", request);
   System.out.println(JSON.toJSONString(response.getBody()));

參考示例

查詢實(shí)例詳情請(qǐng)求示例（適用于1.0.3及以上版本）：

package com.aliyun.sample;

import com.aliyun.hologram20220601.models.GetInstanceResponse;
import com.aliyun.hologram20220601.models.GetInstanceResponseBody;
import com.aliyun.tea.*;
import com.aliyun.hologram20220601.*;

public class Sample {

    /**
     * 使用AK&SK初始化賬號(hào)Client
     * @param accessKeyId
     * @param accessKeySecret
     * @return Client
     * @throws Exception
     */
    public static Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // 必填，您的 AccessKey ID
                .setAccessKeyId(accessKeyId)
                // 必填，您的 AccessKey Secret
                .setAccessKeySecret(accessKeySecret);
        // 訪問的域名
        config.endpoint = "hologram.cn-hangzhou.aliyuncs.com";
        return new Client(config);
    }

    public static void main(String[] args_) throws Exception {
        java.util.List<String> args = java.util.Arrays.asList(args_);
        // 請(qǐng)確保代碼運(yùn)行環(huán)境設(shè)置了環(huán)境變量 ALIBABA_CLOUD_USER 和 ALIBABA_CLOUD_PASSWORD。
        // 工程代碼泄露可能會(huì)導(dǎo)致 AccessKey 泄露，并威脅賬號(hào)下所有資源的安全性。以下代碼示例使用環(huán)境變量獲取 AccessKey 的方式進(jìn)行調(diào)用，僅供參考，建議使用更安全的 STS 方式。
        Client client = Sample.createClient(System.getenv("ALIBABA_CLOUD_USER"),
                System.getenv("ALIBABA_CLOUD_PASSWORD"));
        try {
            // 復(fù)制代碼運(yùn)行請(qǐng)自行打印 API 的返回值
            client.getInstance("instanceId");
        } catch (TeaException error) {
            // 如有需要，請(qǐng)打印 error
            com.aliyun.teautil.Common.assertAsString(error.message);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            // 如有需要，請(qǐng)打印 error
            com.aliyun.teautil.Common.assertAsString(error.message);
        }
    }
}

返回結(jié)果示例：

{
  "RequestId": "1E8EFA1E-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "Instance": {
    "SuspendReason": "",
    "ZoneId": "cn-hangzhou-h",
    "InstanceId": "hgpostcn-cn-xxxxxxxxxxxx",
    "InstanceChargeType": "PostPaid",
    "Memory": 64,
    "InstanceOwner": "123xxxxxxxxxxxx",
    "ColdStorage": 0,
    "Cpu": 16,
    "EnableHiveAccess": false,
    "InstanceName": "xxxx",
    "ComputeNodeCount": 1,
    "Endpoints": [
      {
        "Type": "Intranet",
        "Endpoint": "hgpostcn-cn-xxxxxxxxxxxx-cn-hangzhou-internal.hologres.aliyuncs.com:80",
        "Enabled": true
      },
      {
        "Type": "VPCSingleTunnel",
        "Endpoint": "hgpostcn-cn-xxxxxxxxxxxx-cn-hangzhou-vpc-st.hologres.aliyuncs.com:80",
        "VpcId": "vpc-xxxxxxxxxxxxxxxx",
        "VSwitchId": "vsw-xxxxxxxxxxxxxxxx",
        "Enabled": true,
        "VpcInstanceId": "hgpostcn-cn-xxxxxxxxxxxx-frontend-st"
      }
    ],
    "AutoRenewal": false,
    "Version": "r1.3.43",
    "InstanceStatus": "Running",
    "CommodityCode": "hologram_postpay_public_cn",
    "CreationTime": "2023-04-12T03:41:59.036Z",
    "InstanceType": "Standard",
    "Disk": 0,
    "Tags": [
      {
        "Value": "rg-xxxxxxxxxxxx",
        "Key": "acs:rm:rgId"
      }
    ]
  },
  "HttpStatusCode": 200,
  "Success": true
}