Partager via


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

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

Deployments Client

Source code | Package (NPM) | API reference documentation | Samples

Getting started

Environnements actuellement pris en charge

See our support policy for more details.

Prerequisites

Installer le package @azure/arm-resourcesdeployments

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

npm install @azure/arm-resourcesdeployments

Créer et authentifier un DeploymentsClient

Pour créer un objet client permettant d’accéder à l’API Azure Deployments, vous aurez besoin de la endpoint de votre ressource Azure Deployments et d’un credential. Le client Azure Deployments peut utiliser les informations d’identification Azure Active Directory pour s’authentifier. You can find the endpoint for your Azure Deployments resource in the Azure Portal.

You can authenticate with Azure Active Directory using a credential from the @azure/identity library or an existing AAD Token.

To use the DefaultAzureCredential provider shown below, or other credential providers provided with the Azure SDK, please install the @azure/identity package:

npm install @azure/identity

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

For more information about how to create an Azure AD Application check out this guide.

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

import { DeploymentsClient } from "@azure/arm-resourcesdeployments";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { DeploymentsClient } from "@azure/arm-resourcesdeployments";

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

JavaScript Bundle

Pour utiliser cette bibliothèque cliente dans le navigateur, vous devez d’abord utiliser un bundler. For details on how to do this, please refer to our bundling documentation.

Key concepts

DeploymentsClient

DeploymentsClient est l’interface principale pour les développeurs qui utilisent la bibliothèque cliente Azure Deployments. Explorez les méthodes de cet objet client pour comprendre les différentes fonctionnalités du service Azure Deployments auxquelles vous pouvez accéder.

Troubleshooting

Logging

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 d’environnement AZURE_LOG_LEVEL sur info. Vous pouvez également activer la journalisation au moment de l’exécution en appelant setLogLevel dans la @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 documentationdu package @azure/enregistreur d’événements.

Next steps

Please take a look at the samples directory for detailed examples on how to use this library.

Contributing

If you'd like to contribute to this library, please read the contributing guide to learn more about how to build and test the code.