Alibaba Cloud SDK：Gunakan Alibaba Cloud SDK untuk Node.js di IDE

Buka OpenAPI Explorer. Cari operasi API yang ingin digunakan. Contoh ini menggunakan operasi DescribeRegions dari Elastic Compute Service (ECS). Masukkan "DescribeRegions" di kotak pencarian dan klik nama operasi di hasil pencarian untuk membuka halaman debugging API.

Di tab Parameters di kolom tengah, tentukan parameter sesuai kebutuhan. Saat menentukan parameter, baca informasi di tab Document di kolom paling kanan. Pastikan Anda memahami catatan penggunaan operasi dan deskripsi setiap parameter. Perhatikan informasi terkait tagihan.

Operasi DescribeRegions mendukung tiga parameter permintaan dalam contoh ini.

Di tab SDK Sample Code di kolom paling kanan, pilih bahasa pemrograman dan klik Download Project untuk mengunduh proyek SDK lengkap ke komputer Anda. Ekstrak paket tersebut.

Buka VS Code, pilih File > Open Folder di bilah navigasi atas, lalu pilih folder yang telah diekstrak.

Di bilah navigasi atas, pilih Terminal > New Terminal. Jendela TERMINAL akan muncul di bagian bawah konsol.

Jalankan perintah berikut di terminal untuk menginstal TypeScript:

 npm install -g typescript

Jalankan perintah berikut di terminal untuk membaca file package.json, mem-parsing semua dependensi yang terdaftar, dan mengunduhnya ke direktori node_modules proyek.

npm install

Jalankan perintah berikut di terminal untuk mengkompilasi file TypeScript .ts menjadi file JavaScript .js berdasarkan file konfigurasi tsconfig.json. File JavaScript biasanya disimpan di direktori output seperti dist untuk pelaksanaan atau penyebaran selanjutnya.

tsc

Jalankan perintah berikut di terminal untuk menjalankan kode sampel:

node ./dist/client.js

Lihat hasilnya. Klik di mana saja di terminal dan tekan Ctrl+F untuk mencari statusCode. Jika "statusCode":200 ditampilkan, panggilan berhasil.

Buka VS Code. Di bilah navigasi atas, pilih File > Open Folder. Buat dan pilih folder proyek baru atau pilih folder proyek yang sudah ada. Contoh ini menggunakan folder bernama tssdkproject.

Di bilah navigasi atas, pilih Terminal > New Terminal. Jendela TERMINAL akan muncul di bagian bawah konsol.

Dapatkan SDK.

Kunjungi SDK Center dan pilih layanan cloud yang SDK-nya ingin digunakan. Contoh ini menggunakan ECS. Pilih V2.0 sebagai versi SDK dan TypeScript sebagai bahasa pemrograman.

Instal SDK.

Salin perintah instalasi ke terminal dan tekan tombol Enter.

Buat file. Klik ikon New File... di sebelah kanan nama proyek dan masukkan nama file seperti ecsDescribeRegions.js.

Inisialisasi klien.

Untuk memanggil API ECS, inisialisasi klien ECS terlebih dahulu.

// Impor klien ECS dan klien API.
const ecs20140526 = require('@alicloud/ecs20140526');
const openapiclient = require('@alicloud/openapi-client');

/**
 * Inisialisasi konfigurasi klien ECS.
 * Gunakan AccessKey ID dan AccessKey secret yang dikonfigurasi di variabel lingkungan untuk menyelesaikan verifikasi identitas dan atur titik akhir ke ecs.cn-hangzhou.aliyuncs.com.
 */
const ecsconfig = new openapiclient.Config();
ecsconfig.accessKeyId = process.env.ALIBABA_CLOUD_ACCESS_KEY_ID; // Dapatkan AccessKey ID dari variabel lingkungan.
ecsconfig.accessKeySecret = process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET; // Dapatkan AccessKey secret dari variabel lingkungan.
ecsconfig.endpoint = 'ecs.cn-hangzhou.aliyuncs.com'; // Tentukan titik akhir ECS.

// Buat instance klien untuk API ECS versi 20140526.
const ecs20140526client = new ecs20140526.default(ecsconfig);

