全部产品
Search
文档中心

OpenAPI Explorer:Gunakan Alibaba Cloud API Toolkit di VS Code

更新时间:Jun 30, 2025

Topik ini menjelaskan cara menginstal dan menggunakan ekstensi Alibaba Cloud API Toolkit di Visual Studio Code (VS Code).

Instalasi Alibaba Cloud API Toolkit

Prasyarat

VS Code telah terinstal.

Topik ini menjelaskan dua metode untuk menginstal Alibaba Cloud API Toolkit.

Metode 1: Unduh dan instal ekstensi dari Extensions

  1. Di bilah navigasi sisi kiri VS Code, klik ikon image.

  2. Cari Alibaba Cloud API Toolkit dan klik Install.

image

Metode 2: Unduh paket instalasi dari browser

  1. Kunjungi halaman Alibaba Cloud API Toolkit di Marketplace resmi VS Code melalui browser. Klik Install. Klien VS Code akan dipanggil dan halaman Alibaba Cloud API Toolkit muncul.

  2. Di halaman Alibaba Cloud API Toolkit di VS Code, klik Install.

image

Verifikasi instalasi

Setelah ekstensi terinstal, ikon Alibaba Cloud akan muncul di panel navigasi sisi kiri.image

Konfigurasi identitas pengguna dan kredensial

Anda harus mengonfigurasi identitas pengguna dan kredensial sebelum memanggil operasi API. Hanya pasangan AccessKey yang didukung sebagai kredensial untuk ekstensi ini. Ikuti prosedur berikut untuk mengonfigurasi identitas pengguna dan kredensial.

Tambah atau modifikasi konfigurasi identitas dan kredensial

  1. Instal ekstensi Alibaba Cloud CLI Tools.

    1. Kunjungi halaman Alibaba Cloud CLI Tools di browser dan klik Install.

    2. Di pesan yang muncul, klik Open.

    3. Di halaman Alibaba Cloud CLI Tools di VS Code, klik Install.

    4. Setelah ekstensi terinstal, ikon Alibaba Cloud akan muncul di panel navigasi sisi kiri.

    Catatan

    Anda juga dapat langsung menginstal Alibaba Cloud CLI Tools di VS Code. Untuk informasi lebih lanjut, lihat Gunakan ekstensi Alibaba Cloud CLI untuk VS Code.

  2. Konfigurasikan identitas dan kredensial.

    1. Di bilah navigasi atas VS Code, pilih Terminal > New Terminal.

    2. Jalankan perintah aliyun configure di terminal dan lengkapi konfigurasi sesuai petunjuk. Untuk informasi lebih lanjut tentang cara melihat pasangan AccessKey, lihat Lihat informasi tentang pasangan AccessKey Pengguna RAM.

    3. Tekan Enter setelah Anda mengonfigurasi setiap baris perintah. Jika Saving profile[xxx] ...Done. dikembalikan, profil disimpan. Jika !!! Configure Failed please configure again !!! dikembalikan, identitas dan kredensial gagal diverifikasi karena format parameter atau nilai tidak valid. Dalam hal ini, profil tetap disimpan.

      $ aliyun configure
      Mengonfigurasi profil 'default' ...
      Aliyun Access Key ID [None]: <Your AccessKey ID>
      Aliyun Access Key Secret [None]: <Your AccessKey Secret>
      Default Region Id [None]: cn-hangzhou
      Default output format [json]: json
      Default Language [zh]: zh
      Penting

      Akun Alibaba Cloud memiliki semua izin pada sumber daya. Jika pasangan AccessKey akun Alibaba Cloud Anda bocor, sumber daya Anda terpapar pada risiko besar. Kami menyarankan Anda menggunakan pasangan AccessKey Pengguna Resource Access Management (RAM).

Lihat dan ganti identitas pengguna

  1. Di bilah status di pojok kiri bawah, klik ikon Alibaba Cloud. Anda dapat melihat pengguna yang telah dikonfigurasi di kotak pencarian teratas.

  2. Klik nama profil untuk mengganti identitas pengguna.

Ikhtisar Alibaba Cloud API Toolkit

Alibaba Cloud API Toolkit adalah alat API ringan dari Alibaba Cloud. Anda dapat menggunakan Alibaba Cloud API Toolkit untuk dengan cepat menanyakan operasi API layanan Alibaba Cloud di VS Code. Anda juga dapat menggunakan ekstensi ini untuk men-debug operasi API, serta menghasilkan dan menyisipkan contoh kode SDK.

Berlangganan layanan Alibaba Cloud

Alibaba Cloud API Toolkit memungkinkan Anda berlangganan layanan Alibaba Cloud hanya dengan beberapa klik, mendukung versi API berbeda dari layanan Alibaba Cloud, dan memberikan rekomendasi versi yang direkomendasikan. Anda dapat menekan Ctrl+Cmd+K (Ctrl+Win+K di Windows) untuk mencari dan berlangganan layanan Alibaba Cloud tanpa perlu menggunakan file konfigurasi.

Pencarian API

