Node.js SDK Calling Example

Prerequisites

• You have obtained the access key (AK) and secret access key (SK) corresponding to your Huawei Cloud account. For details, see Creating Access Keys.
• Node.js 10.16.1 or later has been installed in the environment where the SDK runs.

Installing the SDK

Run the following command in the CLI to install the Huawei Cloud Node.js SDK: Node.js SDK 3.1.217 is used as an example. You can obtain the latest SDK version from SDK Center.

• Installing the SDK package of a single cloud service

  npm i @huaweicloud/huaweicloud-sdk-core@3.1.217
  npm i @huaweicloud/huaweicloud-sdk-kafka@3.1.217

• Installing the SDK package of a cloud service collection

  npm i @huaweicloud/huaweicloud-sdk-all@3.1.217

Using the SDK

The following is a complete Node.js example, which shows how to use the Huawei Cloud Node.js SDK to call the ListInstances API.

• To obtain the SDK example code for other APIs, see Obtaining SDK Sample Code.
• This example provides only the basic API parameter settings. For more advanced settings, see the user manual of the SDK.
• There will be huge security risks if the AK and SK used for authentication are directly written into the code. You are advised to encrypt the AK and SK and store them in the configuration file or set environment variables, and decrypt them when using them. In this example, the AK and SK are stored as the environment variables CLOUD_SDK_AK and CLOUD_SDK_SK. For details, see Environment Variables.

const core = require('@huaweicloud/huaweicloud-sdk-core');
const kafka = require("@huaweicloud/huaweicloud-sdk-kafka/v2/public-api");

// ==================== Initialize the client. ==================== 
// Obtain the AK/SK from the environment variables. Before running, you need to set the AK/SK as environment variables.
const ak = process.env.CLOUD_SDK_AK;
const sk = process.env.CLOUD_SDK_SK;
const endpoint = "https://dms.ap-southeast-1.myhuaweicloud.com";
const project_id = "195e********4a708ad9f9********1d";

// Configure an authentication credential.
const credentials = new core.BasicCredentials()
                     .withAk(ak)
                     .withSk(sk)
                     .withProjectId(project_id)

// Initialize the client.
const client = kafka.KafkaClient.newBuilder()
                            .withCredential(credentials)
                            .withEndpoint(endpoint)
                            .build();

// ==================== Construct a request object. ====================
// Use the request object provided by the SDK to encapsulate request parameters.
const request = new kafka.ListInstancesRequest();
request.engine = "kafka";

// ==================== Initiate a request and handle the response. ====================
// Use the client to call the corresponding API. The promise object is returned. If the API is successfully called, obtain the result through then. If the API fails to be called, catch the exception through catch.
const result = client.listInstances(request);
result.then(result => {
    console.log("JSON.stringify(result)::" + JSON.stringify(result));
}).catch(ex => {
    console.log("exception:" + JSON.stringify(ex));
});