Alibaba Cloud SDK：FAQ tentang Alibaba Cloud SDK untuk Node.js

Bagaimana cara menangani kesalahan AccessKey?

Masalah: Pesan kesalahan berikut muncul setelah menjalankan kode, menunjukkan bahwa pasangan AccessKey tidak dikonfigurasi dengan benar.

• Alibaba Cloud SDK V2.0 untuk Node.js: Tidak dapat membaca properti dari undefined (membaca 'getCredential').

• Alibaba Cloud SDK V1.0 untuk Node.js: AssertionError [ERR_ASSERTION]: harus melewati "config.accessKeyId".

Solusi:

1. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah dikonfigurasi.

   Linux/macOS

   echo $ALIBABA_CLOUD_ACCESS_KEY_ID
   echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

   Windows

   echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
   echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

   Jika pasangan AccessKey yang valid dikembalikan, variabel lingkungan telah dikonfigurasi dengan benar. Jika tidak ada pasangan AccessKey atau pasangan AccessKey yang tidak valid dikembalikan, konfigurasikan variabel lingkungan sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.

2. Periksa kesalahan terkait pasangan AccessKey dalam kode.

   Contoh permintaan kesalahan:

    let config = new OpenApi.Config({
         accessKeyId: process.env['yourAccessKeyID'],
         accessKeySecret: process.env['yourAccessKeySecret'],
       });

   Contoh permintaan sukses:

   let config = new OpenApi.Config({
         accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
         accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });

   Catatan

   process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'] dan process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET']

   menunjukkan bahwa ID AccessKey dan Rahasia AccessKey diperoleh dari variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET.

   Penting

   Untuk mencegah risiko keamanan, jangan tuliskan pasangan AccessKey dalam kode online.

Apa yang harus saya lakukan jika pesan kesalahan "tsc: Gagal mengenali perintah tsc sebagai nama cmdlet, fungsi, skrip, atau program yang dapat dieksekusi..." muncul setelah saya menjalankan perintah tsc?

Apa yang harus saya lakukan jika permintaan API kehabisan waktu dan pesan "Error: connect ETIMEDOUT" dikembalikan?

Penyebab umum dan solusi:

Timeout panggilan API dapat disebabkan oleh beberapa faktor. Bagian berikut menjelaskan penyebab umum dan solusi yang sesuai:

Penyebab 1: Masalah koneksi jaringan

Penyebab: Permintaan tidak dapat mencapai server karena koneksi jaringan antara klien dan server gagal atau jaringan tidak stabil.

Solusi:

Jalankan perintah ping atau curl untuk menguji konektivitas antara host lokal dan titik akhir layanan cloud. Sebagai contoh, jalankan perintah ping dysmsapi.aliyuncs.com atau curl -v https://dysmsapi.aliyuncs.com untuk menguji konektivitas antara host lokal Anda dan titik akhir API Layanan Pesan Singkat (SMS).

• Jika perintah kehabisan waktu atau tidak menerima respons, periksa kebijakan pemblokiran pada firewall atau router lokal Anda.

• Jika respons dikembalikan, kami sarankan Anda menentukan periode timeout yang tepat untuk mencegah kegagalan permintaan yang disebabkan oleh konfigurasi timeout yang tidak tepat. Untuk informasi lebih lanjut, lihat Konfigurasikan periode timeout. Contoh kode:

  JavaScript

  // Buat instance RuntimeOptions dan tentukan parameter runtime. 
      const runtime = new RuntimeOptions({
          // Konfigurasikan periode timeout untuk permintaan koneksi.
          connectTimeout: 10000,
      });

  TypeScript

  // Buat instance RuntimeOptions dan tentukan parameter runtime. 
          const runtime = new $Util.RuntimeOptions({
              // Konfigurasikan periode timeout untuk permintaan koneksi.
              connectTimeout: 10000,
          });

Penyebab 2: Waktu pemrosesan permintaan yang lama

Deskripsi: Durasi pemrosesan permintaan API melebihi periode timeout baca yang ditentukan.

Solusi: Konfigurasikan periode timeout untuk menyesuaikan dengan waktu respons API yang diperpanjang. Untuk informasi lebih lanjut, lihat Konfigurasikan periode timeout. Sebagai contoh, Anda dapat mengonfigurasi parameter timeout baca untuk memperpanjang periode timeout baca. Contoh kode:

// Buat instance RuntimeOptions dan tentukan parameter runtime. 
    const runtime = new RuntimeOptions({
        // Konfigurasikan periode timeout untuk permintaan baca.
        readTimeout: 10000,
    });

// Buat instance RuntimeOptions dan tentukan parameter runtime. 
        const runtime = new $Util.RuntimeOptions({
            // Konfigurasikan periode timeout untuk permintaan baca.
            readTimeout: 10000,
        });

Apa yang harus saya lakukan jika kesalahan "MissingRequiredParameter" dilaporkan saat saya memanggil operasi API?

Dalam contoh ini, operasi SendSms dari layanan Short Message Service (SMS) dipanggil.

• Masuk ke OpenAPI Explorer. Buka halaman debugging API dari layanan Alibaba Cloud yang ingin Anda panggil. Temukan operasi API yang ingin Anda panggil.

• Periksa apakah semua parameter yang diperlukan seperti phoneNumbers dan signName telah ditentukan dalam objek permintaan yang dibuat. Dalam contoh ini, objek SendSmsRequest digunakan.

• Verifikasi bahwa semua parameter yang diperlukan telah ditentukan berdasarkan referensi API.

• Pastikan nilai parameter yang diperlukan valid. Sebagai contoh, periksa apakah nomor ponsel ditentukan dalam format yang valid.

• Sebelum SDK mengirimkan permintaan API, SDK secara otomatis memverifikasi parameter. Jika satu atau lebih parameter yang diperlukan tidak ditentukan, kesalahan seperti MissingRequiredParameter dilaporkan. Sebagai contoh, jika parameter phoneNumbers tidak ditentukan, kesalahan "MissingPhoneNumbers: code: 400" dilaporkan. Dalam kasus ini, tentukan parameter berdasarkan pesan kesalahan.

let sendSmsRequest = new Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: '<YOUR_VALUE>',
      signName: '<YOUR_VALUE>',
      templateCode: '<YOUR_VALUE>',
    });

let sendSmsRequest = new $Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: "<YOUR_VALUE>",
      signName: "<YOUR_VALUE>",
      templateCode: "<YOUR_VALUE>",
    });

Apa yang harus saya lakukan jika gagal memanggil operasi API karena operasi tidak didukung di wilayah tertentu dan pesan "getaddrinfo ENOTFOUND" dikembalikan?

Pastikan wilayah yang Anda pilih mendukung layanan yang ingin Anda akses. Temukan titik akhir layanan di halaman produk di OpenAPI Explorer. Gambar berikut menunjukkan cara menemukan titik akhir layanan SMS.

Bagaimana cara menangani kesalahan yang dilaporkan oleh perintah npm install?

Pastikan Node.js dan npm telah diinstal dengan benar. Untuk informasi lebih lanjut, lihat Instal Node.js di Windows.

Bagaimana cara menyelesaikan konflik versi paket dependensi?

• Jalankan perintah npm ls untuk melihat pohon dependensi dan pastikan tidak ada konflik versi.

• Hapus direktori node_modules dan file package-lock.json dan instal ulang dependensi.

 rm -rf node_modules package-lock.json
 npm install