7.6. 用途
7.6.1. 静的認証情報とデフォルトの認証情報プロバイダーの比較
useDefaultCredentialsProvider
オプションを指定し、これを true に設定することにより、明示的な静的認証情報の使用を回避することが可能です。
-
Java system properties -
aws.accessKeyId
andaws.secretKey
-
環境変数:
AWS_ACCESS_KEY_ID
およびAWS_SECRET_ACCESS_KEY
。 - AWS STS の Web ID トークン。
- 共有認証情報および設定ファイル。
-
Amazon ECS コンテナー認証情報 - 環境変数
AWS_CONTAINER_CREDENTIALS_RELATIVE_URI
が設定されている場合は、Amazon ECS からロードされます。 - Amazon EC2 インスタンスプロファイルの認証情報。
これに関する詳細情報は、AWS 認証情報のドキュメント を参照してください。
7.6.2. SQS プロデューサーによって設定されるメッセージヘッダー
ヘッダー | タイプ | 説明 |
---|---|---|
|
| Amazon SQS メッセージの MD5 チェックサム。 |
|
| Amazon SQS メッセージ ID。 |
|
| Amazon SQS メッセージが他のユーザーに表示される遅延秒数。 |
7.6.3. SQS コンシューマーによって設定されるメッセージヘッダー
ヘッダー | タイプ | 説明 |
---|---|---|
|
| Amazon SQS メッセージの MD5 チェックサム。 |
|
| Amazon SQS メッセージ ID。 |
|
| Amazon SQS メッセージ受信ハンドル。 |
|
| Amazon SQS メッセージ属性。 |
7.6.4. 高度な AmazonSQS 設定
Camel アプリケーションがファイアウォールの背後で実行されている場合、または SqsClient
インスタンス設定をより詳細に制御する必要がある場合は、独自のインスタンスを作成できます。
from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5") .to("mock:result");
7.6.5. SQS キューの作成または更新
SQS コンポーネントでは、エンドポイントが開始されると、チェックが実行され、キューの存在に関する情報が取得されます。SQSConfiguration
オプションを使用して QueueAttributeName
マッピングを介して作成をカスタマイズできます。
from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5") .to("mock:result");
この例では、AWS で MyQueue
キューがまだ作成されていない場合 (および autoCreateQueue
オプションが true に設定されている場合)、SQS 設定のデフォルトパラメーターで作成されます。すでに AWS で稼働している場合は、SQS 設定オプションを使用して既存の AWS 設定をオーバーライドします。
7.6.6. 単一メッセージの DelayQueue VS 遅延
オプション delayQueue
が true に設定されている場合、SQS キューは DelaySeconds
オプションが遅延として指定された DelayQueue
になります。DelayQueue
の詳細については、AWS SQS のドキュメント を参照してください。考慮すべき重要な情報の 1 つは、次のとおりです。
- 標準キューの場合、キューごとの遅延設定は遡及的ではありません。設定を変更しても、すでにキューにあるメッセージの遅延には影響しません。
- FIFO キューの場合、キューごとの遅延設定は遡及的です。設定を変更すると、すでにキューにあるメッセージの遅延に影響します。
公式ドキュメントに記載されているとおりです。単一のメッセージに遅延を指定する場合は、delayQueue
オプションを無視できますが、エンキューされたすべてのメッセージに固定遅延を追加する必要がある場合は、このオプションを true に設定できます。
7.6.7. サーバー側の暗号化
キューには一連のサーバー側暗号化属性があります。関連するオプションは、serverSideEncryptionEnabled
、keyMasterKeyId
、および kmsDataKeyReusePeriod
です。SSE はデフォルトで無効になっています。オプションを明示的に true に設定し、関連するパラメーターをキュー属性として設定する必要があります。