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 SQS でのキューの使用
![\[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 コード例は以下を示しています。**
+ すべてのメッセージキューのリストを取得する方法
+ 特定のキューの URL を取得する方法
+ キューを作成および削除する方法
## 例について
この例では、一連の Node.js モジュールは、キューの操作に使用されます。Node.js モジュールは SDK for JavaScript を使用して、キューが `AWS.SQS` クライアントクラスの次のメソッドを呼び出せるようにします。
+ [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)
Amazon SQS メッセージの詳細については、*Amazon Simple Queue Service デベロッパーガイド*の[キューの仕組み](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-how-it-works.html)を参照してください。
## 前提条件タスク
この例をセットアップして実行するには、まず次のタスクを完了する必要があります。
+ Node.js をインストールします。Node.js をインストールする方法の詳細については、[Node.js ウェブサイト](https://nodejs.org)を参照してください。
+ ユーザーの認証情報を使用して、共有設定ファイルを作成します。共有認証情報ファイルの提供の詳細については、[共有認証情報ファイルから Node.js に認証情報をロードする](loading-node-credentials-shared.md) を参照してください。
## キューの一覧表示
`sqs_listqueues.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を必ず設定します。Amazon SQS にアクセスするには、`AWS.SQS` サービスオブジェクトを作成します。キューの一覧表示に必要なパラメータを含む JSON オブジェクトを作成します。これはデフォルトでは空のオブジェクトになります。`listQueues` メソッドを呼び出して、キューの一覧を取得します。コールバックは、すべてのキューの URL を返します。
```
// 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);
}
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sqs_listqueues.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_listqueues.js)にあります。
## キューの作成
`sqs_createqueue.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を必ず設定します。Amazon SQS にアクセスするには、`AWS.SQS` サービスオブジェクトを作成します。キューの一覧表示に必要なパラメータを含む JSON オブジェクトを作成します。これには、作成したキューの名前を含める必要があります。パラメータには、メッセージ配信が遅延する秒数や、受信したメッセージを保持する秒数など、キューの属性も含めることができます。`createQueue` メソッドを呼び出します。コールバックは、作成したキューの URL を返します。
```
// 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);
}
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sqs_createqueue.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_createqueue.js)にあります。
## キューの URL の取得
`sqs_getqueueurl.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を必ず設定します。Amazon SQS にアクセスするには、`AWS.SQS` サービスオブジェクトを作成します。キューの一覧表示に必要なパラメータを含む JSON オブジェクトを作成します。これには、必要な URL を持つキューの名前を含める必要があります。`getQueueUrl` メソッドを呼び出します。コールバックは、指定したキューの URL を返します。
```
// 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);
}
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sqs_getqueueurl.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_getqueueurl.js)にあります。
## キューの削除
`sqs_deletequeue.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を必ず設定します。Amazon SQS にアクセスするには、`AWS.SQS` サービスオブジェクトを作成します。キューの削除に必要なパラメータを含む JSON オブジェクトを作成します。これは、削除するキューの URL で構成されます。`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);
}
});
```
この例を実行するには、コマンドラインに次のように入力します。
```
node sqs_deletequeue.js
```
このサンプルコードは、[このGitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sqs/sqs_deletequeue.js)にあります。