`. La hauteur de défilement de cet élément `

` sert à calculer jusqu'où un lecteur a déroulé le contenu qu'il lit. Le code HTML contient également une paire d'éléments ` ``` ## Configuration du kit SDK Obtenez les informations d'identification nécessaires pour configurer le SDK en appelant la `CognitoIdentityCredentials` méthode, en fournissant l'ID du pool d'identités Amazon Cognito. En cas de succès, créez l'objet de service Kinesis dans la fonction de rappel. L'extrait de code suivant illustre cette étape. (Pour obtenir l'exemple complet, consultez [Code de capture de la progression du défilement d'une page web](kinesis-examples-capturing-page-scrolling-full.md).) ``` // Configure Credentials to use Cognito AWS.config.credentials = new AWS.CognitoIdentityCredentials({ IdentityPoolId: "IDENTITY_POOL_ID", }); AWS.config.region = "REGION"; // We're going to partition Amazon Kinesis records based on an identity. // We need to get credentials first, then attach our event listeners. AWS.config.credentials.get(function (err) { // attach event listener if (err) { alert("Error retrieving credentials."); console.error(err); return; } // create Amazon Kinesis service object var kinesis = new AWS.Kinesis({ apiVersion: "2013-12-02", }); ``` ## Création des enregistrements de défilement La progression du défilement est calculée à l'aide des propriétés `scrollHeight` et `scrollTop` de l'élément `

` contenant le contenu du billet de blog. Chaque enregistrement de défilement est créé dans une fonction d'écoute d'événements pour l'`scroll`événement, puis ajouté à un tableau d'enregistrements pour être soumis périodiquement à Kinesis. L'extrait de code suivant illustre cette étape. (Pour obtenir l'exemple complet, consultez [Code de capture de la progression du défilement d'une page web](kinesis-examples-capturing-page-scrolling-full.md).) ``` // Get the ID of the Web page element. var blogContent = document.getElementById("BlogContent"); // Get Scrollable height var scrollableHeight = blogContent.clientHeight; var recordData = []; var TID = null; blogContent.addEventListener("scroll", function (event) { clearTimeout(TID); // Prevent creating a record while a user is actively scrolling TID = setTimeout(function () { // calculate percentage var scrollableElement = event.target; var scrollHeight = scrollableElement.scrollHeight; var scrollTop = scrollableElement.scrollTop; var scrollTopPercentage = Math.round((scrollTop / scrollHeight) * 100); var scrollBottomPercentage = Math.round( ((scrollTop + scrollableHeight) / scrollHeight) * 100 ); // Create the Amazon Kinesis record var record = { Data: JSON.stringify({ blog: window.location.href, scrollTopPercentage: scrollTopPercentage, scrollBottomPercentage: scrollBottomPercentage, time: new Date(), }), PartitionKey: "partition-" + AWS.config.credentials.identityId, }; recordData.push(record); }, 100); }); ``` ## Soumission d'enregistrements à Kinesis Une fois par seconde, s'il y a des enregistrements dans le tableau, ces enregistrements en attente sont envoyés à Kinesis. L'extrait de code suivant illustre cette étape. (Pour obtenir l'exemple complet, consultez [Code de capture de la progression du défilement d'une page web](kinesis-examples-capturing-page-scrolling-full.md).) ``` // upload data to Amazon Kinesis every second if data exists setInterval(function () { if (!recordData.length) { return; } // upload data to Amazon Kinesis kinesis.putRecords( { Records: recordData, StreamName: "NAME_OF_STREAM", }, function (err, data) { if (err) { console.error(err); } } ); // clear record data recordData = []; }, 1000); }); ``` # Code de capture de la progression du défilement d'une page web Voici le code du script de navigateur pour l'exemple de progression du défilement d'une page Web par capture Kinesis. ``` // Configure Credentials to use Cognito AWS.config.credentials = new AWS.CognitoIdentityCredentials({ IdentityPoolId: "IDENTITY_POOL_ID", }); AWS.config.region = "REGION"; // We're going to partition Amazon Kinesis records based on an identity. // We need to get credentials first, then attach our event listeners. AWS.config.credentials.get(function (err) { // attach event listener if (err) { alert("Error retrieving credentials."); console.error(err); return; } // create Amazon Kinesis service object var kinesis = new AWS.Kinesis({ apiVersion: "2013-12-02", }); // Get the ID of the Web page element. var blogContent = document.getElementById("BlogContent"); // Get Scrollable height var scrollableHeight = blogContent.clientHeight; var recordData = []; var TID = null; blogContent.addEventListener("scroll", function (event) { clearTimeout(TID); // Prevent creating a record while a user is actively scrolling TID = setTimeout(function () { // calculate percentage var scrollableElement = event.target; var scrollHeight = scrollableElement.scrollHeight; var scrollTop = scrollableElement.scrollTop; var scrollTopPercentage = Math.round((scrollTop / scrollHeight) * 100); var scrollBottomPercentage = Math.round( ((scrollTop + scrollableHeight) / scrollHeight) * 100 ); // Create the Amazon Kinesis record var record = { Data: JSON.stringify({ blog: window.location.href, scrollTopPercentage: scrollTopPercentage, scrollBottomPercentage: scrollBottomPercentage, time: new Date(), }), PartitionKey: "partition-" + AWS.config.credentials.identityId, }; recordData.push(record); }, 100); }); // upload data to Amazon Kinesis every second if data exists setInterval(function () { if (!recordData.length) { return; } // upload data to Amazon Kinesis kinesis.putRecords( { Records: recordData, StreamName: "NAME_OF_STREAM", }, function (err, data) { if (err) { console.error(err); } } ); // clear record data recordData = []; }, 1000); }); ``` # Exemples Amazon S3 Amazon Simple Storage Service (Amazon S3) est un service Web qui fournit un stockage dans le cloud hautement évolutif. Amazon S3 fournit un stockage d'objets facile à utiliser, avec une interface de service Web simple permettant de stocker et de récupérer n'importe quel volume de données, où que vous soyez sur le Web. ![\[Relation entre JavaScript les environnements, le SDK et Amazon S3\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/code-samples-s3.png) L' JavaScript API d'Amazon S3 est exposée par le biais de la classe `AWS.S3` client. Pour plus d'informations sur l'utilisation de la classe client Amazon S3, consultez [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html)la référence de l'API. **Topics** + [Exemples de navigateurs Amazon S3](s3-browser-examples.md) + [Exemples Node.js d'Amazon S3](s3-node-examples.md) # Exemples de navigateurs Amazon S3 Les rubriques suivantes présentent deux exemples de la manière dont le navigateur AWS SDK pour JavaScript peut être utilisé pour interagir avec les compartiments Amazon S3. + La première montre un scénario simple dans lequel les photos existantes dans un compartiment Amazon S3 peuvent être consultées par n'importe quel utilisateur (non authentifié). + La seconde montre un scénario plus complexe dans lequel les utilisateurs sont autorisés à effectuer des opérations sur les photos du bucket, telles que le téléchargement, la suppression, etc. **Topics** + [Affichage de photos dans un compartiment Amazon S3 à partir d'un navigateur](s3-example-photos-view.md) + [Téléchargement de photos vers Amazon S3 depuis un navigateur](s3-example-photo-album.md) # Affichage de photos dans un compartiment Amazon S3 à partir d'un navigateur ![\[JavaScript code example that applies to browser execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/browsericon.png) **Cet exemple de code de script de navigateur illustre :** + Comment créer un album photo dans un compartiment Amazon Simple Storage Service (Amazon S3) et autoriser les utilisateurs non authentifiés à voir les photos. ## Scénario Dans cet exemple, une simple page HTML fournit une application basée sur un navigateur pour afficher des photos dans un album photo. L'album photo se trouve dans un compartiment Amazon S3 dans lequel les photos sont téléchargées. ![\[JavaScript dans un script de navigateur utilisant des compartiments Amazon S3 pour les albums photos.\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/s3-photo-album-example.png) Le script de navigateur utilise le SDK JavaScript pour interagir avec un compartiment Amazon S3. Le script utilise la [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjects-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjects-property)méthode de la classe client Amazon S3 pour vous permettre de visualiser les albums photos. ## Tâches prérequises Pour configurer et exécuter cet exemple, réalisez tout d'abord les tâches ci-après. **Note** Dans cet exemple, vous devez utiliser la même AWS région pour le compartiment Amazon S3 et le pool d'identités Amazon Cognito. ### Créer le compartiment Dans la [console Amazon S3](https://console.aws.amazon.com/s3/), créez un compartiment Amazon S3 dans lequel vous pouvez stocker des albums et des photos. Pour plus d'informations sur l'utilisation de la console pour créer un compartiment S3, consultez la section [Création d'un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*. Lorsque vous créez le compartiment S3, veillez à : + Noter le nom du compartiment afin de pouvoir l'utiliser ultérieurement dans la tâche prérequise Configurer des autorisations de rôle. + Choisissez une AWS région dans laquelle créer le compartiment. Il doit s'agir de la même région que celle que vous utiliserez pour créer un pool d'identités Amazon Cognito lors d'une tâche préalable ultérieure, Créer un pool d'identités. + Configurez les autorisations du bucket en suivant la procédure de [définition des autorisations pour l'accès au site Web](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteAccessPermissionsReqd.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*. ### Créer un groupe d'identités Dans la [console Amazon Cognito](https://console.aws.amazon.com/cognito/), créez un pool d'identités Amazon Cognito, comme décrit [Étape 1 : créer un pool d'identités Amazon Cognito](getting-started-browser.md#getting-started-browser-create-identity-pool) dans *la rubrique Getting Started in a Browser Script*. Lorsque vous créez le pool d'identités, notez le nom du pool d'identités, ainsi que le nom du rôle de l'identité **non authentifiée.** ### Configurer les autorisations de rôle Pour autoriser l'affichage d'albums et de photos, vous devez ajouter des autorisations à un rôle IAM du pool d'identités que vous venez de créer. Commencez par créer une stratégie comme suit. 1. Ouvrez la [console IAM](https://console.aws.amazon.com/iam/). 1. Dans le volet de navigation de gauche, choisissez **Policies (Stratégies)**, puis le bouton **Create policy (Créer une stratégie)**. 1. Dans l'onglet **JSON**, entrez la définition JSON suivante en remplaçant *BUCKET\$1NAME* par le nom de votre compartiment. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::BUCKET_NAME" ] } ] } ``` ------ 1. Choisissez le bouton **Review policy (Vérifier la stratégie)**, nommez la stratégie et fournissez une description (si vous le souhaitez), puis choisissez le bouton **Create policy (Créer la stratégie)**. N'oubliez pas de noter le nom afin de pouvoir le retrouver et de l'associer ultérieurement au rôle IAM. Une fois la politique créée, revenez à la [console IAM.](https://console.aws.amazon.com/iam/) Recherchez le rôle IAM pour l'identité **non authentifiée** créée par Amazon Cognito dans la tâche préalable précédente, Créer un pool d'identités. Utilisez la stratégie que vous venez de créer pour ajouter des autorisations à cette identité. Bien que le flux de travail pour cette tâche soit généralement le même que celui de [Étape 2 : ajouter une politique au rôle IAM créé](getting-started-browser.md#getting-started-browser-iam-role) de la rubrique *Démarrage dans un script de navigateur*, quelques différences doivent être notées : + Utilisez la nouvelle politique que vous venez de créer, et non une politique pour Amazon Polly. + Sur la page **Attach Permissions (Attacher des autorisations)**, pour retrouver rapidement la nouvelle stratégie, ouvrez la liste **Filter policies (Filtrer les stratégies)** et choisissez **Customer managed (Gérées par l’utilisateur)**. Pour plus d'informations sur la création d'un rôle IAM, consultez la section [Création d'un rôle pour déléguer des autorisations à un AWS service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) dans le Guide de l'*utilisateur IAM*. ### Configurer CORS Avant que le script du navigateur puisse accéder au compartiment Amazon S3, vous devez configurer sa [configuration CORS](cors.md#configuring-cors-s3-bucket) comme suit. **Important** Dans la nouvelle console S3, la configuration CORS doit être de type JSON. ------ #### [ JSON ] ``` [ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "HEAD", "GET" ], "AllowedOrigins": [ "*" ] } ] ``` ------ #### [ XML ] ``` * GET HEAD * ``` ------ ### Créer des albums et charge des photos Cet exemple permettant uniquement aux utilisateurs d'afficher les photos qui sont déjà dans le compartiment, vous devez créer des albums dans le compartiment et y charger des photos. **Note** Dans cet exemple, les noms de fichier photo doivent commencer par un trait de soulignement (« \$1 ») unique. Ce caractère sera important ultérieurement pour le filtrage. Veillez également à respecter les droits d'auteur des propriétaires des photos. 1. Dans la [console Amazon S3](https://console.aws.amazon.com/s3/), ouvrez le compartiment que vous avez créé précédemment. 1. Dans l'onglet **Overview (Présentation)**, cliquez sur le bouton **Create folder (Créer un dossier)** pour créer des dossiers. Pour cet exemple, nommez les dossiers « album1 », « album2 » et « album3 ». 1. Pour **album1** puis **album2**, sélectionnez le dossier et chargez des photos comme suit : 1. Choisissez le bouton **Upload (Charger)**. 1. Faites glisser ou choisissez les fichiers photos que vous souhaitez utiliser, puis choisissez **Next (Suivant)**. 1. Sous **Manage public permissions Gérer les autorisations publiques)**, choisissez **Grant public read access to this object(s) (Octroyer un accès en lecture public à ces objets)**. 1. Choisissez le bouton **Upload (Charger)**(dans le coin inférieur gauche). 1. Laissez **album3** vide. ## Définition de la page Web Le code HTML pour l’application d’affichage de photos se compose d'un élément `

` dans lequel le script de navigateur crée l'interface d'affichage. Le premier élément `

Photo Album Viewer

``` ## Configuration du kit SDK Obtenez les informations d'identification dont vous avez besoin pour configurer le kit SDK en appelant la méthode `CognitoIdentityCredentials`. Vous devez fournir l'ID du pool d'identités Amazon Cognito. Ensuite, créez un objet de service `AWS.S3`. ``` // **DO THIS**: // Replace BUCKET_NAME with the bucket name. // var albumBucketName = "BUCKET_NAME"; // **DO THIS**: // Replace this block of code with the sample code located at: // Cognito -- Manage Identity Pools -- [identity_pool_name] -- Sample Code -- JavaScript // // Initialize the Amazon Cognito credentials provider AWS.config.region = "REGION"; // Region AWS.config.credentials = new AWS.CognitoIdentityCredentials({ IdentityPoolId: "IDENTITY_POOL_ID", }); // Create a new service object var s3 = new AWS.S3({ apiVersion: "2006-03-01", params: { Bucket: albumBucketName }, }); // A utility function to create HTML. function getHtml(template) { return template.join("\n"); } ``` Dans cet exemple, le reste du code définit les fonctions suivantes pour collecter et présenter des informations sur les albums et les photos du compartiment. + `listAlbums` + `viewAlbum` ## Liste des albums dans le compartiment Pour répertorier tous les albums existants dans le compartiment, la fonction `listAlbums` de l'application appelle la méthode `listObjects` de l'objet de service `AWS.S3`. La fonction utilise la propriété `CommonPrefixes` de sorte que l'appel renvoie uniquement les objets utilisés en tant qu’albums (c'est-à-dire, les dossiers). Le reste de la fonction prend la liste des albums du compartiment Amazon S3 et génère le code HTML nécessaire pour afficher la liste des albums sur la page Web. ``` // List the photo albums that exist in the bucket. function listAlbums() { s3.listObjects({ Delimiter: "/" }, function (err, data) { if (err) { return alert("There was an error listing your albums: " + err.message); } else { var albums = data.CommonPrefixes.map(function (commonPrefix) { var prefix = commonPrefix.Prefix; var albumName = decodeURIComponent(prefix.replace("/", "")); return getHtml([ "

