Partager via


Bibliothèque cliente Azure Atlas pour JavaScript - version 1.0.0

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 Atlas.

Key links:

Getting started

Environnements actuellement pris en charge

See our support policy for more details.

Prerequisites

Installer le package @azure/arm-mongodbatlas

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

npm install @azure/arm-mongodbatlas

Créer et authentifier un AtlasClient

Pour créer un objet client permettant d’accéder à l’API Azure Atlas, vous aurez besoin de la endpoint de votre ressource Azure Atlas et d’un credential. Le client Azure Atlas peut utiliser les informations d’identification Azure Active Directory pour s’authentifier. You can find the endpoint for your Azure Atlas 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 à Azure Atlas 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 { AtlasClient } from "@azure/arm-mongodbatlas";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AtlasClient(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 { AtlasClient } from "@azure/arm-mongodbatlas";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AtlasClient(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

AtlasClient

AtlasClient est l’interface principale pour les développeurs qui utilisent la bibliothèque cliente Azure Atlas. Explorez les méthodes de cet objet client pour comprendre les différentes fonctionnalités du service Azure Atlas 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.