SDK Azure pour JS

Kit de développement logiciel Azure pour JavaScript

Ce référentiel est destiné au SDK Azure pour JavaScript (Node.js et navigateur). Il contient des bibliothèques pour l’ensemble des services Azure. Les bibliothèques de gestion sont des packages que vous utiliserez pour provisionner et gérer des ressources Azure. Les bibliothèques clientes sont des packages que vous utiliseriez pour consommer ces ressources et interagir avec elles.

Commencer

Voici quelques ressources utiles pour commencer :

• Le fichier Lisez-moi de chaque package contient des exemples de code et des informations sur le package. Ce fichier readme se trouve dans le dossier du package correspondant sous le dossier du service de votre choix dans le dossier /sdk de ce référentiel. Le même fichier Lisez-moi se trouve sur la page de destination du package dans npm.
• La documentation de référence de l'API des dernières versions de ces packages est disponible dans nos documents publics pour les développeurs.
• La documentation de référence de l'API des anciennes versions peut être trouvée dans nos documents de développement versionnés.

Chaque service peut disposer d'un certain nombre de bibliothèques disponibles dans chacune des catégories suivantes :

• Client
• Gestion

REMARQUE : Certains de ces packages ont des versions bêta. Si vous devez vous assurer que votre code est prêt pour la production, utilisez l'un des packages stables et non bêta.

Client

Étant donné qu’une ressource Azure existe déjà, vous utiliserez les bibliothèques clientes pour la consommer et interagir avec elle. La plupart de ces bibliothèques suivent les directives de conception du SDK Azure pour JavaScript et TypeScript et partagent un certain nombre de fonctionnalités de base telles que les tentatives, la journalisation, les protocoles de transport, les protocoles d'authentification, etc. D'autres seront mises à jour dans un avenir proche pour suivre également les directives.

Pour obtenir une liste de toutes les bibliothèques clientes qui suivent les nouvelles directives, veuillez visiter notre page des versions du SDK Azure.

Gestion

Les bibliothèques de gestion vous permettent de provisionner et de gérer des ressources Azure via Azure Resource Manager, c'est-à-dire ARM. Vous pouvez reconnaître ces bibliothèques par @azure/arm- dans leurs noms de packages. Ceux-ci sont purement générés automatiquement sur la base des fichiers swagger qui représentent les API de gestion des ressources.

Les versions plus récentes de ces bibliothèques suivent les directives de conception du SDK Azure pour TypeScript. Ces nouvelles versions offrent un certain nombre de fonctionnalités de base partagées par tous les SDK Azure, notamment la bibliothèque intuitive Azure Identity, un pipeline HTTP avec des stratégies personnalisées, la gestion des erreurs, le traçage distribué et bien plus encore. Voici quelques ressources utiles pour commencer :

• Liste des bibliothèques de gestion qui suivent les nouvelles directives
• Documentation et exemples de code.
• Guide de migration qui montre comment effectuer la transition à partir d'anciennes versions de bibliothèques.

REMARQUE : Si vous rencontrez des problèmes d'authentification avec les bibliothèques de gestion après la mise à niveau de certains packages, il est possible que vous ayez mis à niveau vers les nouvelles versions du SDK sans modifier le code d'authentification. Veuillez vous référer au guide de migration mentionné ci-dessus pour obtenir des instructions appropriées.

Besoin d'aide ?

• Pour une documentation détaillée, visitez notre documentation Azure SDK pour JavaScript.
• Signaler un problème via GitHub Issues
• Vérifiez les questions précédentes ou posez-en de nouvelles sur StackOverflow à l'aide de la balise azure-sdk-js .
• Lisez notre documentation d'assistance.

Communauté

Essayez nos ressources communautaires.

Signaler des problèmes de sécurité et des bugs de sécurité

Les problèmes de sécurité et les bogues doivent être signalés en privé, par courrier électronique, au Microsoft Security Response Center (MSRC) [email protected]. Vous devriez recevoir une réponse dans les 24 heures. Si, pour une raison quelconque, vous ne le faites pas, veuillez effectuer un suivi par e-mail pour vous assurer que nous avons bien reçu votre message original. De plus amples informations, y compris la clé MSRC PGP, peuvent être trouvées dans le Security TechCenter.

Contribuer

Pour plus de détails sur la contribution à ce référentiel, consultez le guide de contribution.

Ce projet accueille les contributions et suggestions. La plupart des contributions nécessitent que vous acceptiez un contrat de licence de contributeur (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez effectivement, le droit d'utiliser votre contribution. Pour plus de détails, visitez https://cla.microsoft.com.

Lorsque vous soumettez une pull request, un robot CLA déterminera automatiquement si vous devez fournir un CLA et décorera le PR de manière appropriée (par exemple, étiquette, commentaire). Suivez simplement les instructions fournies par le bot. Vous n’aurez besoin de le faire qu’une seule fois sur tous les référentiels utilisant notre CLA.

Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez la FAQ sur le code de conduite ou contactez [email protected] pour toute question ou commentaire supplémentaire.