", '", "

", ]); }); var message = albums.length ? getHtml(["

Click on an album name to view it.

"]) : "

You do not have any albums. Please Create album."; var htmlTemplate = [ "

Albums

", message, "

", getHtml(albums), "", ]; document.getElementById("viewer").innerHTML = getHtml(htmlTemplate); } }); } ``` ## Affichage d'un album Pour afficher le contenu d'un album dans le compartiment Amazon S3, la `viewAlbum` fonction de l'application prend un nom d'album et crée la clé Amazon S3 pour cet album. Ensuite, la fonction appelle la méthode `listObjects` de l'objet de service `AWS.S3` pour obtenir une liste de tous les objets (les photos) de l'album. Le reste de la fonction prend la liste des objets (photos) de l'album et génère le code HTML nécessaire à l'affichage des photos dans la page web. ``` // Show the photos that exist in an album. function viewAlbum(albumName) { var albumPhotosKey = encodeURIComponent(albumName) + "/"; s3.listObjects({ Prefix: albumPhotosKey }, function (err, data) { if (err) { return alert("There was an error viewing your album: " + err.message); } // 'this' references the AWS.Request instance that represents the response var href = this.request.httpRequest.endpoint.href; var bucketUrl = href + albumBucketName + "/"; var photos = data.Contents.map(function (photo) { var photoKey = photo.Key; var photoUrl = bucketUrl + encodeURIComponent(photoKey); return getHtml([ "", "

", "
", '

', "

", "

", "", photoKey.replace(albumPhotosKey, ""), "", "

", "", ]); }); var message = photos.length ? "

The following photos are present.

" : "

There are no photos in this album.

"; var htmlTemplate = [ "

", '", "

", "

", "Album: " + albumName, "

", message, "

", getHtml(photos), "

", "

", "End of Album: " + albumName, "

", "

", '", "

", ]; document.getElementById("viewer").innerHTML = getHtml(htmlTemplate); document .getElementsByTagName("img")[0] .setAttribute("style", "display:none;"); }); } ``` # Affichage de photos dans un compartiment Amazon S3 : code complet Cette section contient le code HTML complet et le JavaScript code de l'exemple dans lequel les photos d'un compartiment Amazon S3 peuvent être visualisées. Consultez la [section parente](s3-example-photos-view.md) pour plus de détails et les conditions préalables. Code HTML pour l'exemple : ```

Photo Album Viewer

``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_PhotoViewer.html). Code de script de navigateur pour l'exemple : ``` // // Data constructs and initialization. // // **DO THIS**: // Replace BUCKET_NAME with the bucket name. // var albumBucketName = "BUCKET_NAME"; // **DO THIS**: // Replace this block of code with the sample code located at: // Cognito -- Manage Identity Pools -- [identity_pool_name] -- Sample Code -- JavaScript // // Initialize the Amazon Cognito credentials provider AWS.config.region = "REGION"; // Region AWS.config.credentials = new AWS.CognitoIdentityCredentials({ IdentityPoolId: "IDENTITY_POOL_ID", }); // Create a new service object var s3 = new AWS.S3({ apiVersion: "2006-03-01", params: { Bucket: albumBucketName }, }); // A utility function to create HTML. function getHtml(template) { return template.join("\n"); } // // Functions // // List the photo albums that exist in the bucket. function listAlbums() { s3.listObjects({ Delimiter: "/" }, function (err, data) { if (err) { return alert("There was an error listing your albums: " + err.message); } else { var albums = data.CommonPrefixes.map(function (commonPrefix) { var prefix = commonPrefix.Prefix; var albumName = decodeURIComponent(prefix.replace("/", "")); return getHtml([ "

", '", "

", ]); }); var message = albums.length ? getHtml(["

Click on an album name to view it.

"]) : "

You do not have any albums. Please Create album."; var htmlTemplate = [ "

Albums

", message, "

", getHtml(albums), "", ]; document.getElementById("viewer").innerHTML = getHtml(htmlTemplate); } }); } // Show the photos that exist in an album. function viewAlbum(albumName) { var albumPhotosKey = encodeURIComponent(albumName) + "/"; s3.listObjects({ Prefix: albumPhotosKey }, function (err, data) { if (err) { return alert("There was an error viewing your album: " + err.message); } // 'this' references the AWS.Request instance that represents the response var href = this.request.httpRequest.endpoint.href; var bucketUrl = href + albumBucketName + "/"; var photos = data.Contents.map(function (photo) { var photoKey = photo.Key; var photoUrl = bucketUrl + encodeURIComponent(photoKey); return getHtml([ "", "

", "
", '

', "

", "

", "", photoKey.replace(albumPhotosKey, ""), "", "

", "", ]); }); var message = photos.length ? "

The following photos are present.

" : "

There are no photos in this album.

"; var htmlTemplate = [ "

", '", "

", "

", "Album: " + albumName, "

", message, "

", getHtml(photos), "

", "

", "End of Album: " + albumName, "

", "

", '", "

", ]; document.getElementById("viewer").innerHTML = getHtml(htmlTemplate); document .getElementsByTagName("img")[0] .setAttribute("style", "display:none;"); }); } ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_PhotoViewer.js). # Téléchargement de photos vers Amazon S3 depuis un navigateur ![\[JavaScript code example that applies to browser execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/browsericon.png) **Cet exemple de code de script de navigateur illustre :** + Comment créer une application de navigateur qui permet aux utilisateurs de créer des albums photos dans un compartiment Amazon S3 et de télécharger des photos dans les albums. ## Scénario Dans cet exemple, une simple page HTML fournit une application basée sur un navigateur pour créer des albums photos dans un compartiment Amazon S3 dans lequel vous pouvez télécharger des photos. L'application vous permet de supprimer les photos et les albums que vous ajoutez. ![\[JavaScript dans un script de navigateur utilisant des compartiments Amazon S3 pour les albums photos.\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/s3-photo-album-example.png) Le script de navigateur utilise le SDK JavaScript pour interagir avec un compartiment Amazon S3. Utilisez les méthodes suivantes de la classe client Amazon S3 pour activer l'application d'album photo : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjects-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjects-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#headObject-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#headObject-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putObject-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putObject-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#upload-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#upload-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteObject-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteObject-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteObjects-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteObjects-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Dans la [console Amazon S3](https://console.aws.amazon.com/s3/), créez un compartiment Amazon S3 que vous utiliserez pour stocker les photos de l'album. Pour plus d'informations sur la création d'un bucket dans la console, consultez [Creating a Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*. Veillez à disposer des autorisations **Read (Lecture)** et **Write (Écriture)** sur **Objets**. Pour plus d'informations sur la définition des autorisations de bucket, consultez la section [Configuration des autorisations pour l'accès au site Web](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteAccessPermissionsReqd.html). + Dans la [console Amazon Cognito](https://console.aws.amazon.com/cognito/), créez un pool d'identités Amazon Cognito à l'aide d'identités fédérées avec un accès activé pour les utilisateurs non authentifiés de la même région que le compartiment Amazon S3. Vous devez inclure l'ID du groupe d'identités dans le code afin d'obtenir les informations d'identification relatives au script du navigateur. *Pour plus d'informations sur les identités fédérées Amazon Cognito, consultez les [groupes d'identités Amazon Cognito (identités fédérées) dans le guide du développeur Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html).* + Dans la [console IAM, recherchez](https://console.aws.amazon.com/iam/) le rôle IAM créé par Amazon Cognito pour les utilisateurs non authentifiés. Ajoutez la politique suivante pour accorder des autorisations de lecture et d'écriture à un compartiment Amazon S3. Pour plus d'informations sur la création d'un rôle IAM, consultez la section [Création d'un rôle pour déléguer des autorisations à un AWS service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) dans le Guide de l'*utilisateur IAM*. Utilisez cette politique de rôle pour le rôle IAM créé par Amazon Cognito pour les utilisateurs non authentifiés. **Avertissement** Si vous activez l'accès pour des utilisateurs non authentifiés, vous accordez un accès total en écriture sur le compartiment et tous les objets du compartiment. Dans cet exemple, cette démarche liée à la sécurité est utile pour mettre l’accent sur les principaux objectifs. Cependant, dans de nombreuses situations réelles, une sécurité plus stricte, comme l'utilisation d'utilisateurs authentifiés et la propriété d'objet, est fortement recommandée. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:DeleteObject", "s3:GetObject", "s3:ListBucket", "s3:PutObject", "s3:PutObjectAcl" ], "Resource": [ "arn:aws:s3:::BUCKET_NAME", "arn:aws:s3:::BUCKET_NAME/*" ] } ] } ``` ------ ## Configuration de CORS Avant que le script du navigateur puisse accéder au compartiment Amazon S3, vous devez d'abord configurer sa [configuration CORS](cors.md#configuring-cors-s3-bucket) comme suit. **Important** Dans la nouvelle console S3, la configuration CORS doit être de type JSON. ------ #### [ JSON ] ``` [ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "HEAD", "GET", "PUT", "POST", "DELETE" ], "AllowedOrigins": [ "*" ], "ExposeHeaders": [ "ETag" ] } ] ``` ------ #### [ XML ] ``` * POST GET PUT DELETE HEAD * ETag ``` ------ ## La page web Le code HTML pour l'application de chargement de photos se compose d'un élément

dans lequel le script de navigateur crée l'interface utilisateur de chargement. Le premier élément

My Photo Albums App

``` ## Configuration du kit SDK Obtenez les informations d'identification nécessaires pour configurer le SDK en appelant la `CognitoIdentityCredentials` méthode, en fournissant l'ID du pool d'identités Amazon Cognito. Ensuite, créez un objet de service `AWS.S3`. ``` var albumBucketName = "BUCKET_NAME"; var bucketRegion = "REGION"; var IdentityPoolId = "IDENTITY_POOL_ID"; AWS.config.update({ region: bucketRegion, credentials: new AWS.CognitoIdentityCredentials({ IdentityPoolId: IdentityPoolId, }), }); var s3 = new AWS.S3({ apiVersion: "2006-03-01", params: { Bucket: albumBucketName }, }); ``` Dans cet exemple, presque tout le code restant est organisé en une série de fonctions qui rassemblent et présentent des informations sur les albums dans le compartiment, chargent et affichent les photos téléchargées dans les albums, et suppriment les photos et les albums. Ces fonctions sont : + `listAlbums` + `createAlbum` + `viewAlbum` + `addPhoto` + `deleteAlbum` + `deletePhoto` ## Liste des albums dans le compartiment L'application crée des albums dans le compartiment Amazon S3 sous forme d'objets dont les touches commencent par une barre oblique, indiquant que l'objet fonctionne comme un dossier. Pour répertorier tous les albums existants, la fonction `listAlbums` de l'application appelle la méthode `listObjects` de l'objet de service `AWS.S3` tout en utilisant `commonPrefix`, afin que l'appel retourne uniquement les objets utilisés en tant qu'albums. Le reste de la fonction prend la liste des albums du compartiment Amazon S3 et génère le code HTML nécessaire pour afficher la liste des albums sur la page Web. Cela permet également de supprimer et d'ouvrir des albums individuels. ``` function listAlbums() { s3.listObjects({ Delimiter: "/" }, function (err, data) { if (err) { return alert("There was an error listing your albums: " + err.message); } else { var albums = data.CommonPrefixes.map(function (commonPrefix) { var prefix = commonPrefix.Prefix; var albumName = decodeURIComponent(prefix.replace("/", "")); return getHtml([ "

", "X", "", albumName, "", "

", ]); }); var message = albums.length ? getHtml([ "

Click on an album name to view it.

", "

Click on the X to delete the album.

", ]) : "

You do not have any albums. Please Create album."; var htmlTemplate = [ "

Albums

", message, "

", getHtml(albums), "", "", ]; document.getElementById("app").innerHTML = getHtml(htmlTemplate); } }); } ``` ## Création d'un album dans le compartiment Pour créer un album dans le compartiment Amazon S3, la `createAlbum` fonction de l'application valide d'abord le nom donné au nouvel album afin de s'assurer qu'il contient les caractères appropriés. La fonction forme ensuite une clé d'objet Amazon S3, qu'elle transmet à la `headObject` méthode de l'objet de service Amazon S3. Cette méthode retourne les métadonnées pour la clé spécifiée, si bien que si elle retourne des données, cela signifie qu'un objet avec cette clé existe déjà. Si l'album n'existe pas déjà, la fonction appelle la méthode `putObject` de l'objet de service `AWS.S3` pour créer l'album. Ensuite, elle appelle la fonction `viewAlbum` pour afficher le nouvel album vide. ``` function createAlbum(albumName) { albumName = albumName.trim(); if (!albumName) { return alert("Album names must contain at least one non-space character."); } if (albumName.indexOf("/") !== -1) { return alert("Album names cannot contain slashes."); } var albumKey = encodeURIComponent(albumName); s3.headObject({ Key: albumKey }, function (err, data) { if (!err) { return alert("Album already exists."); } if (err.code !== "NotFound") { return alert("There was an error creating your album: " + err.message); } s3.putObject({ Key: albumKey }, function (err, data) { if (err) { return alert("There was an error creating your album: " + err.message); } alert("Successfully created album."); viewAlbum(albumName); }); }); } ``` ## Affichage d'un album Pour afficher le contenu d'un album dans le compartiment Amazon S3, la `viewAlbum` fonction de l'application prend un nom d'album et crée la clé Amazon S3 pour cet album. Ensuite, la fonction appelle la méthode `listObjects` de l'objet de service `AWS.S3` pour obtenir une liste de tous les objets (photos) de l'album. Le reste de la fonction prend la liste des objets (photos) de l'album et génère le code HTML nécessaire à l'affichage des photos dans la page web. Cela permet également de supprimer des photos individuelles et de revenir à la liste de l'album. ``` function viewAlbum(albumName) { var albumPhotosKey = encodeURIComponent(albumName) + "/"; s3.listObjects({ Prefix: albumPhotosKey }, function (err, data) { if (err) { return alert("There was an error viewing your album: " + err.message); } // 'this' references the AWS.Response instance that represents the response var href = this.request.httpRequest.endpoint.href; var bucketUrl = href + albumBucketName + "/"; var photos = data.Contents.map(function (photo) { var photoKey = photo.Key; var photoUrl = bucketUrl + encodeURIComponent(photoKey); return getHtml([ "", "

