Bagikan melalui


Pustaka klien Azure SearchManagement untuk JavaScript - versi 3.3.0

Paket ini berisi SDK isomorphic (berjalan baik di Node.js maupun di browser) untuk klien Azure SearchManagement.

Klien yang dapat digunakan untuk mengelola layanan Azure AI Search dan kunci API.

Kode | sumberPaket (NPM) | Dokumentasi | referensi APISampel

Getting started

Lingkungan yang didukung saat ini

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prerequisites

  • Sebuah langganan Azure.

Pasang paket @azure/arm-search

Instal pustaka klien Azure SearchManagement untuk JavaScript dengan npm:

npm install @azure/arm-search

Membuat dan mengautentikasi SearchManagementClient

Untuk membuat objek klien untuk mengakses Azure SearchManagement API, Anda memerlukan endpoint sumber daya Azure SearchManagement dan credential. Klien Azure SearchManagement dapat menggunakan kredensial Azure Active Directory untuk mengautentikasi. Anda dapat menemukan titik akhir untuk sumber daya Azure SearchManagement Anda di Portal Microsoft Azure.

Anda dapat mengautentikasi dengan Azure Active Directory menggunakan kredensial dari pustaka @azure/identitas atau Token AAD yang ada.

Untuk menggunakan penyedia DefaultAzureCredential yang ditunjukkan di bawah ini, atau penyedia kredensial lain yang disediakan dengan Azure SDK, instal @azure/identity paket:

npm install @azure/identity

Anda juga perlu mendaftarkan aplikasi AAD baru dan memberikan akses ke Azure SearchManagement dengan menetapkan peran yang sesuai ke perwakilan layanan Anda (catatan: peran seperti "Owner" tidak akan memberikan izin yang diperlukan).

Untuk informasi selengkapnya tentang cara membuat Aplikasi Azure Active Directory, lihat panduan ini.

Dengan menggunakan lingkungan Node.js dan seperti Node, Anda dapat menggunakan kelas DefaultAzureCredential untuk mengautentikasi klien.

import { SearchManagementClient } from "@azure/arm-search";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new SearchManagementClient(new DefaultAzureCredential(), subscriptionId);

Untuk lingkungan browser, gunakan InteractiveBrowserCredential dari paket @azure/identity untuk mengautentikasi.

import { InteractiveBrowserCredential } from "@azure/identity";
import { SearchManagementClient } from "@azure/arm-search";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new SearchManagementClient(credential, subscriptionId);

JavaScript Bundle

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukannya, silakan lihat dokumentasi bundling kami.

Key concepts

SearchManagementClient

SearchManagementClient adalah antarmuka utama untuk pengembang yang menggunakan pustaka klien Azure SearchManagement. Jelajahi metode pada objek klien ini untuk memahami berbagai fitur layanan Azure SearchManagement yang dapat Anda akses.

Troubleshooting

Logging

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Untuk instruksi lebih rinci tentang cara mengaktifkan log, Anda dapat melihat dokumen paket @azure/logger.

Next steps

Silakan lihat direktori sampel untuk contoh terperinci tentang cara menggunakan perpustakaan ini.

Contributing

Jika Anda ingin berkontribusi pada library ini, silakan baca panduan berkontribusi untuk mempelajari lebih lanjut tentang cara membuat dan menguji kode.