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

Bagaimana cara menangani error AccessKey?

Masalah: Pesan error berikut dikembalikan setelah menjalankan kode, yang menunjukkan bahwa pasangan AccessKey tidak dikonfigurasi dengan benar.

• Alibaba Cloud SDK V2.0 untuk Node.js: Cannot read properties of undefined (reading 'getCredential').

• Alibaba Cloud SDK V1.0 untuk Node.js: AssertionError [ERR_ASSERTION]: must pass "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, berarti 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 selengkapnya, lihat Konfigurasi variabel lingkungan di Linux, macOS, dan Windows.

2. Periksa adanya error terkait pasangan AccessKey dalam kode.

   Contoh permintaan error:

    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

   Ekspresi process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'] dan process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'] mengambil nilai dari variabel lingkungan masing-masing.

   Penting

   Untuk mencegah risiko keamanan, jangan tulis pasangan AccessKey dalam kode yang digunakan di lingkungan produksi.

Apa yang harus saya lakukan jika pesan error "tsc: Fail to recognize the tsc command as the name of a cmdlet, a function, a script, or a executable program..." muncul setelah menjalankan perintah tsc?

PS C:\Users\issuser\Downloads\69351a7d-c9ef-417c-8986-a371cd208ece-TypeScript> tsc
tsc : The term 'tsc' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ tsc
+ ~~~
    + CategoryInfo          : ObjectNotFound: (tsc:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

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

Penyebab umum dan solusi:

Timeout panggilan API dapat disebabkan oleh berbagai 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 client dan server gagal atau jaringan tidak stabil.

Solusi:

Jalankan perintah ping atau curl untuk menguji konektivitas antara host lokal dan titik akhir layanan cloud. Misalnya, jalankan perintah ping dysmsapi.aliyuncs.com atau curl -v https://dysmsapi.aliyuncs.com untuk menguji konektivitas antara host lokal Anda dan titik akhir API Short Message Service (SMS).

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

• Jika respons dikembalikan, kami menyarankan Anda menentukan periode timeout yang sesuai untuk mencegah kegagalan permintaan akibat konfigurasi timeout yang tidak tepat. Untuk informasi selengkapnya, lihat Konfigurasi periode timeout. Contoh kode:

  JavaScript

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

  TypeScript

  // Buat instans RuntimeOptions dan tentukan parameter waktu proses. 
          const runtime = new $Util.RuntimeOptions({
              // Konfigurasi 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: Konfigurasi periode timeout agar sesuai dengan waktu respons API yang lebih lama. Untuk informasi selengkapnya, lihat Konfigurasi periode timeout. Misalnya, Anda dapat mengonfigurasi parameter timeout baca untuk memperpanjang periode timeout baca. Contoh kode:

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

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

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

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

• Buka halaman API Debugging di OpenAPI Explorer, lalu pilih produk dan API.

• 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. Misalnya, periksa apakah nomor ponsel menggunakan format yang valid.

• Sebelum SDK mengirim permintaan API, SDK secara otomatis memverifikasi parameter. Jika satu atau beberapa parameter yang diperlukan tidak ditentukan, error seperti MissingRequiredParameter akan dilaporkan. Misalnya, jika parameter phoneNumbers tidak ditentukan, error "MissingPhoneNumbers: code: 400" akan dilaporkan. Dalam kasus ini, tentukan parameter tersebut berdasarkan pesan error.

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 tersebut tidak didukung di wilayah tertentu dan pesan "getaddrinfo ENOTFOUND" dikembalikan?

Pastikan layanan yang Anda panggil tersedia di wilayah yang dipilih. Anda dapat menemukan titik akhir layanan yang benar di OpenAPI Explorer. Pastikan Anda menggunakan titik akhir yang benar.

Di bilah navigasi atas OpenAPI Explorer, pilih Short Message Service. Di halaman utama produk, buka tab Service area list. Format titik akhir adalah [product_code].[region_id].aliyuncs.com. Tabel tersebut mencantumkan setiap ID wilayah (seperti cn-beijing, cn-hangzhou, dan cn-shanghai) beserta titik akhir layanan yang sesuai (seperti dysmsapi.aliyuncs.com).

Bagaimana cara menangani error yang dilaporkan oleh perintah npm install?

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

Bagaimana cara menyelesaikan konflik versi paket dependensi?

• Jalankan perintah npm ls untuk melihat struktur dependensi dan pastikan tidak terjadi konflik versi.

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

 rm -rf node_modules package-lock.json
 npm install