Panggil operasi API. Sebelum memanggil operasi API, baca Dokumentasi API yang sesuai. Contoh ini menggunakan operasi DescribeRegions dari ECS.

// Impor klien ECS dan klien API.
const ecs20140526 = require('@alicloud/ecs20140526');
const openapiclient = require('@alicloud/openapi-client');

/**
 * Inisialisasi konfigurasi klien ECS.
 * Gunakan AccessKey ID dan AccessKey secret yang dikonfigurasi di variabel lingkungan untuk menyelesaikan verifikasi identitas dan atur titik akhir ke ecs.cn-hangzhou.aliyuncs.com.
 */
const ecsconfig = new openapiclient.Config();
ecsconfig.accessKeyId = process.env.ALIBABA_CLOUD_ACCESS_KEY_ID; // Dapatkan AccessKey ID dari variabel lingkungan.
ecsconfig.accessKeySecret = process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET; // Dapatkan AccessKey secret dari variabel lingkungan.
ecsconfig.endpoint = 'ecs.cn-hangzhou.aliyuncs.com'; // Tentukan titik akhir ECS.

// Buat instance klien untuk API ECS versi 20140526.
const ecs20140526client = new ecs20140526.default(ecsconfig);
const describeRegionsRequest = new ecs20140526.DescribeRegionsRequest();
// Ajukan permintaan untuk menanyakan wilayah yang tersedia.
ecs20140526client.describeRegions(describeRegionsRequest).then((res)=>{
    console.log(res);
})

Tangani pengecualian.

Di SDK V2.0 untuk Node.js, pengecualian dibagi menjadi dua jenis: pengecualian yang disebabkan oleh kesalahan bisnis dan pengecualian yang disebabkan oleh masalah jaringan. Pengecualian yang disebabkan oleh masalah jaringan dilempar jika jumlah percobaan ulang mencapai batas maksimum. Modul pengecualian eksternal yang relevan tidak tersedia untuk kedua jenis pengecualian. Oleh karena itu, kedua jenis pengecualian tidak dibedakan dalam kode sampel berikut.

// Impor klien ECS dan klien API.
const ecs20140526 = require('@alicloud/ecs20140526');
const openapiclient = require('@alicloud/openapi-client');

/**
 * Inisialisasi konfigurasi klien ECS.
 * Gunakan AccessKey ID dan AccessKey secret yang dikonfigurasi di variabel lingkungan untuk menyelesaikan verifikasi identitas dan atur titik akhir ke ecs.cn-hangzhou.aliyuncs.com.
 */
const ecsconfig = new openapiclient.Config();
ecsconfig.accessKeyId = process.env.ALIBABA_CLOUD_ACCESS_KEY_ID; // Dapatkan AccessKey ID dari variabel lingkungan.
ecsconfig.accessKeySecret = process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET; // Dapatkan AccessKey secret dari variabel lingkungan.
ecsconfig.endpoint = 'ecs.cn-hangzhou.aliyuncs.com'; // Tentukan titik akhir ECS.

// Buat instance klien untuk API ECS versi 20140526.
const ecs20140526client = new ecs20140526.default(ecsconfig);
const describeRegionsRequest = new ecs20140526.DescribeRegionsRequest();
// Ajukan permintaan untuk menanyakan wilayah yang tersedia.
ecs20140526client.describeRegions(describeRegionsRequest).then((res) => {
    console.log(res);
}).catch((err) => {
    console.log(err.message);
    throw err;
});

Jalankan demo SDK.

1. Jika Anda telah menginstal ekstensi Code Runner, klik kanan di mana saja di editor dan pilih Run Code.

   

2. Jalankan kode menggunakan perintah node di terminal. Contoh: node .\ecsDescribeRegions.js.

   

3. Pilih file yang ingin dijalankan seperti ecsDescribeRegions.js. Klik ikon Run and Debug di bilah navigasi kiri atau tekan Ctrl+Shift+D. Lalu, klik Run and Debug untuk menjalankan kode.

   

Opsional. Anda juga dapat menyalin kode sampel yang disediakan di OpenAPI Explorer ke file untuk menjalankan kode sampel. Untuk informasi lebih lanjut tentang cara mendapatkan kode sampel, lihat Pembuatan otomatis contoh SDK.