Le guide de API référence AWS SDK for JavaScript V3 décrit en détail toutes les API opérations de la AWS SDK for JavaScript version 3 (V3).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Qu'est-ce que c'est AWS SDK for JavaScript ?
Bienvenue dans le guide du AWS SDK for JavaScript développeur. Ce guide fournit des informations générales sur l'installation et la configuration du AWS SDK for JavaScript. Il vous présente également des exemples et un didacticiel d'exécution de divers AWS services à l'aide du AWS SDK for JavaScript.
Le guide de référence de l'API AWS SDK for JavaScript v3 fournit une JavaScript API pour les AWS
services. Vous pouvez utiliser l' JavaScript API pour créer des bibliothèques ou des applications pour Node.js
Commencez avec le SDK
Si vous êtes prêt à vous familiariser avec le SDK, suivez les exemples présentés surCommencez avec le AWS SDK for JavaScript.
Pour configurer votre environnement de développement, consultezConfigurer le SDK pour JavaScript.
Si vous utilisez actuellement la version 2.x du SDK pour JavaScript, consultez Migrer vers la version 3 pour obtenir des conseils spécifiques.
Si vous recherchez des exemples de code pour Services AWS, consultezSDKpour des JavaScript exemples de code (v3).
Maintenance et prise en charge des versions majeures du SDK
Pour en savoir plus sur la maintenance et la prise en charge des versions majeures du SDK et de leurs dépendances sous-jacentes, consultez la section suivante dans le AWS Guide de référence des kits SDK et des outils :
Utilisation du kit SDK avec Node.js
Node.js est un environnement d'exécution multiplateforme permettant d'exécuter des applications côté serveur JavaScript . Vous pouvez configurer Node.js sur une instance Amazon Elastic Compute Cloud (Amazon EC2) pour qu'elle s'exécute sur un serveur. Vous pouvez également utiliser Node.js pour écrire des AWS Lambda fonctions à la demande.
L'utilisation du SDK pour Node.js est différente de la manière dont vous l'utilisez JavaScript dans un navigateur Web. La différence provient de la façon dont vous chargez le kit SDK et dont vous récupérez les informations d'identification nécessaires à l'accès aux services web spécifiques. Lorsque l'utilisation d'API spécifiques diffère entre Node.js et le navigateur, nous signalons ces différences.
Utilisation du SDK avec AWS Cloud9
Vous pouvez également développer des applications Node.js à l'aide du SDK pour JavaScript l' AWS Cloud9 IDE. Pour plus d'informations sur AWS Cloud9 l'utilisation du SDK pour JavaScript, consultezÀ utiliser AWS Cloud9 avec AWS SDK for JavaScript.
Utilisation du SDK avec AWS Amplify
Pour les applications Web, mobiles et hybrides basées sur un navigateur, vous pouvez également utiliser la AWS Amplify bibliothèque
Note
Les frameworks tels qu'Amplify peuvent ne pas offrir le même support de navigateur que le SDK pour. JavaScript Consultez la documentation du framework pour plus de détails.
Utilisation du SDK avec des navigateurs Web
Tous les principaux navigateurs Web prennent en charge l'exécution de JavaScript. JavaScript le code qui s'exécute dans un navigateur Web est souvent appelé côté client JavaScript.
Pour obtenir la liste des navigateurs pris en charge par le AWS SDK for JavaScript, voirNavigateurs Web pris en charge.
L'utilisation du SDK pour JavaScript un navigateur Web est différente de la façon dont vous l'utilisez pour Node.js. La différence provient de la façon dont vous chargez le kit SDK et dont vous récupérez les informations d'identification nécessaires à l'accès aux services web spécifiques. Lorsque l'utilisation d'API spécifiques diffère entre Node.js et le navigateur, nous signalons ces différences.
Utilisation des navigateurs dans la V3
La version 3 vous permet de regrouper et d'inclure dans le navigateur uniquement le SDK pour les JavaScript fichiers dont vous avez besoin, ce qui réduit les frais généraux.
Pour utiliser la version 3 du SDK JavaScript dans vos pages HTML, vous devez regrouper les modules client requis et toutes les JavaScript fonctions requises dans un seul JavaScript fichier à l'aide de Webpack, et l'ajouter dans une balise <head> de script dans vos pages HTML. Par exemple :
<script src="./main.js"></script>
Note
Pour plus d'informations sur Webpack, consultezRegroupez des applications avec Webpack.
Pour utiliser la version 2 du SDK pour JavaScript, vous devez plutôt ajouter une balise de script pointant vers la dernière version du SDK V2. Pour plus d'informations, consultez l'exemple dans le Guide du AWS SDK for JavaScript développeur v2.
Cas d’utilisation courants
L'utilisation du SDK pour les scripts JavaScript intégrés au navigateur permet de réaliser un certain nombre de cas d'utilisation convaincants. Voici quelques idées de choses que vous pouvez intégrer dans une application de navigateur en utilisant le SDK pour accéder JavaScript à divers services Web.
-
Créez une console personnalisée pour les AWS services dans laquelle vous pouvez accéder aux fonctionnalités de différentes régions et services et les combiner afin de répondre au mieux aux besoins de votre organisation ou de votre projet.
-
Utilisez Amazon Cognito Identity pour permettre aux utilisateurs authentifiés d'accéder aux applications et aux sites Web de votre navigateur, notamment en utilisant l'authentification par un tiers via Facebook et d'autres.
-
Utilisez Amazon Kinesis pour traiter les flux de clics ou d'autres données marketing en temps réel.
-
Utilisez Amazon DynamoDB pour la persistance des données sans serveur, telles que les préférences individuelles des utilisateurs pour les visiteurs du site Web ou les utilisateurs d'applications.
-
AWS Lambda Utilisez-le pour encapsuler une logique propriétaire que vous pouvez invoquer à partir de scripts de navigateur sans télécharger ni révéler votre propriété intellectuelle aux utilisateurs.
À propos des exemples
Vous pouvez parcourir le SDK pour trouver des JavaScript exemples dans le référentiel d'exemples de AWS code
Ressources
Outre ce guide, les ressources en ligne suivantes sont disponibles pour le SDK pour JavaScript les développeurs :
-
AWS Guide de référence des SDK et des outils : contient des paramètres, des fonctionnalités et d'autres concepts fondamentaux communs aux SDK. AWS
-
GitHub