", '

', "

", "

", "", "X", "", "", photoKey.replace(albumPhotosKey, ""), "", "

", "", ]); }); var message = photos.length ? "

Click on the X to delete the photo

" : "

You do not have any photos in this album. Please add photos.

"; var htmlTemplate = [ "

", "Album: " + albumName, "

", message, "

", getHtml(photos), "

", '', '", '", ]; document.getElementById("app").innerHTML = getHtml(htmlTemplate); }); } ``` ## Ajout de photos à un album Pour télécharger une photo dans un album du compartiment Amazon S3, la `addPhoto` fonction de l'application utilise un élément de sélection de fichiers dans la page Web pour identifier le fichier à télécharger. Ensuite, elle forme une clé pour la photo à charger à partir du nom de l'album et du nom du fichier actuels. La fonction appelle la `upload` méthode de l'objet de service Amazon S3 pour télécharger la photo. Après avoir chargé la photo, la fonction affiche de nouveau l'album afin que la photo chargée apparaisse. ``` function addPhoto(albumName) { var files = document.getElementById("photoupload").files; if (!files.length) { return alert("Please choose a file to upload first."); } var file = files[0]; var fileName = file.name; var albumPhotosKey = encodeURIComponent(albumName) + "/"; var photoKey = albumPhotosKey + fileName; // Use S3 ManagedUpload class as it supports multipart uploads var upload = new AWS.S3.ManagedUpload({ params: { Bucket: albumBucketName, Key: photoKey, Body: file, }, }); var promise = upload.promise(); promise.then( function (data) { alert("Successfully uploaded photo."); viewAlbum(albumName); }, function (err) { return alert("There was an error uploading your photo: ", err.message); } ); } ``` ## Suppression d'une photo Pour supprimer une photo d'un album du compartiment Amazon S3, la `deletePhoto` fonction de l'application appelle la `deleteObject` méthode de l'objet de service Amazon S3. Cela supprime la photo spécifiée par la valeur `photoKey` transmise à la fonction. ``` function deletePhoto(albumName, photoKey) { s3.deleteObject({ Key: photoKey }, function (err, data) { if (err) { return alert("There was an error deleting your photo: ", err.message); } alert("Successfully deleted photo."); viewAlbum(albumName); }); } ``` ## Suppression d'un album Pour supprimer un album dans le compartiment Amazon S3, la `deleteAlbum` fonction de l'application appelle la `deleteObjects` méthode de l'objet de service Amazon S3. ``` function deleteAlbum(albumName) { var albumKey = encodeURIComponent(albumName) + "/"; s3.listObjects({ Prefix: albumKey }, function (err, data) { if (err) { return alert("There was an error deleting your album: ", err.message); } var objects = data.Contents.map(function (object) { return { Key: object.Key }; }); s3.deleteObjects( { Delete: { Objects: objects, Quiet: true }, }, function (err, data) { if (err) { return alert("There was an error deleting your album: ", err.message); } alert("Successfully deleted album."); listAlbums(); } ); }); } ``` # Téléchargement de photos sur Amazon S3 : code complet Cette section contient le code HTML complet et le JavaScript code de l'exemple dans lequel les photos sont chargées dans un album photo Amazon S3. Consultez la [section parente](s3-example-photo-album.md) pour plus de détails et les conditions préalables. Code HTML pour l'exemple : ```

My Photo Albums App

``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_photoExample.html). Code de script de navigateur pour l'exemple : ``` var albumBucketName = "BUCKET_NAME"; var bucketRegion = "REGION"; var IdentityPoolId = "IDENTITY_POOL_ID"; AWS.config.update({ region: bucketRegion, credentials: new AWS.CognitoIdentityCredentials({ IdentityPoolId: IdentityPoolId, }), }); var s3 = new AWS.S3({ apiVersion: "2006-03-01", params: { Bucket: albumBucketName }, }); function listAlbums() { s3.listObjects({ Delimiter: "/" }, function (err, data) { if (err) { return alert("There was an error listing your albums: " + err.message); } else { var albums = data.CommonPrefixes.map(function (commonPrefix) { var prefix = commonPrefix.Prefix; var albumName = decodeURIComponent(prefix.replace("/", "")); return getHtml([ "

", "X", "", albumName, "", "

", ]); }); var message = albums.length ? getHtml([ "

Click on an album name to view it.

", "

Click on the X to delete the album.

", ]) : "

You do not have any albums. Please Create album."; var htmlTemplate = [ "

Albums

", message, "

", getHtml(albums), "", "", ]; document.getElementById("app").innerHTML = getHtml(htmlTemplate); } }); } function createAlbum(albumName) { albumName = albumName.trim(); if (!albumName) { return alert("Album names must contain at least one non-space character."); } if (albumName.indexOf("/") !== -1) { return alert("Album names cannot contain slashes."); } var albumKey = encodeURIComponent(albumName); s3.headObject({ Key: albumKey }, function (err, data) { if (!err) { return alert("Album already exists."); } if (err.code !== "NotFound") { return alert("There was an error creating your album: " + err.message); } s3.putObject({ Key: albumKey }, function (err, data) { if (err) { return alert("There was an error creating your album: " + err.message); } alert("Successfully created album."); viewAlbum(albumName); }); }); } function viewAlbum(albumName) { var albumPhotosKey = encodeURIComponent(albumName) + "/"; s3.listObjects({ Prefix: albumPhotosKey }, function (err, data) { if (err) { return alert("There was an error viewing your album: " + err.message); } // 'this' references the AWS.Response instance that represents the response var href = this.request.httpRequest.endpoint.href; var bucketUrl = href + albumBucketName + "/"; var photos = data.Contents.map(function (photo) { var photoKey = photo.Key; var photoUrl = bucketUrl + encodeURIComponent(photoKey); return getHtml([ "", "

", '

', "

", "

", "", "X", "", "", photoKey.replace(albumPhotosKey, ""), "", "

", "", ]); }); var message = photos.length ? "

Click on the X to delete the photo

" : "

You do not have any photos in this album. Please add photos.

"; var htmlTemplate = [ "

", "Album: " + albumName, "

", message, "

", getHtml(photos), "

