Partager via


Bibliothèque cliente Azure PortalServices pour JavaScript - version 1.0.0-beta.1

Ce package contient un Kit de développement logiciel (SDK) isomorphe (exécuté à la fois dans Node.js et dans les navigateurs) pour le client Azure PortalServices.

Informations de référence sur l’API services du portail Azure

Liens clés :

Mise en route

Environnements actuellement pris en charge

Pour plus d’informations , consultez notre stratégie de support.

Conditions préalables

Installer le package @azure/arm-portalservicescopilot

Installez la bibliothèque cliente Azure PortalServices pour JavaScript avec npm:

npm install @azure/arm-portalservicescopilot

Créer et authentifier un PortalServicesClient

Pour créer un objet client pour accéder à l’API Azure PortalServices, vous aurez besoin de votre endpoint ressource Azure PortalServices et d’un credential. Le client Azure PortalServices peut utiliser les informations d’identification Azure Active Directory pour s’authentifier. Vous trouverez le point de terminaison de votre ressource Azure PortalServices dans le portail Azure.

Vous pouvez vous authentifier auprès d’Azure Active Directory à l’aide d’informations d’identification à partir de la bibliothèque de @azure/identité ou un jeton AAD existant.

Pour utiliser le fournisseur DefaultAzureCredential indiqué ci-dessous, ou d’autres fournisseurs d’informations d’identification fournis avec le Kit de développement logiciel (SDK) Azure, installez le @azure/identity package :

npm install @azure/identity

Vous devez également inscrire une nouvelle application AAD et accorder l’accès à Azure PortalServices en affectant le rôle approprié à votre principal de service (remarque : les rôles tels que "Owner" n’accorderont pas les autorisations nécessaires).

Pour plus d’informations sur la création d’une application Azure AD, consultez ce guide.

À l’aide de Node.js et d’environnements de type Nœud, vous pouvez utiliser la classe DefaultAzureCredential pour authentifier le client.

import { PortalServicesClient } from "@azure/arm-portalservicescopilot";
import { DefaultAzureCredential } from "@azure/identity";

const client = new PortalServicesClient(new DefaultAzureCredential());

Pour les environnements de navigateur, utilisez le InteractiveBrowserCredential à partir du package @azure/identity pour l’authentification.

import { InteractiveBrowserCredential } from "@azure/identity";
import { PortalServicesClient } from "@azure/arm-portalservicescopilot";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>"
 });
const client = new PortalServicesClient(credential);

JavaScript Bundle

Pour utiliser cette bibliothèque cliente dans le navigateur, vous devez d’abord utiliser un bundler. Pour plus d’informations sur la procédure à suivre, reportez-vous à notre documentation de regroupement.

Concepts clés

PortalServicesClient

PortalServicesClient est l’interface principale pour les développeurs utilisant la bibliothèque cliente Azure PortalServices. Explorez les méthodes de cet objet client pour comprendre les différentes fonctionnalités du service Azure PortalServices auquel vous pouvez accéder.

Résolution des problèmes

Exploitation forestière

L’activation de la journalisation peut vous aider à découvrir des informations utiles sur les échecs. Pour afficher un journal des requêtes et réponses HTTP, définissez la variable AZURE_LOG_LEVELd’environnement info sur . Vous pouvez également activer la journalisation au moment de l’exécution setLogLevelen appelant @azure/logger :

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

setLogLevel("info");

Pour obtenir des instructions plus détaillées sur l’activation des journaux, vous pouvez consulter la documentation du package @azure/enregistreur d’événements.

Étapes suivantes

Consultez les exemples répertoire pour obtenir des exemples détaillés sur l’utilisation de cette bibliothèque.

Contribuer

Si vous souhaitez contribuer à cette bibliothèque, lisez le guide de contribution pour en savoir plus sur la génération et le test du code.