Salesforce Docs Portal

Amazon SQS Connector 5.12 のトラブルシューティング

Amazon SQS 用 Anypoint Connector (Amazon SQS Connector) のトラブルシューティングを行うには、よくスローされる例外メッセージの解釈に関する情報を理解しておきます。

Unresolved include directive in modules/ROOT/pages/amazon-sqs-connector-troubleshooting.adoc - include::connectors::partial$ssl-logs.adoc[]

Unresolved include directive in modules/ROOT/pages/amazon-sqs-connector-troubleshooting.adoc - include::connectors::partial$verbose-exception-logs.adoc[]

Unresolved include directive in modules/ROOT/pages/amazon-sqs-connector-troubleshooting.adoc - include::connectors::partial$verbose-logs-org.adoc[]

AWS STS リージョンエンドポイント

AWS SDK v2 では、​AssumeRoleConnectionProvider​ の STS クライアントがセッショントークンを取得するために使用するエンドポイントがグローバルエンドポイントではなくリージョンエンドポイントになりました。詳細は、 「AWS STS リージョンエンドポイント」​ドキュメントを参照してください。 「AWS Security Token Service エンドポイントとクォータ」​ドキュメントで説明されているように、リージョンエンドポイントでコネクタの機能は変更されません。 AWS では、STS リージョンエンドポイントを使用してレイテンシーを短縮して、冗長性を組み込み、セッショントークンの検証を増やすことを推奨しています。

リージョンエンドポイントに変更することで問題が発生した場合、コネクタの ​[Global Elements (グローバル要素)]​ プロパティ設定ウィンドウの ​[Advanced (詳細)]​ タブにある ​[Custom STS Endpoint (カスタム SQS エンドポイント)]​ 項目で URL エンドポイント ​https://sts.amazonaws.com​ を指定して、強制的に Amazon SQS Connector でグローバルエンドポイントを使用させることができます。

スローされる一般的な例外メッセージの理解

スローされる一般的な例外メッセージとその解釈方法のリストを次に示します。

  • SQS:ACCESS_DENIED

    ユーザーにこの操作を実行するための権限がありません。

  • SQS:CONNECTIVITY

    Amazon SQS サーバーへの接続が中断されました。

  • SQS:INTERNAL_FAILURE

    不明なエラー、例外、または障害のために要求が失敗しました。

  • SQS:INVALID_CREDENTIALS

    無効なログイン情報が原因で Amazon SQS サーバーに対する認証に失敗しました。

  • SQS:INVALID_DATA

    [Test Queue ARN (キュー ARN をテスト)] パラメーターが設定されていないため、テスト接続を実行できません。

  • SQS:MESSAGE_NOT_IN_FLIGHT

    指定されたメッセージはインフライト状態ではありません。

  • SQS:MESSAGE_SIZE_THRESHOLD_OUT_OF_RANGE

    メッセージしきい値サイズが 0 ～ 256 KB ではありません。

  • SQS:OPT_IN_REQUIRED

    AWS アクセスキー ID には、サービスのサブスクリプションが必要です。

  • SQS:OVER_LIMIT

    試行されたアクションが制限を超えています。たとえば、Recieve Messages ソースでインフライトメッセージの最大数を受信した場合や、Add Permission 操作でキューの権限の最大数に達した場合です。

  • SQS:PARAMETER_OUT_RANGE

    値が、指定された範囲内にありません。

  • SQS:PURGE_QUEUE_IN_PROGRESS

    指定されたキューが過去 60 秒以内に [Purge Queue (キューをパージ)] 要求を受信しました。

  • SQS:QUEUE_ALREADY_EXISTS

    この名前のキューがすでに存在し、この名前の既存のキューとは異なる属性が要求に含まれます。

  • SQS:QUEUE_DELETED_RECENTLY

    同じ名前のキューが過去 60 秒以内に削除されました。

  • SQS:REQUEST_EXPIRED

    要求の日付スタンプまたは要求の有効期限から 15 分以上経過した後に要求がサービスに到達したか、要求の日付スタンプが 15 分以上先になっています。

  • SQS:RETRY_EXHAUSTED

    特定の実行ブロックの再試行回数の上限に達しました。

  • SQS:S3_BUCKET_ACCESS_DENIED

    サーバーから AmazonSQSException が 403 HTTP 状況コードと共に返されました。

  • SQS:S3_BUCKET_NOT_FOUND

    サーバーから AmazonSQSException が 404 HTTP 状況コードと共に返されました。

  • SQS:SERVICE_UNAVAILABLE

    サーバーで一時的な障害が発生しています。

  • SQS:THROTTLING_EXCEPTION

    要求調整が原因で要求が失敗しました。

関連情報