AWS SDK for JavaScript v2 はサポート終了となりました。[AWS SDK for JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) に移行することをお勧めします。その他の詳細、移行方法については、こちらの[発表内容](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)を参照してください。
# Amazon SNS でのトピックの管理
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/ja_jp/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**この Node.js コード例は以下を示しています。**
+ 通知を発行できる Amazon SNS でトピックを作成する方法。
+ Amazon SNS で作成されたトピックを削除する方法。
+ 利用可能なトピックの一覧を取得する方法。
+ トピック属性を取得および設定する方法。
## シナリオ
この例では、一連の Node.js モジュールを使用して Amazon SNS トピックを作成、一覧表示、および削除し、トピック属性を処理します。Node.js モジュールは、`AWS.SNS` クライアントクラスの以下のメソッドを使用してトピックを管理するために SDK for JavaScript を使用します。
+ [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)
## 前提条件タスク
この例をセットアップして実行するには、まず次のタスクを完了する必要があります。
+ Node.js をインストールします。Node.js をインストールする方法の詳細については、[Node.js ウェブサイト](http://nodejs.org)を参照してください。
+ ユーザーの認証情報を使用して、共有設定ファイルを作成します。認証情報 JSON ファイルの提供の詳細については、「[共有認証情報ファイルから Node.js に認証情報をロードする](loading-node-credentials-shared.md)」を参照してください。
## トピックの作成
この例では、Node.js モジュールを使用して Amazon SNS トピックを作成します。`sns_createtopic.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を設定します。
`Name` クライアントクラスの `createTopic` メソッドに新しいトピックの `AWS.SNS` を渡すためのオブジェクトを作成します。`createTopic` メソッドを呼び出すには、Amazon SNS サービスオブジェクトを呼び出すための promise を作成し、パラメータオブジェクトを渡します。その後、promise コールバックの `response` を処理します。promise によって返される `data` には、トピックの ARN が含まれています。
```
// 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);
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sns_createtopic.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_createtopic.js)にあります。
## トピックの一覧表示
この例では、Node.js モジュールを使用してすべての Amazon SNS トピックを一覧表示します。`sns_listtopics.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を設定します。
`listTopics` クライアントクラスの `AWS.SNS` メソッドに渡す空のオブジェクトを作成します。`listTopics` メソッドを呼び出すには、Amazon SNS サービスオブジェクトを呼び出すための promise を作成し、パラメータオブジェクトを渡します。その後、promise コールバックの `response` を処理します。promise によって返される `data` には、トピックの ARN の配列が含まれています。
```
// 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);
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sns_listtopics.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_listtopics.js)にあります。
## トピックの削除
この例では、Node.js モジュールを使用して Amazon SNS トピックを削除します。`sns_deletetopic.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を設定します。
`TopicArn` クライアントクラスの `deleteTopic` メソッドに渡すために、削除するトピックの `AWS.SNS` を含むオブジェクトを作成します。`deleteTopic` メソッドを呼び出すには、Amazon SNS サービスオブジェクトを呼び出すための promise を作成し、パラメータオブジェクトを渡します。その後、promise コールバックの `response` を処理します。
```
// 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);
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sns_deletetopic.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_deletetopic.js)にあります。
## トピック属性の取得
この例では、Node.js モジュールを使用して Amazon SNS トピックの属性を取得します。`sns_gettopicattributes.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を設定します。
`TopicArn` クライアントクラスの `getTopicAttributes` メソッドに渡すために、削除するトピックの `AWS.SNS` を含むオブジェクトを作成します。`getTopicAttributes` メソッドを呼び出すには、Amazon SNS サービスオブジェクトを呼び出すための promise を作成し、パラメータオブジェクトを渡します。その後、promise コールバックの `response` を処理します。
```
// 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);
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sns_gettopicattributes.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_gettopicattributes.js)にあります。
## トピック属性の設定
この例では、Node.js モジュールを使用して Amazon SNS トピックの変更可能な属性を設定します。`sns_settopicattributes.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を設定します。
属性を設定するトピックの `TopicArn`、設定する属性の名前、およびその属性の新しい値など、属性の更新のパラメータを含むオブジェクトを作成します。`Policy`、`DisplayName`、および `DeliveryPolicy` 属性のみ設定できます。`setTopicAttributes` クライアントクラスの `AWS.SNS` メソッドにパラメータを渡します。`setTopicAttributes` メソッドを呼び出すには、Amazon SNS サービスオブジェクトを呼び出すための promise を作成し、パラメータオブジェクトを渡します。その後、promise コールバックの `response` を処理します。
```
// 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);
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sns_settopicattributes.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_settopicattributes.js)にあります。