", '', '", '", ]; document.getElementById("app").innerHTML = getHtml(htmlTemplate); }); } function addPhoto(albumName) { var files = document.getElementById("photoupload").files; if (!files.length) { return alert("Please choose a file to upload first."); } var file = files[0]; var fileName = file.name; var albumPhotosKey = encodeURIComponent(albumName) + "/"; var photoKey = albumPhotosKey + fileName; // Use S3 ManagedUpload class as it supports multipart uploads var upload = new AWS.S3.ManagedUpload({ params: { Bucket: albumBucketName, Key: photoKey, Body: file, }, }); var promise = upload.promise(); promise.then( function (data) { alert("Successfully uploaded photo."); viewAlbum(albumName); }, function (err) { return alert("There was an error uploading your photo: ", err.message); } ); } function deletePhoto(albumName, photoKey) { s3.deleteObject({ Key: photoKey }, function (err, data) { if (err) { return alert("There was an error deleting your photo: ", err.message); } alert("Successfully deleted photo."); viewAlbum(albumName); }); } function deleteAlbum(albumName) { var albumKey = encodeURIComponent(albumName) + "/"; s3.listObjects({ Prefix: albumKey }, function (err, data) { if (err) { return alert("There was an error deleting your album: ", err.message); } var objects = data.Contents.map(function (object) { return { Key: object.Key }; }); s3.deleteObjects( { Delete: { Objects: objects, Quiet: true }, }, function (err, data) { if (err) { return alert("There was an error deleting your album: ", err.message); } alert("Successfully deleted album."); listAlbums(); } ); }); } ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_photoExample.js). # Exemples Node.js d'Amazon S3 Les rubriques suivantes présentent des exemples de la manière dont ils AWS SDK pour JavaScript peuvent être utilisés pour interagir avec les compartiments Amazon S3 à l'aide de Node.js. **Topics** + [Création et utilisation de compartiments Amazon S3](s3-example-creating-buckets.md) + [Configuration de compartiments Amazon S3](s3-example-configuring-buckets.md) + [Gestion des autorisations d’accès aux compartiments Amazon S3](s3-example-access-permissions.md) + [Utilisation de stratégies de compartiment Amazon S3](s3-example-bucket-policies.md) + [Utilisation d’un compartiment Amazon S3 en tant qu’hôte Web statique](s3-example-static-web-host.md) # Création et utilisation de compartiments Amazon S3 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment obtenir et afficher une liste des compartiments Amazon S3 dans votre compte. + Comment créer un compartiment Amazon S3. + Comment charger un objet dans un compartiment spécifié. ## Scénario Dans cet exemple, une série de modules Node.js sont utilisés pour obtenir une liste des compartiments Amazon S3 existants, créer un compartiment et charger un fichier dans un compartiment spécifié. Ces modules Node.js utilisent le SDK pour JavaScript obtenir des informations et télécharger des fichiers dans un compartiment Amazon S3 en utilisant les méthodes suivantes de la classe client Amazon S3 : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listBuckets-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listBuckets-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#createBucket-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#createBucket-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjects-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjects-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#upload-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#upload-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteBucket-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteBucket-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Configuration du kit SDK Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`. ``` // Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'}); ``` ## Afficher la liste des compartiments Amazon S3 Créez un module Node.js nommé `s3_listbuckets.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon Simple Storage Service, créez un objet `AWS.S3` de service. Appelez la `listBuckets` méthode de l'objet de service Amazon S3 pour récupérer la liste de vos buckets. Le paramètre `data` de la fonction de rappel dispose d'une propriété `Buckets` contenant un tableau de cartes pour représenter les compartiments. Affichez la liste des compartiments en la connectant à la console. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // Call S3 to list the buckets s3.listBuckets(function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.Buckets); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_listbuckets.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_listbuckets.js). ## Création d’un compartiment Amazon S3 Créez un module Node.js nommé `s3_createbucket.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Le module prend un seul argument de ligne de commande pour spécifier un nom pour le nouveau compartiment. Ajoutez une variable contenant les paramètres utilisés pour appeler la `createBucket` méthode de l'objet de service Amazon S3, y compris le nom du compartiment nouvellement créé. La fonction de rappel enregistre l'emplacement du nouveau compartiment sur la console une fois qu'Amazon S3 l'a créé avec succès. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // Create the parameters for calling createBucket var bucketParams = { Bucket: process.argv[2], }; // call S3 to create the bucket s3.createBucket(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.Location); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_createbucket.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_createbucket.js). ## Chargement d'un fichier dans un compartiment Amazon S3 Créez un module Node.js nommé `s3_upload.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Le module prend deux arguments de ligne de commande : le premier pour spécifier le compartiment de destination et le deuxième pour spécifier le fichier à charger. Créez une variable avec les paramètres nécessaires pour appeler la `upload` méthode de l'objet de service Amazon S3. Indiquez le nom du compartiment cible dans le paramètre `Bucket`. Le paramètre `Key` est défini sur le nom du fichier sélectionné que vous pouvez obtenir à l'aide du module `path` Node.js. Le paramètre `Body` est défini sur les contenus du fichier que vous pouvez obtenir à l'aide de `createReadStream` à partir du module `fs` Node.js. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object var s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // call S3 to retrieve upload file to specified bucket var uploadParams = { Bucket: process.argv[2], Key: "", Body: "" }; var file = process.argv[3]; // Configure the file stream and obtain the upload parameters var fs = require("fs"); var fileStream = fs.createReadStream(file); fileStream.on("error", function (err) { console.log("File Error", err); }); uploadParams.Body = fileStream; var path = require("path"); uploadParams.Key = path.basename(file); // call S3 to retrieve upload file to specified bucket s3.upload(uploadParams, function (err, data) { if (err) { console.log("Error", err); } if (data) { console.log("Upload Success", data.Location); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_upload.js BUCKET_NAME FILE_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_upload.js). ## Répertorier des objets dans un compartiment Amazon S3 Créez un module Node.js nommé `s3_listobjects.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Ajoutez une variable contenant les paramètres utilisés pour appeler la `listObjects` méthode de l'objet de service Amazon S3, y compris le nom du compartiment à lire. La fonction de rappel journalise une liste d'objets (fichiers) ou un message d'erreur. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // Create the parameters for calling listObjects var bucketParams = { Bucket: "BUCKET_NAME", }; // Call S3 to obtain a list of the objects in the bucket s3.listObjects(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_listobjects.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_listobjects.js). ## Supprimer un compartiment Amazon S3 Créez un module Node.js nommé `s3_deletebucket.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Ajoutez une variable contenant les paramètres utilisés pour appeler la `createBucket` méthode de l'objet de service Amazon S3, y compris le nom du compartiment à supprimer. Pour être supprimé, le compartiment doit être vide. La fonction de rappel journalise un message de réussite ou d'échec. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // Create params for S3.deleteBucket var bucketParams = { Bucket: "BUCKET_NAME", }; // Call S3 to delete the bucket s3.deleteBucket(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_deletebucket.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_deletebucket.js). # Configuration de compartiments Amazon S3 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment configurer les autorisations de partage des ressources cross-origine (CORS) d'un compartiment. ## Scénario Dans cet exemple, une série de modules Node.js est utilisée pour répertorier vos compartiments Amazon S3 et configurer le partage CORS ainsi que la journalisation des compartiments. Les modules Node.js utilisent le SDK pour configurer un compartiment Amazon S3 sélectionné JavaScript à l'aide des méthodes suivantes de la classe client Amazon S3 : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketCors-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketCors-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketCors-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketCors-property) Pour plus d'informations sur l'utilisation de la configuration CORS avec un compartiment Amazon S3, consultez [Cross-Origin Resource Sharing (CORS)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Configuration du kit SDK Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`. ``` // Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'}); ``` ## Extraction de la configuration CORS d'un compartiment Créez un module Node.js nommé `s3_getcors.js`. Le module prend un seul argument de ligne de commande pour spécifier le compartiment de la configuration CORS que vous souhaitez. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Le seul paramètre à passer est le nom du compartiment sélectionné lorsque vous appelez la méthode `getBucketCors`. Si le compartiment possède actuellement une configuration CORS, cette configuration est renvoyée par Amazon S3 en tant que `CORSRules` propriété du `data` paramètre transmis à la fonction de rappel. Si le compartiment sélectionné ne dispose pas de configuration CORS, ces informations sont retournées à la fonction de rappel dans le paramètre `error`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // Set the parameters for S3.getBucketCors var bucketParams = { Bucket: process.argv[2] }; // call S3 to retrieve CORS configuration for selected bucket s3.getBucketCors(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else if (data) { console.log("Success", JSON.stringify(data.CORSRules)); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_getcors.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_getcors.js). ## Définition d'une configuration CORS de compartiment Créez un module Node.js nommé `s3_setcors.js`. Le module prend plusieurs arguments de ligne de commande: le premier spécifie le compartiment de la configuration CORS que vous souhaitez définir. D'autres arguments énumèrent les méthodes HTTP (POST, GET, PUT, PATCH, DELETE, POST) que vous souhaitez autoriser pour le compartiment. Configurez le kit SDK comme illustré précédemment. Créez un objet de service `AWS.S3`. Ensuite, créez un objet JSON pour contenir les valeur de la configuration CORS selon les besoins de la méthode `putBucketCors` de l'objet de service `AWS.S3`. Spécifiez `"Authorization"` pour la valeur `AllowedHeaders` et `"*"` pour la valeur `AllowedOrigins`. Tout d'abord, définissez la valeur `AllowedMethods` comme un tableau vide. Spécifiez les méthodes autorisées comme paramètres de ligne de commande pour le module Node.js, en ajoutant chacune des méthodes correspondant à l'un des paramètres. Ajoutez la configuration CORS obtenue au tableau des configurations du paramètre `CORSRules`. Spécifiez le compartiment que vous souhaitez configurer pour CORS dans le paramètre `Bucket`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // Create initial parameters JSON for putBucketCors var thisConfig = { AllowedHeaders: ["Authorization"], AllowedMethods: [], AllowedOrigins: ["*"], ExposeHeaders: [], MaxAgeSeconds: 3000, }; // Assemble the list of allowed methods based on command line parameters var allowedMethods = []; process.argv.forEach(function (val, index, array) { if (val.toUpperCase() === "POST") { allowedMethods.push("POST"); } if (val.toUpperCase() === "GET") { allowedMethods.push("GET"); } if (val.toUpperCase() === "PUT") { allowedMethods.push("PUT"); } if (val.toUpperCase() === "PATCH") { allowedMethods.push("PATCH"); } if (val.toUpperCase() === "DELETE") { allowedMethods.push("DELETE"); } if (val.toUpperCase() === "HEAD") { allowedMethods.push("HEAD"); } }); // Copy the array of allowed methods into the config object thisConfig.AllowedMethods = allowedMethods; // Create array of configs then add the config object to it var corsRules = new Array(thisConfig); // Create CORS params var corsParams = { Bucket: process.argv[2], CORSConfiguration: { CORSRules: corsRules }, }; // set the new CORS configuration on the selected bucket s3.putBucketCors(corsParams, function (err, data) { if (err) { // display error message console.log("Error", err); } else { // update the displayed CORS config for the selected bucket console.log("Success", data); } }); ``` Pour exécuter l'exemple, saisissez la ligne de commande suivante, y compris une ou plusieurs méthodes HTTP comme illustré. ``` node s3_setcors.js BUCKET_NAME get put ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_setcors.js). # Gestion des autorisations d’accès aux compartiments Amazon S3 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment extraire ou définir la liste de contrôle d'accès pour un compartiment Amazon S3. ## Scénario Dans cet exemple, un module Node.js est utilisé pour afficher la liste de contrôle d'accès (ACL) de compartiment d'un compartiment sélectionné et appliquer les modifications à la liste de contrôle d'accès (ACL) pour un compartiment sélectionné. Le module Node.js utilise le SDK pour gérer les autorisations JavaScript d'accès aux compartiments Amazon S3 à l'aide des méthodes suivantes de la classe client Amazon S3 : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketAcl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketAcl-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketAcl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketAcl-property) Pour plus d'informations sur les listes de contrôle d'accès pour les compartiments Amazon S3, consultez [Managing Access with ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Configuration du kit SDK Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`. ``` // Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'}); ``` ## Extraction de la liste de contrôle d'accès du compartiment actuel Créez un module Node.js nommé `s3_getbucketacl.js`. Le module prend un seul argument de ligne de commande pour spécifier le compartiment de la configuration ACL que vous souhaitez. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Le seul paramètre à passer est le nom du compartiment sélectionné lorsque vous appelez la méthode `getBucketAcl`. La configuration actuelle de la liste de contrôle d'accès est renvoyée par Amazon S3 dans le `data` paramètre transmis à la fonction de rappel. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); var bucketParams = { Bucket: process.argv[2] }; // call S3 to retrieve policy for selected bucket s3.getBucketAcl(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else if (data) { console.log("Success", data.Grants); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_getbucketacl.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_getbucketacl.js). # Utilisation de stratégies de compartiment Amazon S3 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment récupérer la politique de compartiment d'un compartiment Amazon S3. + Comment ajouter ou mettre à jour la politique de compartiment d'un compartiment Amazon S3. + Comment supprimer la politique de compartiment d'un compartiment Amazon S3. ## Scénario Dans cet exemple, une série de modules Node.js sont utilisés pour récupérer, définir ou supprimer une politique de compartiment sur un compartiment Amazon S3. Les modules Node.js utilisent le SDK JavaScript pour configurer la politique d'un compartiment Amazon S3 sélectionné à l'aide des méthodes suivantes de la classe client Amazon S3 : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketPolicy-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketPolicy-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketPolicy-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketPolicy-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteBucketPolicy-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteBucketPolicy-property) Pour plus d'informations sur les politiques de compartiment pour les compartiments Amazon S3, consultez la section [Utilisation des politiques de compartiment et des politiques utilisateur](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Configuration du kit SDK Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`. ``` // Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'}); ``` ## Extraction de la stratégie de compartiment actuelle Créez un module Node.js nommé `s3_getbucketpolicy.js`. Le module prend un seul argument de ligne de commande pour spécifier le compartiment de la stratégie que vous souhaitez. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Le seul paramètre à passer est le nom du compartiment sélectionné lorsque vous appelez la méthode `getBucketPolicy`. Si le compartiment possède actuellement une politique, cette politique est renvoyée par Amazon S3 dans le `data` paramètre transmis à la fonction de rappel. Si le compartiment sélectionné ne dispose pas de stratégie, ces informations sont retournées à la fonction de rappel dans le paramètre `error`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); var bucketParams = { Bucket: process.argv[2] }; // call S3 to retrieve policy for selected bucket s3.getBucketPolicy(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else if (data) { console.log("Success", data.Policy); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_getbucketpolicy.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_getbucketpolicy.js). ## Définition d'une stratégie de compartiment simple Créez un module Node.js nommé `s3_setbucketpolicy.js`. Le module prend un seul argument de ligne de commande pour spécifier le compartiment de la stratégie que vous souhaitez appliquer. Configurez le kit SDK comme illustré précédemment. Créez un objet de service `AWS.S3`. Les stratégies de compartiment sont spécifiées au format JSON. Tout d'abord, créez un objet JSON contenant toutes les valeurs pour spécifier la stratégie à l'exception de la valeur `Resource` qui identifie le compartiment. Formatez la chaîne `Resource` requise par la stratégie, en intégrant le nom du compartiment sélectionné. Insérez cette chaîne dans l'objet JSON. Préparez les paramètres pour la méthode `putBucketPolicy`, y compris le nom du compartiment et la stratégie JSON convertie en une valeur de chaîne. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); var readOnlyAnonUserPolicy = { Version: "2012-10-17", Statement: [ { Sid: "AddPerm", Effect: "Allow", Principal: "*", Action: ["s3:GetObject"], Resource: [""], }, ], }; // create selected bucket resource string for bucket policy var bucketResource = "arn:aws:s3:::" + process.argv[2] + "/*"; readOnlyAnonUserPolicy.Statement[0].Resource[0] = bucketResource; // convert policy JSON into string and assign into params var bucketPolicyParams = { Bucket: process.argv[2], Policy: JSON.stringify(readOnlyAnonUserPolicy), }; // set the new policy on the selected bucket s3.putBucketPolicy(bucketPolicyParams, function (err, data) { if (err) { // display error message console.log("Error", err); } else { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_setbucketpolicy.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_setbucketpolicy.js). ## Suppression d'une stratégie de compartiment Créez un module Node.js nommé `s3_deletebucketpolicy.js`. Le module prend un seul argument de ligne de commande pour spécifier le compartiment de la stratégie que vous souhaitez supprimer. Configurez le kit SDK comme illustré précédemment. Créez un objet de service `AWS.S3`. Le seul paramètre à passer lorsque vous appelez la méthode `deleteBucketPolicy` est le nom du compartiment sélectionné. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); var bucketParams = { Bucket: process.argv[2] }; // call S3 to delete policy for selected bucket s3.deleteBucketPolicy(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else if (data) { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_deletebucketpolicy.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_deletebucketpolicy.js). # Utilisation d’un compartiment Amazon S3 en tant qu’hôte Web statique ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment configurer un compartiment Amazon S3 en tant qu'hôte Web statique. ## Scénario Dans cet exemple, une série de modules Node.js est utilisée pour configurer tous vos compartiments comme hôte web statique. Les modules Node.js utilisent le SDK pour configurer un compartiment Amazon S3 sélectionné JavaScript à l'aide des méthodes suivantes de la classe client Amazon S3 : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketWebsite-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketWebsite-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketWebsite-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketWebsite-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteBucketWebsite-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteBucketWebsite-property) Pour plus d'informations sur l'utilisation d'un compartiment Amazon S3 en tant qu'hôte Web statique, consultez la section [Hébergement d'un site Web statique sur Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Configuration du kit SDK Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`. ``` // Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'}); ``` ## Extraction de la configuration actuelle du site web d'un compartiment Créez un module Node.js nommé `s3_getbucketwebsite.js`. Le module prend un seul argument de ligne de commande pour spécifier le compartiment de la configuration de site web que vous souhaitez. Configurez le kit SDK comme illustré précédemment. Créez un objet de service `AWS.S3`. Créez une fonction qui extraie la configuration de site web du compartiment actuel pour le compartiment sélectionné dans la liste de compartiments. Le seul paramètre à passer est le nom du compartiment sélectionné lorsque vous appelez la méthode `getBucketWebsite`. Si le bucket possède actuellement une configuration de site Web, cette configuration est renvoyée par Amazon S3 dans le `data` paramètre transmis à la fonction de rappel. Si le compartiment sélectionné ne dispose pas de configuration de site web, ces informations sont retournées à la fonction de rappel dans le paramètre `err`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); var bucketParams = { Bucket: process.argv[2] }; // call S3 to retrieve the website configuration for selected bucket s3.getBucketWebsite(bucketParams, function (err, data) { if (err) { console.log("Error", err); } else if (data) { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_getbucketwebsite.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_getbucketwebsite.js). ## Définition de la configuration de site web d'un compartiment Créez un module Node.js nommé `s3_setbucketwebsite.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Créez une fonction qui applique une configuration de site web d'un compartiment. La configuration permet au compartiment sélectionné d'être utilisé comme hôte web statique. Les configurations de site web sont spécifiées au format JSON. Tout d'abord, créez un objet JSON contenant toutes les valeurs pour spécifier la configuration de site web, à l'exception de la valeur `Key` qui identifie le document d'erreur et la valeur `Suffix` qui identifie le document d'index. Insérez les valeurs des éléments d'entrée de texte dans l'objet JSON. Préparez les paramètres pour la méthode `putBucketWebsite`, y compris le nom du compartiment et la configuration de site web JSON. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); // Create JSON for putBucketWebsite parameters var staticHostParams = { Bucket: "", WebsiteConfiguration: { ErrorDocument: { Key: "", }, IndexDocument: { Suffix: "", }, }, }; // Insert specified bucket name and index and error documents into params JSON // from command line arguments staticHostParams.Bucket = process.argv[2]; staticHostParams.WebsiteConfiguration.IndexDocument.Suffix = process.argv[3]; staticHostParams.WebsiteConfiguration.ErrorDocument.Key = process.argv[4]; // set the new website configuration on the selected bucket s3.putBucketWebsite(staticHostParams, function (err, data) { if (err) { // display error message console.log("Error", err); } else { // update the displayed website configuration for the selected bucket console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_setbucketwebsite.js BUCKET_NAME INDEX_PAGE ERROR_PAGE ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_setbucketwebsite.js). ## Suppression de la configuration de site web d'un compartiment Créez un module Node.js nommé `s3_deletebucketwebsite.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Créez un objet de service `AWS.S3`. Créez une fonction qui supprime la configuration de site web du compartiment sélectionné. Le seul paramètre à passer lorsque vous appelez la méthode `deleteBucketWebsite` est le nom du compartiment sélectionné. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create S3 service object s3 = new AWS.S3({ apiVersion: "2006-03-01" }); var bucketParams = { Bucket: process.argv[2] }; // call S3 to delete website configuration for selected bucket s3.deleteBucketWebsite(bucketParams, function (error, data) { if (error) { console.log("Error", err); } else if (data) { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node s3_deletebucketwebsite.js BUCKET_NAME ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_deletebucketwebsite.js). # Exemples de services de messagerie Amazon Simple Amazon Simple Email Service (Amazon SES) est un service d'envoi d'e-mails basé sur le cloud conçu pour aider les spécialistes du marketing numérique et les développeurs d'applications à envoyer des e-mails marketing, de notification et transactionnels. C'est un service fiable et rentable pour les entreprises de toutes tailles utilisant les e-mails pour rester en contact avec leurs clients. ![\[Relation entre JavaScript les environnements, le SDK et Amazon SES\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/code-samples-ses.png) L' JavaScript API d'Amazon SES est exposée par le biais de la classe `AWS.SES` client. Pour plus d'informations sur l'utilisation de la classe client Amazon SES, consultez [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html)la référence de l'API. **Topics** + [Gestion des identités Amazon SES](ses-examples-managing-identities.md) + [Utilisation de modèles d'e-mails dans Amazon SES](ses-examples-creating-template.md) + [Envoyer un e-mail à l'aide d'Amazon SES](ses-examples-sending-email.md) + [Utilisation de filtres d'adresses IP pour la réception d'e-mails dans Amazon SES](ses-examples-ip-filters.md) + [Utilisation des règles de réception dans Amazon SES](ses-examples-receipt-rules.md) # Gestion des identités Amazon SES ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment vérifier les adresses e-mail et les domaines utilisés avec Amazon SES. + Comment attribuer une politique IAM à vos identités Amazon SES. + Comment répertorier toutes les identités Amazon SES associées à votre AWS compte. + Comment supprimer les identités utilisées avec Amazon SES. Une *identité* Amazon SES est une adresse e-mail ou un domaine qu'Amazon SES utilise pour envoyer des e-mails. Amazon SES vous demande de vérifier votre identité e-mail, de confirmer que vous en êtes le propriétaire et d'empêcher les autres de les utiliser. Pour en savoir plus sur la façon de vérifier les adresses e-mail et les domaines dans Amazon SES, consultez la section [Vérification des adresses e-mail et des domaines dans Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) dans le manuel Amazon Simple Email Service Developer Guide. Pour plus d'informations sur l'envoi d'autorisations dans Amazon SES, consultez [Présentation de l'autorisation d'envoi Amazon SES](Amazon Simple Email Service Developer Guidesending-authorization-overview.html). ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js pour vérifier et gérer les identités Amazon SES. Les modules Node.js utilisent le SDK JavaScript pour vérifier les adresses e-mail et les domaines, en utilisant les méthodes suivantes de la classe `AWS.SES` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#listIdentities-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#listIdentities-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteIdentity-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteIdentity-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#verifyEmailIdentity-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#verifyEmailIdentity-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#verifyDomainIdentity-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#verifyDomainIdentity-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier JSON d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Configuration du kit SDK Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`. ``` // Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'}); ``` ## Liste de vos identités Dans cet exemple, utilisez un module Node.js pour répertorier les adresses e-mail et les domaines à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_listidentities.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre le paramètre `IdentityType` ainsi que les autres paramètres de la méthode `listIdentities` de la classe client `AWS.SES`. Pour appeler la `listIdentities` méthode, créez une promesse pour appeler un objet de service Amazon SES, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. Les `data` retournées par la promesse contiennent un tableau des identités de domaine comme spécifié par le paramètre `IdentityType`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create listIdentities params var params = { IdentityType: "Domain", MaxItems: 10, }; // Create the promise and SES service object var listIDsPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .listIdentities(params) .promise(); // Handle promise's fulfilled/rejected states listIDsPromise .then(function (data) { console.log(data.Identities); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node ses_listidentities.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_listidentities.js). ## Vérification d'une identité d'adresse e-mail Dans cet exemple, utilisez un module Node.js pour vérifier les expéditeurs d'e-mails à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_verifyemailidentity.js`. Configurez le kit SDK comme illustré précédemment. Pour accéder à Amazon SES, créez un objet `AWS.SES` de service. Créez un objet pour transmettre le paramètre `EmailAddress` ainsi que les autres paramètres de la méthode `verifyEmailIdentity` de la classe client `AWS.SES`. Pour appeler la méthode `verifyEmailIdentity`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SES service object var verifyEmailPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .verifyEmailIdentity({ EmailAddress: "ADDRESS@DOMAIN.EXT" }) .promise(); // Handle promise's fulfilled/rejected states verifyEmailPromise .then(function (data) { console.log("Email verification initiated"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le domaine est ajouté à Amazon SES pour être vérifié. ``` node ses_verifyemailidentity.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_verifyemailidentity.js). ## Vérification d'une identité de domaine Dans cet exemple, utilisez un module Node.js pour vérifier les domaines de messagerie à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_verifydomainidentity.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre le paramètre `Domain` ainsi que les autres paramètres de la méthode `verifyDomainIdentity` de la classe client `AWS.SES`. Pour appeler la `verifyDomainIdentity` méthode, créez une promesse pour appeler un objet de service Amazon SES, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var verifyDomainPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .verifyDomainIdentity({ Domain: "DOMAIN_NAME" }) .promise(); // Handle promise's fulfilled/rejected states verifyDomainPromise .then(function (data) { console.log("Verification Token: " + data.VerificationToken); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le domaine est ajouté à Amazon SES pour être vérifié. ``` node ses_verifydomainidentity.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_verifydomainidentity.js). ## Suppression des identités Dans cet exemple, utilisez un module Node.js pour supprimer les adresses e-mail ou les domaines utilisés avec Amazon SES. Créez un module Node.js nommé `ses_deleteidentity.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre le paramètre `Identity` ainsi que les autres paramètres de la méthode `deleteIdentity` de la classe client `AWS.SES`. Pour appeler la `deleteIdentity` méthode, créez un `request` pour appeler un objet de service Amazon SES en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var deletePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteIdentity({ Identity: "DOMAIN_NAME" }) .promise(); // Handle promise's fulfilled/rejected states deletePromise .then(function (data) { console.log("Identity Deleted"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node ses_deleteidentity.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_deleteidentity.js). # Utilisation de modèles d'e-mails dans Amazon SES ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + La récupération d'une liste de toutes vos modèles d'e-mail. + La récupération et la mise à jour des modèles d'e-mail. + La création et la suppression des modèles d'e-mail. Amazon SES vous permet d'envoyer des e-mails personnalisés à l'aide de modèles d'e-mail. Pour en savoir plus sur la création et l'utilisation de modèles d'e-mail dans Amazon Simple Email Service, consultez la section [Envoi d'e-mails personnalisés à l'aide de l'API Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) dans le manuel Amazon Simple Email Service Developer Guide. ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js à utiliser avec des modèles d'e-mail. Les modules Node.js utilisent le SDK pour JavaScript créer et utiliser des modèles de courrier électronique en utilisant les méthodes suivantes de la classe `AWS.SES` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#listTemplates-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#listTemplates-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createTemplate-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createTemplate-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#getTemplate-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#getTemplate-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteTemplate-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteTemplate-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#updateTemplate-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#updateTemplate-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur la création d'un fichier d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Liste de vos modèles d'e-mail Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_listtemplates.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre les paramètres de la méthode `listTemplates` de la classe client `AWS.SES`. Pour appeler la méthode `listTemplates`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .listTemplates({ MaxItems: ITEMS_COUNT }) .promise(); // Handle promise's fulfilled/rejected states templatePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie la liste des modèles. ``` node ses_listtemplates.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_listtemplates.js). ## Récupération d'un modèle d'e-mail Dans cet exemple, utilisez un module Node.js pour obtenir un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_gettemplate.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre le paramètre `TemplateName` ainsi que les autres paramètres de la méthode `getTemplate` de la classe client `AWS.SES`. Pour appeler la méthode `getTemplate`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js. var AWS = require("aws-sdk"); // Set the AWS Region. AWS.config.update({ region: "REGION" }); // Create the promise and Amazon Simple Email Service (Amazon SES) service object. var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .getTemplate({ TemplateName: "TEMPLATE_NAME" }) .promise(); // Handle promise's fulfilled/rejected states templatePromise .then(function (data) { console.log(data.Template.SubjectPart); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie les détails du modèle. ``` node ses_gettemplate.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_gettemplate.js). ## Création d'un modèle d'e-mail Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_createtemplate.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre les paramètres de la méthode `createTemplate` de la classe client `AWS.SES`, y compris `TemplateName`, `HtmlPart`, `SubjectPart` et `TextPart`. Pour appeler la méthode `createTemplate`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create createTemplate params var params = { Template: { TemplateName: "TEMPLATE_NAME" /* required */, HtmlPart: "HTML_CONTENT", SubjectPart: "SUBJECT_LINE", TextPart: "TEXT_CONTENT", }, }; // Create the promise and SES service object var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .createTemplate(params) .promise(); // Handle promise's fulfilled/rejected states templatePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le modèle est ajouté à Amazon SES. ``` node ses_createtemplate.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_createtemplate.js). ## Mise à jour d'un modèle d'e-mail Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_updatetemplate.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre les valeurs de paramètre `Template` que vous souhaitez mettre à jour dans le modèle, avec le paramètre `TemplateName` obligatoire transmis à la méthode `updateTemplate` de la classe client `AWS.SES`. Pour appeler la méthode `updateTemplate`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create updateTemplate parameters var params = { Template: { TemplateName: "TEMPLATE_NAME" /* required */, HtmlPart: "HTML_CONTENT", SubjectPart: "SUBJECT_LINE", TextPart: "TEXT_CONTENT", }, }; // Create the promise and SES service object var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .updateTemplate(params) .promise(); // Handle promise's fulfilled/rejected states templatePromise .then(function (data) { console.log("Template Updated"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie les détails du modèle. ``` node ses_updatetemplate.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_updatetemplate.js). ## Suppression d'un modèle d'e-mail Dans cet exemple, utilisez un module Node.js pour créer un modèle d'e-mail à utiliser avec Amazon SES. Créez un module Node.js nommé `ses_deletetemplate.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre le paramètre`TemplateName` obligatoire à la méthode `deleteTemplate` de la classe client `AWS.SES`. Pour appeler la méthode `deleteTemplate`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var templatePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteTemplate({ TemplateName: "TEMPLATE_NAME" }) .promise(); // Handle promise's fulfilled/rejected states templatePromise .then(function (data) { console.log("Template Deleted"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie les détails du modèle. ``` node ses_deletetemplate.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_deletetemplate.js). # Envoyer un e-mail à l'aide d'Amazon SES ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + L'envoi d'un texte ou d'un e-mail au format HTML. + L'envoi d'e-mails basés sur un modèle d'e-mail. + L'envoi d'e-mails en bloc basés sur un modèle d'e-mail. L'API Amazon SES vous permet d'envoyer un e-mail de deux manières différentes, en fonction du niveau de contrôle que vous souhaitez obtenir sur la composition de l'e-mail : formaté et brut. Pour plus de détails, consultez les [sections Envoi d'e-mails formatés à l'aide de l'API Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-formatted.html) et [Envoi d'e-mails bruts à l'aide de l'API Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-raw.html). ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js pour envoyer un e-mail de plusieurs façons. Les modules Node.js utilisent le SDK pour JavaScript créer et utiliser des modèles de courrier électronique en utilisant les méthodes suivantes de la classe `AWS.SES` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#sendEmail-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#sendEmail-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#sendTemplatedEmail-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#sendTemplatedEmail-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#sendBulkTemplatedEmail-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#sendBulkTemplatedEmail-property) ## Tâches prérequises + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier JSON d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Exigences d'envoi d'un e-mail Amazon SES rédige un e-mail et le met immédiatement en file d'attente pour envoi. Pour envoyer un e-mail à l'aide de la méthode `SES.sendEmail`, votre message doit répondre aux exigences suivantes : + Vous devez envoyer le message à partir d'une adresse e-mail ou d'un domaine vérifié(e). Si vous essayez d'envoyer un e-mail à l'aide d'une adresse ou d'un domaine non vérifié(e), cela engendre une erreur `"Email address not verified"`. + Si votre compte est encore dans l'environnement de test (sandbox) Amazon SES, vous pouvez uniquement envoyer un e-mail à des adresses ou des domaines vérifiés, ou à des adresses e-mail associées au simulateur de boîte de réception Amazon SES. Pour plus d'informations, consultez la section [Vérification des adresses e-mail et des domaines](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) dans le manuel Amazon Simple Email Service Developer Guide. + La taille totale du message, pièces jointes comprises, doit être inférieure à 10 Mo. + Le message doit inclure au moins un destinataire. L'adresse e-mail du destinataire peut se trouver dans le champ À :, Cc : ou Cci :. Si l'adresse e-mail du destinataire n'est pas valide (c'est-à-dire, pas au format `UserName@[SubDomain.]Domain.TopLevelDomain`), le message est rejeté, même si ce dernier contient d'autres destinataires valides. + Le message ne peut pas comporter plus de 50 destinataires répartis dans les champs À :, Cc : et Cci :. Si vous avez besoin d'envoyer un e-mail à davantage de personnes, vous pouvez diviser votre liste de destinataires en groupes de 50 ou moins, puis appeler la méthode `sendEmail` plusieurs fois pour envoyer le message à chaque groupe. ## Envoi d'un e-mail Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_sendemail.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre les valeurs de paramètre qui définissent l'e-mail à envoyer, y compris l'expéditeur et le destinataire, l'objet, le corps du message en texte brut ou au format HTML, à la méthode `sendEmail` de la classe client `AWS.SES`. Pour appeler la méthode `sendEmail`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create sendEmail params var params = { Destination: { /* required */ CcAddresses: [ "EMAIL_ADDRESS", /* more items */ ], ToAddresses: [ "EMAIL_ADDRESS", /* more items */ ], }, Message: { /* required */ Body: { /* required */ Html: { Charset: "UTF-8", Data: "HTML_FORMAT_BODY", }, Text: { Charset: "UTF-8", Data: "TEXT_FORMAT_BODY", }, }, Subject: { Charset: "UTF-8", Data: "Test email", }, }, Source: "SENDER_EMAIL_ADDRESS" /* required */, ReplyToAddresses: [ "EMAIL_ADDRESS", /* more items */ ], }; // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .sendEmail(params) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log(data.MessageId); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. L'e-mail est mis en file d'attente pour être envoyé par Amazon SES. ``` node ses_sendemail.js ``` Cet exemple de code se [trouve ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_sendemail.js). ## Envoi d'un e-mail à l'aide d'un modèle Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_sendtemplatedemail.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre les valeurs de paramètre qui définissent l'e-mail à envoyer, y compris l'expéditeur et le destinataire, l'objet, le corps du message en texte brut ou au format HTML, à la méthode `sendTemplatedEmail` de la classe client `AWS.SES`. Pour appeler la méthode `sendTemplatedEmail`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create sendTemplatedEmail params var params = { Destination: { /* required */ CcAddresses: [ "EMAIL_ADDRESS", /* more CC email addresses */ ], ToAddresses: [ "EMAIL_ADDRESS", /* more To email addresses */ ], }, Source: "EMAIL_ADDRESS" /* required */, Template: "TEMPLATE_NAME" /* required */, TemplateData: '{ "REPLACEMENT_TAG_NAME":"REPLACEMENT_VALUE" }' /* required */, ReplyToAddresses: ["EMAIL_ADDRESS"], }; // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .sendTemplatedEmail(params) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. L'e-mail est mis en file d'attente pour être envoyé par Amazon SES. ``` node ses_sendtemplatedemail.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_sendtemplatedemail.js). ## Envoi d'un e-mail en bloc à l'aide d'un modèle Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_sendbulktemplatedemail.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre les valeurs de paramètre qui définissent l'e-mail à envoyer, y compris l'expéditeur et le destinataire, l'objet, le corps du message en texte brut ou au format HTML, à la méthode `sendBulkTemplatedEmail` de la classe client `AWS.SES`. Pour appeler la méthode `sendBulkTemplatedEmail`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create sendBulkTemplatedEmail params var params = { Destinations: [ /* required */ { Destination: { /* required */ CcAddresses: [ "EMAIL_ADDRESS", /* more items */ ], ToAddresses: [ "EMAIL_ADDRESS", "EMAIL_ADDRESS", /* more items */ ], }, ReplacementTemplateData: '{ "REPLACEMENT_TAG_NAME":"REPLACEMENT_VALUE" }', }, ], Source: "EMAIL_ADDRESS" /* required */, Template: "TEMPLATE_NAME" /* required */, DefaultTemplateData: '{ "REPLACEMENT_TAG_NAME":"REPLACEMENT_VALUE" }', ReplyToAddresses: ["EMAIL_ADDRESS"], }; // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .sendBulkTemplatedEmail(params) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.log(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. L'e-mail est mis en file d'attente pour être envoyé par Amazon SES. ``` node ses_sendbulktemplatedemail.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_sendbulktemplatedemail.js). # Utilisation de filtres d'adresses IP pour la réception d'e-mails dans Amazon SES ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + La création de filtres d'adresses IP pour accepter ou rejeter les messages provenant d'une adresse IP ou d'une plage d'adresses IP. + La liste de vos filtres d'adresses IP actuels. + La suppression d'un filtre d'adresses IP Dans Amazon SES, un *filtre* est une structure de données composée d'un nom, d'une plage d'adresses IP et indiquant s'il faut autoriser ou bloquer le courrier provenant de ce filtre. Les adresses IP que vous souhaitez bloquer ou autoriser sont spécifiées comme adresse IP unique ou plage d'adresses IP en notation CIDR (Classless Inter-Domain Routing). Pour en savoir plus sur la manière dont Amazon SES reçoit les e-mails, consultez les [concepts de réception d'e-mails d'Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) dans le manuel Amazon Simple Email Service Developer Guide. ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js pour envoyer un e-mail de plusieurs façons. Les modules Node.js utilisent le SDK pour JavaScript créer et utiliser des modèles de courrier électronique en utilisant les méthodes suivantes de la classe `AWS.SES` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createReceiptFilter-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createReceiptFilter-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#listReceiptFilters-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#listReceiptFilters-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteReceiptFilter-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteReceiptFilter-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Configuration du kit SDK Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`. ``` // Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'}); ``` ## Création d'un filtre d'adresses IP Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_createreceiptfilter.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre les valeurs de paramètre qui définissent le filtre IP, y compris le nom du filtre, une adresse IP ou une plage d'adresses IP à filtrer et l'autorisation ou le blocage du trafic d'e-mails à partir des adresses filtrées. Pour appeler la méthode `createReceiptFilter`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create createReceiptFilter params var params = { Filter: { IpFilter: { Cidr: "IP_ADDRESS_OR_RANGE", Policy: "Allow" | "Block", }, Name: "NAME", }, }; // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .createReceiptFilter(params) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le filtre est créé dans Amazon SES. ``` node ses_createreceiptfilter.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_createreceiptfilter.js). ## Liste de vos filtres d'adresses IP. Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_listreceiptfilters.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet de paramètre vide. Pour appeler la méthode `listReceiptFilters`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .listReceiptFilters({}) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log(data.Filters); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES renvoie la liste des filtres. ``` node ses_listreceiptfilters.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_listreceiptfilters.js). ## Suppression d'un filtre d'adresses IP Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_deletereceiptfilter.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre le nom du filtre IP à supprimer. Pour appeler la méthode `deleteReceiptFilter`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteReceiptFilter({ FilterName: "NAME" }) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log("IP Filter deleted"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le filtre est supprimé d'Amazon SES. ``` node ses_deletereceiptfilter.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_deletereceiptfilter.js). # Utilisation des règles de réception dans Amazon SES ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + La création et la suppression des règles de réception. + L'organisation des règles de réception en ensembles de règles de réception. Les règles de réception d'Amazon SES spécifient ce qu'il faut faire des e-mails reçus pour les adresses e-mail ou les domaines que vous possédez. Une *règle de réception* contient une condition et une liste ordonnée d'actions. Si le destinataire d'un e-mail entrant correspond à un destinataire spécifié dans les conditions de la règle de réception, Amazon SES exécute les actions spécifiées par la règle de réception. Pour utiliser Amazon SES comme destinataire d'e-mails, vous devez avoir *défini au moins une règle de réception* active. Un ensemble de règles de réception est un ensemble ordonné de règles de réception qui spécifient ce qu'Amazon SES doit faire avec le courrier qu'il reçoit sur vos domaines vérifiés. Pour plus d'informations, consultez les sections [Création de règles de réception pour la réception d'e-mails d'Amazon SES](Amazon Simple Email Service Developer Guidereceiving-email-receipt-rules.html) et [Création d'un ensemble de règles de réception pour la réception d'e-mails d'Amazon SES](Amazon Simple Email Service Developer Guidereceiving-email-receipt-rule-set.html) dans le guide du développeur d'Amazon Simple Email Service. ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js pour envoyer un e-mail de plusieurs façons. Les modules Node.js utilisent le SDK pour JavaScript créer et utiliser des modèles de courrier électronique en utilisant les méthodes suivantes de la classe `AWS.SES` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createReceiptRule-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createReceiptRule-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteReceiptRule-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteReceiptRule-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createReceiptRuleSet-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#createReceiptRuleSet-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteReceiptRuleSet-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SES.html#deleteReceiptRuleSet-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier JSON d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Création d'une règle de réception Amazon S3 Chaque règle de réception pour Amazon SES contient une liste ordonnée d'actions. Cet exemple crée une règle de réception avec une action Amazon S3, qui envoie le message électronique à un compartiment Amazon S3. Pour plus de détails sur les actions relatives aux règles de réception, consultez la section [Options d'action](Amazon Simple Email Service Developer Guidereceiving-email-action.html) du manuel Amazon Simple Email Service Developer Guide. Pour qu'Amazon SES puisse écrire des e-mails dans un compartiment Amazon S3, créez une politique de compartiment qui `PutObject` autorise Amazon SES. Pour plus d'informations sur la création de cette politique de compartiment, consultez la section [Autoriser Amazon SES à écrire dans votre compartiment Amazon S3](Amazon Simple Email Service Developer Guidereceiving-email-permissions.html#receiving-email-permissions-s3.html) dans le manuel Amazon Simple Email Service Developer Guide. Dans cet exemple, utilisez un module Node.js pour créer une règle de réception dans Amazon SES afin d'enregistrer les messages reçus dans un compartiment Amazon S3. Créez un module Node.js nommé `ses_createreceiptrule.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet de paramètre pour transmettre les valeurs nécessaires à la création de l'ensemble de règles de réception. Pour appeler la méthode `createReceiptRuleSet`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create createReceiptRule params var params = { Rule: { Actions: [ { S3Action: { BucketName: "S3_BUCKET_NAME", ObjectKeyPrefix: "email", }, }, ], Recipients: [ "DOMAIN | EMAIL_ADDRESS", /* more items */ ], Enabled: true | false, Name: "RULE_NAME", ScanEnabled: true | false, TlsPolicy: "Optional", }, RuleSetName: "RULE_SET_NAME", }; // Create the promise and SES service object var newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .createReceiptRule(params) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log("Rule created"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES crée la règle de réception. ``` node ses_createreceiptrule.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_createreceiptrule.js). ## Suppression d'une règle de réception Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_deletereceiptrule.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet de paramètre pour transmettre le nom de la règle de réception à supprimer. Pour appeler la méthode `deleteReceiptRule`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create deleteReceiptRule params var params = { RuleName: "RULE_NAME" /* required */, RuleSetName: "RULE_SET_NAME" /* required */, }; // Create the promise and SES service object var newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteReceiptRule(params) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log("Receipt Rule Deleted"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES crée la liste des règles de réception définies. ``` node ses_deletereceiptrule.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_deletereceiptrule.js). ## Création d'un ensemble de règles de réception Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_createreceiptruleset.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet de paramètre pour transmettre le nom du nouvel ensemble de règles de réception. Pour appeler la méthode `createReceiptRuleSet`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .createReceiptRuleSet({ RuleSetName: "NAME" }) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES crée la liste des règles de réception définies. ``` node ses_createreceiptruleset.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_createreceiptruleset.js). ## Suppression d'un ensemble de règles de réception Dans cet exemple, utilisez un module Node.js pour envoyer un e-mail avec Amazon SES. Créez un module Node.js nommé `ses_deletereceiptruleset.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet de paramètre pour transmettre le nom de l'ensemble de règles de réception à supprimer. Pour appeler la méthode `deleeReceiptRuleSet`, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteReceiptRuleSet({ RuleSetName: "NAME" }) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Amazon SES crée la liste des règles de réception définies. ``` node ses_deletereceiptruleset.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/ses/ses_deletereceiptruleset.js). # Exemples du service de notification Amazon Simple Amazon Simple Notification Service (Amazon SNS) est un service Web qui coordonne et gère la livraison ou l'envoi de messages aux points de terminaison ou aux clients abonnés. Sur Amazon SNS, il existe deux types de clients, les éditeurs et les abonnés, également appelés producteurs et consommateurs. ![\[Relation entre JavaScript les environnements, le SDK et Amazon SNS\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/code-samples-sns.png) Les éditeurs communiquent de façon asynchrone avec les abonnés en produisant et en envoyant un message à une rubrique, qui est un point d'accès logique et un canal de communication. Les abonnés (serveurs Web, adresses e-mail, files d'attente Amazon SQS, fonctions Lambda) consomment ou reçoivent le message ou la notification via l'un des protocoles pris en charge (Amazon SQS, HTTP/S, e-mail, SMS AWS Lambda) lorsqu'ils sont abonnés au sujet. L' JavaScript API pour Amazon SNS est exposée via le. [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html) **Topics** + [Gestion des rubriques dans Amazon SNS](sns-examples-managing-topics.md) + [Publication de messages sur Amazon SNS](sns-examples-publishing-messages.md) + [Gestion des abonnements sur Amazon SNS](sns-examples-subscribing-unubscribing-topics.md) + [Envoi de SMS avec Amazon SNS](sns-examples-sending-sms.md) # Gestion des rubriques dans Amazon SNS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment créer des rubriques dans Amazon SNS sur lesquelles vous pouvez publier des notifications. + Comment supprimer des sujets créés dans Amazon SNS. + Comment obtenir une liste des rubriques disponibles. + Comment obtenir et définir des attributs de rubrique. ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js pour créer, répertorier et supprimer des rubriques Amazon SNS, ainsi que pour gérer les attributs des rubriques. Les modules Node.js utilisent le SDK pour gérer les sujets JavaScript à l'aide des méthodes suivantes de la classe `AWS.SNS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#createTopic-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#createTopic-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listTopics-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listTopics-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#deleteTopic-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#deleteTopic-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getTopicAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getTopicAttributes-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setTopicAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setTopicAttributes-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](http://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier JSON d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Création d'une rubrique Dans cet exemple, utilisez un module Node.js pour créer une rubrique Amazon SNS. Créez un module Node.js nommé `sns_createtopic.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet pour transmettre le paramètre`Name` de la nouvelle rubrique à la méthode `createTopic` de la classe client `AWS.SNS`. Pour appeler la `createTopic` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. Les `data` renvoyées par la promesse contiennent l'ARN de la rubrique. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SNS service object var createTopicPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .createTopic({ Name: "TOPIC_NAME" }) .promise(); // Handle promise's fulfilled/rejected states createTopicPromise .then(function (data) { console.log("Topic ARN is " + data.TopicArn); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_createtopic.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_createtopic.js). ## Liste de vos rubriques Dans cet exemple, utilisez un module Node.js pour répertorier toutes les rubriques Amazon SNS. Créez un module Node.js nommé `sns_listtopics.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet vide à transmettre à la méthode `listTopics` de la classe client `AWS.SNS`. Pour appeler la `listTopics` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. Le `data` contenu renvoyé par la promesse contient un tableau de votre sujet ARNs. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SNS service object var listTopicsPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .listTopics({}) .promise(); // Handle promise's fulfilled/rejected states listTopicsPromise .then(function (data) { console.log(data.Topics); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_listtopics.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_listtopics.js). ## Suppression d'une rubrique Dans cet exemple, utilisez un module Node.js pour supprimer une rubrique Amazon SNS. Créez un module Node.js nommé `sns_deletetopic.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le paramètre `TopicArn` de la rubrique à supprimer pour le transmettre à la méthode `deleteTopic` de la classe client `AWS.SNS`. Pour appeler la `deleteTopic` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SNS service object var deleteTopicPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .deleteTopic({ TopicArn: "TOPIC_ARN" }) .promise(); // Handle promise's fulfilled/rejected states deleteTopicPromise .then(function (data) { console.log("Topic Deleted"); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_deletetopic.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_deletetopic.js). ## Récupération d'attributs de rubrique Dans cet exemple, utilisez un module Node.js pour récupérer les attributs d'une rubrique Amazon SNS. Créez un module Node.js nommé `sns_gettopicattributes.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le paramètre `TopicArn` d'une rubrique à supprimer pour le transmettre à la méthode `getTopicAttributes` de la classe client `AWS.SNS`. Pour appeler la `getTopicAttributes` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SNS service object var getTopicAttribsPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .getTopicAttributes({ TopicArn: "TOPIC_ARN" }) .promise(); // Handle promise's fulfilled/rejected states getTopicAttribsPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_gettopicattributes.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_gettopicattributes.js). ## Définition d'attributs de rubrique Dans cet exemple, utilisez un module Node.js pour définir les attributs modifiables d'une rubrique Amazon SNS. Créez un module Node.js nommé `sns_settopicattributes.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant les paramètres pour la mise à jour de l'attribut, y compris le paramètre `TopicArn` de la rubrique dont vous souhaitez définir les attributs, le nom de l'attribut à définir et la nouvelle valeur pour cet attribut. Vous ne pouvez définir que les attributs `Policy`, `DisplayName` et `DeliveryPolicy`. Transmettez les paramètres à la méthode `setTopicAttributes` de la classe client `AWS.SNS`. Pour appeler la `setTopicAttributes` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create setTopicAttributes parameters var params = { AttributeName: "ATTRIBUTE_NAME" /* required */, TopicArn: "TOPIC_ARN" /* required */, AttributeValue: "NEW_ATTRIBUTE_VALUE", }; // Create promise and SNS service object var setTopicAttribsPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .setTopicAttributes(params) .promise(); // Handle promise's fulfilled/rejected states setTopicAttribsPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_settopicattributes.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_settopicattributes.js). # Publication de messages sur Amazon SNS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment publier des messages sur une rubrique Amazon SNS. ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js pour publier des messages depuis Amazon SNS vers des points de terminaison, des e-mails ou des numéros de téléphone thématiques. Les modules Node.js utilisent le SDK pour JavaScript envoyer des messages en utilisant cette méthode de la classe `AWS.SNS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](http://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier JSON d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Publication d'un message sur une rubrique Amazon SNS Dans cet exemple, utilisez un module Node.js pour publier un message sur une rubrique Amazon SNS. Créez un module Node.js nommé `sns_publishtotopic.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant les paramètres de publication d'un message, notamment le texte du message et l'ARN de la rubrique Amazon SNS. Pour plus de détails sur les attributs SMS disponibles, voir [Définir SMSAttributes](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setSMSAttributes-property). Transmettez les paramètres à la méthode `publish` de la classe client `AWS.SNS`. Créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément response dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create publish parameters var params = { Message: "MESSAGE_TEXT" /* required */, TopicArn: "TOPIC_ARN", }; // Create promise and SNS service object var publishTextPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .publish(params) .promise(); // Handle promise's fulfilled/rejected states publishTextPromise .then(function (data) { console.log( `Message ${params.Message} sent to the topic ${params.TopicArn}` ); console.log("MessageID is " + data.MessageId); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_publishtotopic.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_publishtotopic.js). # Gestion des abonnements sur Amazon SNS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment répertorier tous les abonnements à une rubrique Amazon SNS. + Comment abonner une adresse e-mail, un point de terminaison d'application ou une AWS Lambda fonction à une rubrique Amazon SNS. + Comment se désabonner des rubriques Amazon SNS. ## Scénario Dans cet exemple, vous utilisez une série de modules Node.js pour publier des messages de notification dans les rubriques Amazon SNS. Les modules Node.js utilisent le SDK pour gérer les sujets JavaScript à l'aide des méthodes suivantes de la classe `AWS.SNS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#subscribe-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#subscribe-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#confirmSubscription-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#confirmSubscription-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listSubscriptionsByTopic-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listSubscriptionsByTopic-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#unsubscribe-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#unsubscribe-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](http://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier JSON d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Liste des abonnements à une rubrique Dans cet exemple, utilisez un module Node.js pour répertorier tous les abonnements à une rubrique Amazon SNS. Créez un module Node.js nommé `sns_listsubscriptions.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le paramètre `TopicArn` pour la rubrique dont vous souhaitez répertorier les abonnements. Transmettez les paramètres à la méthode `listSubscriptionsByTopic` de la classe client `AWS.SNS`. Pour appeler la `listSubscriptionsByTopic` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); const params = { TopicArn: "TOPIC_ARN", }; // Create promise and SNS service object var subslistPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .listSubscriptionsByTopic(params) .promise(); // Handle promise's fulfilled/rejected states subslistPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_listsubscriptions.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_listsubscriptions.js). ## Abonnement d'une adresse e-mail à une rubrique Dans cet exemple, utilisez un module Node.js pour abonner une adresse e-mail afin qu'elle reçoive des e-mails SMTP provenant d'une rubrique Amazon SNS. Créez un module Node.js nommé `sns_subscribeemail.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le paramètre `Protocol` pour spécifier le protocole `email`, l'élément `TopicArn` pour la rubrique à laquelle s'abonner ainsi qu'une adresse e-mail comme message `Endpoint`. Transmettez les paramètres à la méthode `subscribe` de la classe client `AWS.SNS`. Vous pouvez utiliser `subscribe` cette méthode pour abonner plusieurs points de terminaison différents à une rubrique Amazon SNS, en fonction des valeurs utilisées pour les paramètres transmis, comme le montreront d'autres exemples présentés dans cette rubrique. Pour appeler la `subscribe` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create subscribe/email parameters var params = { Protocol: "EMAIL" /* required */, TopicArn: "TOPIC_ARN" /* required */, Endpoint: "EMAIL_ADDRESS", }; // Create promise and SNS service object var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .subscribe(params) .promise(); // Handle promise's fulfilled/rejected states subscribePromise .then(function (data) { console.log("Subscription ARN is " + data.SubscriptionArn); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_subscribeemail.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_subscribeemail.js). ## Abonnement d'un point de terminaison d'application à une rubrique Dans cet exemple, utilisez un module Node.js pour abonner un point de terminaison d'application mobile afin qu'il reçoive des notifications provenant d'une rubrique Amazon SNS. Créez un module Node.js nommé `sns_subscribeapp.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le paramètre `Protocol` pour spécifier le protocole `application`, l'élément `TopicArn` pour la rubrique à laquelle s'abonner ainsi que l'ARN d'un point de terminaison d'application mobile pour le paramètre `Endpoint`. Transmettez les paramètres à la méthode `subscribe` de la classe client `AWS.SNS`. Pour appeler la `subscribe` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create subscribe/email parameters var params = { Protocol: "application" /* required */, TopicArn: "TOPIC_ARN" /* required */, Endpoint: "MOBILE_ENDPOINT_ARN", }; // Create promise and SNS service object var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .subscribe(params) .promise(); // Handle promise's fulfilled/rejected states subscribePromise .then(function (data) { console.log("Subscription ARN is " + data.SubscriptionArn); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_subscribeapp.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_subscribeapp.js). ## Abonnement d'une fonction Lambda à une rubrique Dans cet exemple, utilisez un module Node.js pour abonner une AWS Lambda fonction afin qu'elle reçoive des notifications d'une rubrique Amazon SNS. Créez un module Node.js nommé `sns_subscribelambda.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le `Protocol` paramètre, en spécifiant le `lambda` protocole, le `TopicArn` sujet auquel vous souhaitez vous abonner et l'ARN d'une AWS Lambda fonction en tant que `Endpoint` paramètre. Transmettez les paramètres à la méthode `subscribe` de la classe client `AWS.SNS`. Pour appeler la `subscribe` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create subscribe/email parameters var params = { Protocol: "lambda" /* required */, TopicArn: "TOPIC_ARN" /* required */, Endpoint: "LAMBDA_FUNCTION_ARN", }; // Create promise and SNS service object var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .subscribe(params) .promise(); // Handle promise's fulfilled/rejected states subscribePromise .then(function (data) { console.log("Subscription ARN is " + data.SubscriptionArn); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_subscribelambda.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_subscribelambda.js). ## Désabonnement d'une rubrique Dans cet exemple, utilisez un module Node.js pour vous désabonner d'un abonnement à une rubrique Amazon SNS. Créez un module Node.js nommé `sns_unsubscribe.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le paramètre `SubscriptionArn`, en spécifiant l'ARN de l'abonnement à désabonner. Transmettez les paramètres à la méthode `unsubscribe` de la classe client `AWS.SNS`. Pour appeler la `unsubscribe` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SNS service object var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .unsubscribe({ SubscriptionArn: TOPIC_SUBSCRIPTION_ARN }) .promise(); // Handle promise's fulfilled/rejected states subscribePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_unsubscribe.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_unsubscribe.js). # Envoi de SMS avec Amazon SNS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment obtenir et définir les préférences de messagerie SMS pour Amazon SNS. + Comment vérifier qu'un numéro de téléphone a désactivé la réception de SMS. + Comment récupérer une liste de numéros de téléphone ayant désactivé la réception de SMS. + Comment envoyer un SMS. ## Scénario Vous pouvez utiliser pour envoyer des messages texte, ou des messages SMS, à des appareils compatibles SMS. Vous pouvez envoyer un message directement à un numéro de téléphone, ou vous pouvez envoyer un message à plusieurs numéros de téléphone simultanément en abonnant ces numéros de téléphone à une rubrique et en envoyant votre message à la rubrique. Dans cet exemple, vous utilisez une série de modules Node.js pour publier des SMS depuis Amazon SNS vers des appareils compatibles SMS. Les modules Node.js utilisent le SDK JavaScript pour publier des messages SMS en utilisant les méthodes suivantes de la classe `AWS.SNS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getSMSAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getSMSAttributes-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setSMSAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setSMSAttributes-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#checkIfPhoneNumberIsOptedOut-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#checkIfPhoneNumberIsOptedOut-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listPhoneNumbersOptedOut-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listPhoneNumbersOptedOut-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property) ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](http://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier JSON d'informations d'identification, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Récupération d'attributs SMS Utilisez Amazon SNS pour définir vos préférences en matière de messagerie SMS, telles que la manière dont vos envois sont optimisés (en termes de coût ou de fiabilité), votre limite de dépenses mensuelles, la manière dont les envois de messages sont enregistrés et si vous souhaitez vous abonner aux rapports quotidiens d'utilisation des SMS. Ces préférences sont récupérées et définies sous forme d'attributs SMS pour Amazon SNS. Dans cet exemple, utilisez un module Node.js pour obtenir les attributs SMS actuels dans Amazon SNS. Créez un module Node.js nommé `sns_getsmstype.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant les paramètres pour récupérer les attributs SMS, y compris les noms des attributs individuels. Pour en savoir plus sur les attributs SMS disponibles, consultez la section [Définir SMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html) dans le manuel Amazon Simple Notification Service API Reference. Cet exemple récupère l'attribut `DefaultSMSType`, qui contrôle si les messages SMS sont envoyés en tant que `Promotional`, ce qui optimise la transmission des messages au plus bas coût ou en tant que `Transactional`, ce qui optimise la transmission des messages à une fiabilité optimale. Transmettez les paramètres à la méthode `setTopicAttributes` de la classe client `AWS.SNS`. Pour appeler la `getSMSAttributes` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create SMS Attribute parameter you want to get var params = { attributes: [ "DefaultSMSType", "ATTRIBUTE_NAME", /* more items */ ], }; // Create promise and SNS service object var getSMSTypePromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .getSMSAttributes(params) .promise(); // Handle promise's fulfilled/rejected states getSMSTypePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_getsmstype.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_getsmstype.js). ## Définition d'attributs SMS Dans cet exemple, utilisez un module Node.js pour obtenir les attributs SMS actuels dans Amazon SNS. Créez un module Node.js nommé `sns_setsmstype.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant les paramètres pour définir les attributs SMS, y compris les noms des attributs individuels et les valeurs de chacun d'entre eux. Pour en savoir plus sur les attributs SMS disponibles, consultez la section [Définir SMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html) dans le manuel Amazon Simple Notification Service API Reference. Cet exemple définit l’attribut `DefaultSMSType` sur `Transactional`, ce qui optimise la transmission de message à une fiabilité optimale. Transmettez les paramètres à la méthode `setTopicAttributes` de la classe client `AWS.SNS`. Pour appeler la `getSMSAttributes` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create SMS Attribute parameters var params = { attributes: { /* required */ DefaultSMSType: "Transactional" /* highest reliability */, //'DefaultSMSType': 'Promotional' /* lowest cost */ }, }; // Create promise and SNS service object var setSMSTypePromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .setSMSAttributes(params) .promise(); // Handle promise's fulfilled/rejected states setSMSTypePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_setsmstype.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_setsmstype.js). ## Vérification d'un numéro de téléphone désactivé Dans cet exemple, utilisez un module Node.js pour vérifier qu'un numéro de téléphone a désactivé la réception de SMS. Créez un module Node.js nommé `sns_checkphoneoptout.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant le numéro de téléphone à vérifier en tant que paramètre. Cet exemple définit le paramètre `PhoneNumber` pour spécifier le numéro de téléphone à vérifier. Transmettez l'objet à la méthode `checkIfPhoneNumberIsOptedOut` de la classe client `AWS.SNS`. Pour appeler la `checkIfPhoneNumberIsOptedOut` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SNS service object var phonenumPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .checkIfPhoneNumberIsOptedOut({ phoneNumber: "PHONE_NUMBER" }) .promise(); // Handle promise's fulfilled/rejected states phonenumPromise .then(function (data) { console.log("Phone Opt Out is " + data.isOptedOut); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_checkphoneoptout.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_checkphoneoptout.js). ## Liste des numéros de téléphone désactivés Dans cet exemple, utilisez un module Node.js pour récupérer une liste des numéros de téléphone ayant désactivé la réception de SMS. Créez un module Node.js nommé `sns_listnumbersoptedout.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet vide comme paramètre. Transmettez l'objet à la méthode `listPhoneNumbersOptedOut` de la classe client `AWS.SNS`. Pour appeler la `listPhoneNumbersOptedOut` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create promise and SNS service object var phonelistPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .listPhoneNumbersOptedOut({}) .promise(); // Handle promise's fulfilled/rejected states phonelistPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_listnumbersoptedout.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_listnumbersoptedout.js). ## Publication d'un SMS Dans cet exemple, utilisez un module Node.js pour envoyer un SMS à un numéro de téléphone. Créez un module Node.js nommé `sns_publishsms.js`. Configurez le kit SDK comme illustré précédemment. Créez un objet contenant les paramètres `Message` et `PhoneNumber`. Lorsque vous envoyez un SMS, spécifiez le numéro de téléphone au format E.164. E.164 est une norme pour la structure des numéros de téléphone, qui est utilisée pour les télécommunications internationales. Les numéros qui respectent ce format peuvent comporter 15 chiffres au maximum et commencent par le caractère plus (\$1) et le code pays. Par exemple, un numéro de téléphone américain au format E.164 s'affichera sous la forme XXX5550100 \$11001. Cet exemple définit le paramètre `PhoneNumber` pour spécifier le numéro de téléphone qui envoie le message. Transmettez l'objet à la méthode `publish` de la classe client `AWS.SNS`. Pour appeler la `publish` méthode, créez une promesse pour appeler un objet de service Amazon SNS, en transmettant l'objet de paramètres. Traitez ensuite l'élément `response` dans le rappel de promesse. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set region AWS.config.update({ region: "REGION" }); // Create publish parameters var params = { Message: "TEXT_MESSAGE" /* required */, PhoneNumber: "E.164_PHONE_NUMBER", }; // Create promise and SNS service object var publishTextPromise = new AWS.SNS({ apiVersion: "2010-03-31" }) .publish(params) .promise(); // Handle promise's fulfilled/rejected states publishTextPromise .then(function (data) { console.log("MessageID is " + data.MessageId); }) .catch(function (err) { console.error(err, err.stack); }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sns_publishsms.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_publishsms.js). # Exemples Amazon SQS Amazon Simple Queue Service (Amazon SQS) est un service de file d'attente de messages rapide, fiable, évolutif et entièrement géré. Amazon SQS vous permet de dissocier les composants d'une application cloud. Amazon SQS inclut des files d'attente standard avec un débit et un at-least-once traitement élevés, ainsi que des files d'attente FIFO qui fournissent une livraison FIFO (premier entré, premier sorti) et un traitement en une seule fois. ![\[Relation entre JavaScript les environnements, le SDK et Amazon SQS\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/code-samples-sqs.png) L' JavaScript API d'Amazon SQS est exposée par le biais de la classe `AWS.SQS` client. Pour plus d'informations sur l'utilisation de la classe client Amazon SQS, consultez la référence [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html)de l'API. **Topics** + [Utilisation des files d'attente dans Amazon SQS](sqs-examples-using-queues.md) + [Envoi et réception de messages dans Amazon SQS](sqs-examples-send-receive-messages.md) + [Gestion du délai de visibilité dans Amazon SQS](sqs-examples-managing-visibility-timeout.md) + [Activation de l'attente active de longue durée dans Amazon SQS](sqs-examples-enable-long-polling.md) + [Utilisation des files d'attente de lettres mortes dans Amazon SQS](sqs-examples-dead-letter-queues.md) # Utilisation des files d'attente dans Amazon SQS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment récupérer la liste de toutes vos files d'attentes de messages + Comment récupérer l'URL d'une file d'attente en particulier + Comment créer et supprimer des files d'attente ## À propos de l'exemple Dans cet exemple, une série de modules Node.js est utilisée pour utiliser des files d'attentes. Les modules Node.js utilisent le SDK pour permettre JavaScript aux files d'attente d'appeler les méthodes suivantes de la classe `AWS.SQS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#listQueues-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#listQueues-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#createQueue-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#createQueue-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#getQueueUrl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#getQueueUrl-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#deleteQueue-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#deleteQueue-property) Pour plus d'informations sur les messages Amazon SQS, consultez la section [Comment fonctionnent les files d'attente dans le manuel](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-how-it-works.html) *Amazon Simple Queue Service* Developer Guide. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Liste de vos files d'attente Créez un module Node.js nommé `sqs_listqueues.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres nécessaires pour répertorier vos files d'attentes, qui est par défaut un objet vide. Appelez la méthode `listQueues` pour extraire la liste des files d'attente. Le rappel renvoie toutes les files URLs d'attente. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create an SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = {}; sqs.listQueues(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.QueueUrls); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_listqueues.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_listqueues.js). ## Création d'une file d'attente Créez un module Node.js nommé `sqs_createqueue.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres obligatoires pour répertorier vos files d'attente, qui doit inclure le nom de la file d'attente créée. Les paramètres peuvent également contenir des attributs pour la file d'attente, comme le nombre de secondes de retard dans la remise d'un message ou le nombre de secondes pour conserver un message reçu. Appelez la méthode `createQueue`. Le rappel retourne l'URL de la file d'attente créée. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create an SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = { QueueName: "SQS_QUEUE_NAME", Attributes: { DelaySeconds: "60", MessageRetentionPeriod: "86400", }, }; sqs.createQueue(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.QueueUrl); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_createqueue.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_createqueue.js). ## Récupération de l'URL d'une file d'attente Créez un module Node.js nommé `sqs_getqueueurl.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres obligatoires pour répertorier vos files d'attente, qui doit inclure le nom de la file d'attente dont vous souhaitez obtenir l'URL. Appelez la méthode `getQueueUrl`. Le rappel retourne l'URL de la file d'attente spécifiée. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create an SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = { QueueName: "SQS_QUEUE_NAME", }; sqs.getQueueUrl(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.QueueUrl); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_getqueueurl.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_getqueueurl.js). ## Suppression d'une file d'attente Créez un module Node.js nommé `sqs_deletequeue.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres nécessaires pour supprimer une file d'attente, qui inclut l'URL de la file d'attente à supprimer. Appelez la méthode `deleteQueue`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create an SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = { QueueUrl: "SQS_QUEUE_URL", }; sqs.deleteQueue(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_deletequeue.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_deletequeue.js). # Envoi et réception de messages dans Amazon SQS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment envoyer des messages dans une file d'attente. + Comment recevoir des messages dans une file d'attente. + Comment supprimer des messages dans une file d'attente. ## Scénario Dans cet exemple, une série de modules Node.js est utilisée pour envoyer et recevoir des messages. Les modules Node.js utilisent le SDK pour JavaScript envoyer et recevoir des messages en utilisant les méthodes suivantes de la classe `AWS.SQS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#sendMessage-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#sendMessage-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#receiveMessage-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#receiveMessage-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#deleteMessage-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#deleteMessage-property) Pour plus d'informations sur les messages Amazon SQS, consultez [Envoyer un message à une file d'attente Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-send-message.html) [et Recevoir et supprimer un message d'une file d'attente Amazon SQS dans le guide du développeur Amazon](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-receive-delete-message.html) *Simple Queue Service*. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). + Créez une file d’attente Amazon SQS. Pour obtenir un exemple de création de file d'attente, consultez [Utilisation des files d'attente dans Amazon SQS](sqs-examples-using-queues.md). ## Envoi d'un message à une file d'attente Créez un module Node.js nommé `sqs_sendmessage.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres obligatoires pour votre message, y compris l'URL de la file d'attente à laquelle vous souhaitez envoyer ce message. Dans cet exemple, le message fournit des détails au sujet d'un livre se trouvant sur une liste des meilleurs ouvrages de fiction, y compris le titre, l'auteur, et le nombre de semaines sur la liste. Appelez la méthode `sendMessage`. Le rappel retourne l'ID unique du message. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create an SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = { // Remove DelaySeconds parameter and value for FIFO queues DelaySeconds: 10, MessageAttributes: { Title: { DataType: "String", StringValue: "The Whistler", }, Author: { DataType: "String", StringValue: "John Grisham", }, WeeksOn: { DataType: "Number", StringValue: "6", }, }, MessageBody: "Information about current NY Times fiction bestseller for week of 12/11/2016.", // MessageDeduplicationId: "TheWhistler", // Required for FIFO queues // MessageGroupId: "Group1", // Required for FIFO queues QueueUrl: "SQS_QUEUE_URL", }; sqs.sendMessage(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.MessageId); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_sendmessage.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_sendmessage.js). ## Réception et suppression des messages provenant d'une file d'attente Créez un module Node.js nommé `sqs_receivemessage.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres obligatoires pour votre message, y compris l'URL de la file d'attente à partir de laquelle vous souhaitez recevoir ce message. Dans cet exemple, les paramètres spécifient la réception de tous les attributs de message, ainsi que la réception de 10 messages maximum. Appelez la méthode `receiveMessage`. Le rappel retourne un tableau d'objets `Message` à partir duquel vous pouvez récupérer la valeur `ReceiptHandle` pour chaque message que vous utilisez, afin de supprimer ultérieurement le message. Créez un autre objet JSON contenant les paramètres obligatoires pour supprimer le message, qui sont l'URL de la file d'attente et la valeur `ReceiptHandle`. Appelez la méthode `deleteMessage` pour supprimer le message reçu. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create an SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var queueURL = "SQS_QUEUE_URL"; var params = { AttributeNames: ["SentTimestamp"], MaxNumberOfMessages: 10, MessageAttributeNames: ["All"], QueueUrl: queueURL, VisibilityTimeout: 20, WaitTimeSeconds: 0, }; sqs.receiveMessage(params, function (err, data) { if (err) { console.log("Receive Error", err); } else if (data.Messages) { var deleteParams = { QueueUrl: queueURL, ReceiptHandle: data.Messages[0].ReceiptHandle, }; sqs.deleteMessage(deleteParams, function (err, data) { if (err) { console.log("Delete Error", err); } else { console.log("Message Deleted", data); } }); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_receivemessage.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_receivemessage.js). # Gestion du délai de visibilité dans Amazon SQS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment spécifier l'intervalle de temps pendant lequel les messages reçus par une file d'attente ne sont pas visibles. ## Scénario Dans cet exemple, le module Node.js est utilisé pour gérer le délai de visibilité. Le module Node.js utilise le SDK pour gérer le délai JavaScript d'expiration de visibilité en utilisant cette méthode de la classe `AWS.SQS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#changeMessageVisibility-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#changeMessageVisibility-property) Pour plus d'informations sur le délai de visibilité d'Amazon SQS, consultez [Visibility Timeout dans le manuel](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html) *Amazon Simple Queue* Service Developer Guide. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). + Créez une file d’attente Amazon SQS. Pour obtenir un exemple de création de file d'attente, consultez [Utilisation des files d'attente dans Amazon SQS](sqs-examples-using-queues.md). + Envoyez un message à la file d'attente. Pour obtenir un exemple d'envoi de message à une file d'attente, consultez [Envoi et réception de messages dans Amazon SQS](sqs-examples-send-receive-messages.md). ## Modification du délai de visibilité Créez un module Node.js nommé `sqs_changingvisibility.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon Simple Queue Service, créez un objet `AWS.SQS` de service. Recevoir le message de la file d'attente. À la réception du message de la file d'attente, créez un objet JSON contenant les paramètres obligatoires pour définir le délai d'expiration, y compris l'URL de la file d'attente contenant le message, la valeur `ReceiptHandle` retournée lorsque le message a été reçu, et le nouveau délai d'expiration en secondes. Appelez la méthode `changeMessageVisibility`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region to us-west-2 AWS.config.update({ region: "us-west-2" }); // Create the SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var queueURL = "https://sqs.REGION.amazonaws.com/ACCOUNT-ID/QUEUE-NAME"; var params = { AttributeNames: ["SentTimestamp"], MaxNumberOfMessages: 1, MessageAttributeNames: ["All"], QueueUrl: queueURL, }; sqs.receiveMessage(params, function (err, data) { if (err) { console.log("Receive Error", err); } else { // Make sure we have a message if (data.Messages != null) { var visibilityParams = { QueueUrl: queueURL, ReceiptHandle: data.Messages[0].ReceiptHandle, VisibilityTimeout: 20, // 20 second timeout }; sqs.changeMessageVisibility(visibilityParams, function (err, data) { if (err) { console.log("Delete Error", err); } else { console.log("Timeout Changed", data); } }); } else { console.log("No messages to change"); } } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_changingvisibility.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_changingvisibility.js). # Activation de l'attente active de longue durée dans Amazon SQS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment activer l'attente active de longue durée pour une nouvelle file d'attente + Comment activer l'attente active de longue durée pour une file d'attente existante + Comment activer l'attente active de longue durée lors de la réception d'un message ## Scénario Les longues interrogations réduisent le nombre de réponses vides en permettant à Amazon SQS d'attendre pendant un certain temps qu'un message soit disponible dans la file d'attente avant d'envoyer une réponse. L'attente active de longue durée élimine également les fausses réponses vides en interrogeant tous les serveurs, à la place d'un simple échantillon. Pour activer l'attente active de longue durée, vous devez spécifier un temps d'attente différent de zéro pour les messages reçus. Pour ce faire, vous devez définir le paramètre `ReceiveMessageWaitTimeSeconds` d'une file d'attente ou le paramètre `WaitTimeSeconds` à la réception d'un message. Dans cet exemple, une série de modules Node.js est utilisée pour activer l'attente active de longue durée. Les modules Node.js utilisent le SDK pour activer les longues JavaScript interrogations à l'aide des méthodes suivantes de la classe `AWS.SQS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#setQueueAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#setQueueAttributes-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#receiveMessage-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#receiveMessage-property) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#createQueue-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#createQueue-property) Pour plus d'informations sur les longs sondages Amazon SQS, consultez la section [Long Polling du manuel](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html) *Amazon Simple Queue Service Developer Guide*. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). ## Activation de l'attente active de longue durée lors de la création d'une file d'attente Créez un module Node.js nommé `sqs_longpolling_createqueue.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres obligatoires pour créer une file d'attente, y compris une valeur différente de zéro pour le paramètre `ReceiveMessageWaitTimeSeconds`. Appelez la méthode `createQueue`. L'attente active de longue durée est activée pour la file d'attente. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = { QueueName: "SQS_QUEUE_NAME", Attributes: { ReceiveMessageWaitTimeSeconds: "20", }, }; sqs.createQueue(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.QueueUrl); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_longpolling_createqueue.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_longpolling_createqueue.js). ## Activation de l'attente active de longue durée pour une file d'attente existante Créez un module Node.js nommé `sqs_longpolling_existingqueue.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon Simple Queue Service, créez un objet `AWS.SQS` de service. Créez un objet JSON contenant les paramètres obligatoires pour définir les attributs de la file d'attente, y compris une valeur différente de zéro pour le paramètre `ReceiveMessageWaitTimeSeconds` et l'URL de la file d'attente. Appelez la méthode `setQueueAttributes`. L'attente active de longue durée est activée pour la file d'attente. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = { Attributes: { ReceiveMessageWaitTimeSeconds: "20", }, QueueUrl: "SQS_QUEUE_URL", }; sqs.setQueueAttributes(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_longpolling_existingqueue.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_longpolling_existingqueue.js). ## Activation de l'attente active de longue durée pour la réception des messages Créez un module Node.js nommé `sqs_longpolling_receivemessage.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon Simple Queue Service, créez un objet `AWS.SQS` de service. Créez un objet JSON contenant les paramètres obligatoires pour recevoir des messages, y compris une valeur différente de zéro pour le paramètre `WaitTimeSeconds` et l'URL de la file d'attente. Appelez la méthode `receiveMessage`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var queueURL = "SQS_QUEUE_URL"; var params = { AttributeNames: ["SentTimestamp"], MaxNumberOfMessages: 1, MessageAttributeNames: ["All"], QueueUrl: queueURL, WaitTimeSeconds: 20, }; sqs.receiveMessage(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_longpolling_receivemessage.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_longpolling_receivemessage.js). # Utilisation des files d'attente de lettres mortes dans Amazon SQS ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Cet exemple de code Node.js présente :** + Comment utiliser une file d'attente pour recevoir et mettre en attente des messages en provenance d'autres files d'attente que celles-ci ne peuvent pas traiter. ## Scénario Une file d'attente de lettres mortes peut être ciblée par d'autres files d'attente (source) pour les messages ne pouvant pas être traités avec succès. Vous pouvez mettre de côté et isoler ces messages dans la file d'attente de lettres mortes pour déterminer pourquoi leur traitement a échoué. Vous devez configurer individuellement chaque file d'attente source qui envoie des messages à une file d'attente de lettres mortes. Plusieurs files d'attente peuvent cibler une seule file d'attente de lettre morte. Dans cet exemple, un module Node.js est utilisé pour acheminer des messages vers une file d'attente de lettres mortes. Le module Node.js utilise le SDK pour utiliser les files JavaScript d'attente en lettres mortes en utilisant cette méthode de la classe `AWS.SQS` client : + [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#setQueueAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#setQueueAttributes-property) Pour plus d'informations sur les files d'attente d'Amazon SQS, consultez la section Utilisation des files d'attente d'[Amazon SQS Dead Letter dans le guide du développeur *Amazon* Simple Queue](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) Service. ## Tâches prérequises Pour configurer et exécuter cet exemple, vous devez d'abord : + Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org). + Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md). + Créez une file d'attente Amazon SQS qui servira de file d'attente lettre morte. Pour obtenir un exemple de création de file d'attente, consultez [Utilisation des files d'attente dans Amazon SQS](sqs-examples-using-queues.md). ## Configuration de files d'attente source Après avoir créé une file d'attente comme file d'attente de lettres mortes, vous devez configurer les autres files d'attente qui acheminent des messages non traités vers la file d'attente de lettres mortes. Pour ce faire, spécifiez une stratégie de redirection identifiant la file d'attente à utiliser comme file d'attente de lettres mortes, et le nombre maximum de réceptions pour les messages individuels avant que ces derniers soient acheminés vers la file d'attente de lettres mortes. Créez un module Node.js nommé `sqs_deadletterqueue.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à Amazon SQS, créez un objet de `AWS.SQS` service. Créez un objet JSON contenant les paramètres obligatoires pour mettre à jour les attributs de file d'attente, en incluant le paramètre `RedrivePolicy` qui spécifie à la fois l'ARN de la file d'attente de lettres mortes et la valeur `maxReceiveCount`. Spécifiez également l'URL de file d'attente source que vous souhaitez configurer. Appelez la méthode `setQueueAttributes`. ``` // Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the SQS service object var sqs = new AWS.SQS({ apiVersion: "2012-11-05" }); var params = { Attributes: { RedrivePolicy: '{"deadLetterTargetArn":"DEAD_LETTER_QUEUE_ARN","maxReceiveCount":"10"}', }, QueueUrl: "SOURCE_QUEUE_URL", }; sqs.setQueueAttributes(params, function (err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } }); ``` Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. ``` node sqs_deadletterqueue.js ``` Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_deadletterqueue.js).