Condividi tramite


Libreria client di Azure ApiManagement per JavaScript - versione 10.0.0

Questo pacchetto contiene un SDK isomorfico (eseguito sia in Node.js che nei browser) per il client Azure ApiManagement.

ApiManagement Client

documentazione di riferimentoapidel codice sorgente esempi

Come iniziare

Ambienti attualmente supportati

Per altri dettagli, vedere i criteri di supporto .

Prerequisiti

Installare il pacchetto @azure/arm-apimanagement

Installare la libreria client di Azure ApiManagement per JavaScript con npm:

npm install @azure/arm-apimanagement

Creare ed autenticare un ApiManagementClient

Per creare un oggetto client per accedere all'API ApiManagement di Azure, è necessario disporre endpoint della risorsa Azure ApiManagement e di un oggetto credential. Il client Azure ApiManagement può usare le credenziali di Azure Active Directory per l'autenticazione. È possibile trovare l'endpoint per la risorsa ApiManagement di Azure nel portale di Azure.

È possibile eseguire l'autenticazione con Azure Active Directory usando credenziali dalla libreria di di @azure/identità o un token AAD esistente.

Per usare il provider DefaultAzureCredential illustrato di seguito o altri provider di credenziali forniti con Azure SDK, installare il pacchetto :

npm install @azure/identity

Sarà anche necessario registrare una nuova applicazione AAD e concedere l'accesso ad Azure ApiManagement assegnando il ruolo appropriato all'entità servizio (si noti che i ruoli, "Owner" ad esempio, non concedono le autorizzazioni necessarie).

Per altre informazioni su come creare un'applicazione Azure AD, vedere questa guida.

Usando Node.js e ambienti simili a Node, è possibile usare la classe DefaultAzureCredential per autenticare il client.

import { ApiManagementClient } from "@azure/arm-apimanagement";
import { DefaultAzureCredential } from "@azure/identity";

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

Per gli ambienti del browser, usare il InteractiveBrowserCredential dal pacchetto di @azure/identity per l'autenticazione.

import { InteractiveBrowserCredential } from "@azure/identity";
import { ApiManagementClient } from "@azure/arm-apimanagement";

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

JavaScript Bundle

Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per informazioni dettagliate su come eseguire questa operazione, vedere la documentazione di creazione di bundle .

Concetti chiave

ApiManagementClient

ApiManagementClient è l'interfaccia principale per gli sviluppatori che usano la libreria client di Azure ApiManagement. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio Azure ApiManagement a cui è possibile accedere.

Risoluzione dei problemi

Registrazione

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la AZURE_LOG_LEVEL variabile di ambiente su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel in @azure/logger:

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

setLogLevel("info");

Per istruzioni più dettagliate su come abilitare i log, vedere la documentazione del pacchetto @azure/logger.

Passaggi successivi

Per esempi dettagliati su come usare questa libreria, vedere gli esempi di directory.

Contribuire

Per contribuire a questa libreria, leggere la guida per i contributi per altre informazioni su come compilare e testare il codice.