La AWS SDK pour JavaScript v2 est arrivée end-of-support. Nous vous recommandons de migrer vers la [AWS SDK pour JavaScript version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Pour plus de détails et d'informations sur la façon de migrer, veuillez consulter cette [annonce](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# 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).