AWS SQSPut - AWS SQSへ出力
Amazon Web ServicesのSQSへメッセージを出力します。
スタンダードキューとFIFOキューの両方に対応しています。キューの名前の最後が「.fifo」で終わっている場合はFIFOキューとして処理を行います。
■ストリーム情報
| 入力 | フォーマット | BINARY,TEXT,HTML,ParameterList,CSV,FixedLength,MIME,XML |
|---|---|---|
| 接続数 | 1 | |
| 説明 | エンコードするが「はい」の場合は入力ストリームの値をBase64エンコードしてSQSへ出力します。「いいえ」の場合は入力ストリームとしてはTextストリームのみを受け付け、入力ストリームのテキストをそのままSQSに出力します。 | |
| 出力 | フォーマット | BINARY,TEXT,HTML,ParameterList,CSV,FixedLength,MIME,XML |
| 説明 | 入力ストリームをそのまま出力します。 |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| コネクションを使用 | boolean | - |
接続情報に以下のコネクション名 を使用するかどうか選択します。
|
||||||
| コネクション名 | connection | - | コネクションを使用 が「はい」の場合に接続先のAWSを指定します。 コネクションペインまたは管理コンソールにて作成されたAWS接続名を選択します。 | ||||||
| コネクション情報 | group | - | コネクションを使用 が「いいえ」の場合に使用されるプロパティ群です。 | ||||||
| アクセスキー | string | 入力＆出力 |
アクセスキーを指定します。
サーバーがEC2インスタンス上にあり、アクセスキーを指定しない場合は、EC2インスタンスに設定されたIAMロールを使用します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| シークレットキー | password | 入力＆出力 |
シークレットキーを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| プロトコル | choice | 入力＆出力 |
FSMCで設定したプロキシーサーバーを使用する場合、「プロキシの設定」で設定されたプロキシ情報の選択に使用します。
コネクションを使用 が「いいえ」の場合、かつプロキシ設定を使用 が「はい」の場合、この設定を参照します。
|
||||||
| タイムアウト(秒) | int | 入力＆出力 |
リクエスト時およびコネクション接続時のソケットタイムアウト時間を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| リクエストタイムアウト(分) | int | 入力＆出力 |
1回のリクエスト実行のタイムアウトまでの時間を分単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| リージョン | choice | 入力＆出力 |
利用するAWSのリージョンを選択します。
選択肢にない場合はリージョンを表す文字列を入力することもできます。 例えば東京リージョンであれば ap-northeast-1を指定します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| AssumeRole ARN | string | 入力＆出力 |
一時的な認証情報を使用するためにAssumeRoleのARNを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| 一時的認証情報の有効期限(秒) | int | 入力＆出力 |
AssumeRole ARNで設定する一時的な認証情報の有効期限を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| プロキシ設定を使用 | boolean | 入力＆出力 |
管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
|
||||||
| キューURL | string | 入力＆出力 | キューURLを指定します。 | ||||||
| エンコードする | boolean | 入力＆出力 |
入力ストリームの値をBase64エンコードしてSQSへ出力するかどうかを指定します。
|
||||||
| メッセージグループID | string | 入力＆出力 | メッセージグループIDを指定します。 FIFOキューの場合に使用します。 | ||||||
| メッセージ重複削除IDの設定 | choice | - |
コンポーネントでメッセージ重複削除IDをどのように設定するかを指定します。
FIFOキューの場合に使用します。
|
||||||
| メッセージ重複削除ID | string | 入力＆出力 | メッセージ重複削除IDを指定します。 メッセージ重複削除IDの設定が「プロパティで指定」かつFIFOキューの場合に使用します。 | ||||||
| メッセージ属性 | category | 入力＆出力 |
メッセージ属性を設定します。
Binary、カスタムデータ型はサポートされません。
詳しくはAWSのサイトAmazon SQS メッセージ属性を参照ください。
設定例
|
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラメーター | エラー処理フロー へのストリーム | エラー コード | 説明 |
|---|---|---|---|---|
| 汎用 | なし | コンポーネントの入力ストリーム | 1 | コネクションの定義項目に不正な値があった場合 |
| 2 | エンコードするが「いいえ」で入力ストリームがTEXTでなかった場合 | |||
| 3 | FIFOキューの時に、メッセージグループIDが指定されていなかった場合 | |||
| 4 | メッセージ重複削除IDの設定が「プロパティで指定」かつFIFOキューの場合に、メッセージ重複削除IDが指定されていなかった場合 | |||
| 1001 | APIクライアントの初期化に失敗した場合 | |||
| 2003 | 入力ストリームからメッセージを作成するのに失敗した場合 | |||
| APIエラー | 「APIエラーの パラメーター」を 参照してください。 | コンポーネントの入力ストリーム | 201 | APIの実行でエラーコードを受け取った場合。 |
| 接続エラー | なし | コンポーネントの入力ストリーム | 301 | 接続に失敗した場合。 |
■APIエラーのパラメーター
APIエラーが発生したときに設定されるエラーのパラメーターです。
| No. | 名前 | 説明 |
|---|---|---|
| 1 | Code | AWSから取得したエラーコード。エラーの詳細につきましては、AWSのサイトを参照ください。 |
| 2 | Message | AWSから取得したエラーの内容。エラーの詳細につきましては、AWSのサイトを参照ください。 |
■キューURLの設定画面
コンポーネントをダブルクリックするか、右クリックメニューの「QueueBrowser」を実行することで、コンポーネントに設定されている接続情報を使用して画面が開きます。
この画面ではキューURL とキューの新規作成と削除を行うことができます。
「キュー」一覧
キューの一覧が表示されます。
このリストの中からコンポーネント設定するキューを選択します。
「キュー作成」ボタン
キューを作成するためのダイアログが表示されます。
FIFOキューを作成するには、キューの名前の最後を「.fifo」にします。
＊作成されたキューがリストに反映されるのには時間がかかる場合があります。
「キュー削除」ボタン
一覧で選択されているキューをSQSから削除します。
＊削除がリストに反映されるのには時間がかかる場合があります。
「リスト更新」ボタン
「キュー」一覧のリストを更新します。
このダイアログからキューの作成や削除を行った場合にリストに反映させるのに使用します。
属性情報
選択されているキューの属性情報が表示されます。
「OK」ボタン
リストで選択されたキューの情報をコンポーネントのキューURL プロパティに設定します。
「キャンセル」ボタン
このダイアログを閉じます。
コンポーネントのキューURL プロパティに変更はありません。