Alibaba Cloud API Toolkit memungkinkan Anda mencari API yang telah Anda langgani. Anda dapat menekan Ctrl+Cmd+L (Ctrl+Win+L di Windows) untuk mencari dan melihat referensi API yang sesuai dengan API yang dilanggan. Anda juga dapat menyisipkan potongan kode.

Pratinjau referensi API

Anda dapat mengklik operasi API untuk membuka tab baru dan melihat referensi API yang sesuai di tab tersebut. Referensi API berisi informasi seperti catatan penggunaan, parameter permintaan, parameter respons, dan kode kesalahan.

Debugging API

  • Setelah identitas dan kredensial diverifikasi, Anda dapat menggunakan Alibaba Cloud API Toolkit untuk men-debug operasi API.

  • Anda dapat men-debug API Alibaba Cloud dengan mengonfigurasi parameter dan melihat hasil debugging.

  • Anda dapat langsung melihat hasil yang dikembalikan dari operasi API di VS Code.

Gunakan kode contoh

Catatan

Sebelum menggunakan kode contoh yang disediakan oleh Alibaba Cloud API Toolkit, Anda harus menginstal SDK layanan Alibaba Cloud.

Instal SDK layanan Alibaba Cloud

  1. Pergi ke SDK Center dan klik layanan Alibaba Cloud yang API-nya ingin Anda panggil. Di halaman yang muncul, atur parameter SDK Version ke V2.0 dan parameter All languages ke TypeScript. Dalam contoh ini, Elastic Compute Service (ECS) digunakan.

    npm install --save @alicloud/ecs20140526@4.1.8
  2. Jalankan perintah instalasi di terminal.

Hasilkan kode contoh SDK

  • Lihat kode contoh SDK

    Alibaba Cloud API Toolkit memungkinkan Anda menghasilkan SDK kode contoh. Anda dapat menghasilkan kode contoh SDK untuk berbagai bahasa pemrograman dengan mengonfigurasi parameter. Anda juga dapat melihat kode contoh SDK atau menyimpan kode contoh SDK sebagai file baru di VS Code.

  • Sisipkan potongan kode

    Alibaba Cloud API Toolkit memungkinkan Anda menyisipkan potongan kode contoh SDK untuk berbagai bahasa pemrograman hanya dengan beberapa klik. Bahasa pemrograman yang didukung termasuk Java, Java dalam mode asinkron, TypeScript, Python, Go, PHP, dan C#. Ini membantu Anda menghasilkan kode contoh SDK dengan mudah.

    • Metode 1: Masukkan operasi API yang telah Anda langgani di editor untuk mencari potongan kode operasi API tersebut.

    • Metode 2: Tekan Ctrl+Cmd+L (Ctrl+Win+L di Windows) untuk mencari operasi API dan menyisipkan potongan kode.

Lengkapi dan jalankan kode

  • Lengkapi kode

    • Modifikasi titik akhir.

      Masuk ke OpenAPI Explorer, arahkan pointer ke Cloud Products di bilah navigasi atas, lalu klik layanan Alibaba Cloud. Di tab Regions pada halaman yang muncul, Anda dapat melihat titik akhir yang didukung.

    • Tentukan parameter permintaan. Untuk informasi lebih lanjut, lihat bagian Pratinjau referensi API dari topik ini.

    • Opsional. Tambahkan logging.

    • Simpan kode.

      import OpenApi, * as $OpenApi from '@alicloud/openapi-client';
      import Ecs20140526, * as $Ecs20140526 from '@alicloud/ecs20140526';
      export default class DescribeRegion {
          static async main(args: string[]): Promise<void> {
              let config = new $OpenApi.Config({
                  // Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET dikonfigurasi di lingkungan runtime kode.
                  accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
                  accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
                  // Tentukan titik akhir. Untuk informasi lebih lanjut, lihat titik akhir di https://api.aliyun.com/product/Ecs.
                  endpoint: `ecs.cn-hangzhou.aliyuncs.com`,
              });
              let client = new Ecs20140526(config);
              let describeRegionsRequest = new $Ecs20140526.DescribeRegionsRequest({});
              let response = await client.describeRegions(describeRegionsRequest);
              console.log(response.body?.regions?.region);
          }
      }
  • Jalankan kode

    1. Jalankan perintah berikut di terminal untuk mengompilasi file TypeScript menjadi file JavaScript:

      tsc client.ts # client.ts adalah nama file.
    2. Buat file main.js dan salin kode berikut di bagian edit:

      const { default: Describeregion } = require("./describeregion");
      
      Describeregion.main();
      
    3. Jalankan perintah berikut di terminal untuk menjalankan kode contoh:

      node .\main.js
    4. Lihat hasilnya. Jika hasil yang ditampilkan pada gambar berikut dikembalikan, pemanggilan berhasil.

      image

Umpan Balik

Jika Anda memiliki pertanyaan saat menggunakan Alibaba Cloud API Toolkit, Anda dapat mengirimkan umpan balik di GitHub repository. Ini membantu meningkatkan pengalaman menggunakan Alibaba Cloud API Toolkit di VS Code.