Azure ContainerAppsAPI client library for JavaScript - versie 4.0.0

Dit pakket bevat een isomorfe SDK (draait zowel in Node.js als in browsers) voor Azure ContainerAppsAPI-client.

Functions is een extensieresource voor revisies en de vermelde API wordt gebruikt om de aanroep van web-RP te proxyen naar het hostproces van de functie-app. Deze API wordt niet blootgesteld aan gebruikers en alleen web-RP is toegestaan om de resource van de functie-extensie aan te roepen.

Sleutelkoppelingen:

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Vereiste voorwaarden

Het @azure/arm-appcontainers-pakket installeren

Installeer de Azure ContainerAppsAPI clientbibliotheek voor JavaScript met npm:

npm install @azure/arm-appcontainers

Een ContainerAppsAPIClient maken en verifiëren

Om een clientobject te maken dat toegang krijgt tot de Azure ContainerAppsAPI API, heb je de endpoint van je Azure ContainerAppsAPI-resource en een credential nodig. De Azure ContainerAppsAPI-client kan Azure Active Directory-credentials gebruiken om te authenticeren. Je kunt het eindpunt voor je Azure ContainerAppsAPI-bron vinden in de Azure Portal.

U kunt verifiëren met Azure Active Directory met behulp van een referentie uit de @azure/identiteitsbibliotheek of een bestaand AAD-token.

Als u de DefaultAzureCredential-provider wilt gebruiken die hieronder wordt weergegeven, of andere referentieproviders die bij de Azure SDK zijn geleverd, installeert u het @azure/identity pakket:

npm install @azure/identity

Je moet ook een nieuwe AAD-applicatie registreren en toegang verlenen aan Azure ContainerAppsAPI door de geschikte rol toe te wijzen aan je serviceprincipal (opmerking: rollen zoals "Owner" geven niet de benodigde rechten).

Raadpleeg deze handleiding voor meer informatie over het maken van een Azure AD-toepassing.

Met Node.js- en Node-achtige omgevingen kunt u de DefaultAzureCredential-klasse gebruiken om de client te verifiëren.

import { ContainerAppsAPIClient } from "@azure/arm-appcontainers";
import { DefaultAzureCredential } from "@azure/identity";

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

Gebruik voor browseromgevingen de InteractiveBrowserCredential uit het @azure/identity-pakket om te verifiëren.

import { InteractiveBrowserCredential } from "@azure/identity";
import { ContainerAppsAPIClient } from "@azure/arm-appcontainers";

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

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze bundeldocumentatie voor meer informatie over hoe u dit doet.

Belangrijke concepten

ContainerAppsAPIClient

ContainerAppsAPIClient is de primaire interface voor ontwikkelaars die de Azure ContainerAppsAPI clientbibliotheek gebruiken. Verken de methoden op dit clientobject om de verschillende functies van de Azure ContainerAppsAPI-service te begrijpen die je kunt gebruiken.

Probleemoplossingsproces

Loggen

Het inschakelen van logboekregistratie kan helpen nuttige informatie over fouten te ontdekken. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de omgevingsvariabele AZURE_LOG_LEVEL in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door setLogLevel aan te roepen in de @azure/logger:

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

setLogLevel("info");

Voor gedetailleerdere instructies over het inschakelen van logboeken, kunt u de documentatie over het @azure/logger-pakket bekijken.

Volgende stappen

Bekijk de map met voorbeelden voor gedetailleerde voorbeelden over het gebruik van deze bibliotheek.

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de gids voor bijdragen voor meer informatie over het bouwen en testen van de code.