翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon でのエラーの処理 CloudSearch

このセクションでは、 CloudSearch プログラムで Amazon を操作するときにエラーを処理する方法について説明します。Amazon CloudSearch のサービスから返される特定のエラーコードについては、以下を参照してください。

Amazon のエラータイプ CloudSearch

Amazon CloudSearch APIs によって返される HTTP ステータスコードは、リクエストが正常に完了したかどうか、またはリクエストの処理中にクライアントまたはサーバーエラーが発生したかどうかを示します。

HTTP ステータスコードは、リクエストごとに返されます。さらに、レスポンスの本文で、追加の警告およびエラー情報が提供されます。

search レスポンス内のメッセージは、深刻度レベル、警告またはエラーコード、および検索リクエストに関する問題の説明を示します。検索サービスによって返される警告およびエラーのリストについては、「検索レスポンスのプロパティ (JSON)」または「検索レスポンスの要素 (XML)」を参照してください。

documents/batch レスポンス内のエラーおよび警告は、ドキュメントデータの処理中に発生した解析および検証の問題に関する情報を提供します。詳細については、documents/batch レスポンス (JSON)またはdocuments/batch レスポンス (XML)を参照してください。

設定サービスのレスポンスで返されるエラーは、リクエストが 4xx または 5xx ステータスコードを返した原因に関する情報を提供します。すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。アクション固有のエラーは、「Amazon の設定APIリファレンス CloudSearch 」の「アクション」のトピックに一覧表示されています。

Amazon でのリクエストの再試行 CloudSearch

アプリケーションをスムーズに実行するには、エラーを見つけ、エラーに対応するロジックを組み込む必要があります。一般的な方法は、try ブロックまたは if-then ステートメント内にリクエストを実装することです。

すべてのサーバーエラー (5xx) を見つけて、再試行することをお勧めします。エラーはリクエストパイプライン内のどこでも生成される可能性があるため、特定のステータスコードに対する専用の処理方法だけでなく、予期しない 5xx エラーに対するフォールバックを実装する必要があります。

507 および 509 エラーは通常、検索サービスが過負荷であることを示しています。これは、送信しようとする検索リクエストのボリュームまたは複雑さに起因する可能性があります。Amazon CloudSearch は通常、負荷を処理するために自動的にスケーリングされます。追加の検索インスタンスのデプロイには時間がかかるため、エクスポネンシャルバックオフ再試行ポリシーを使用して、リクエストレートを一時的に下げてリクエストの失敗を最小限に抑えることをお勧めします。詳細については、「エラーの再試行とエクスポネンシャルバックオフ」を参照してください。

単一の小さな検索インスタンスに複雑な検索クエリを送信するなど、特定の使用パターンでは、自動スケーリングがトリガーされずにタイムアウトが発生することがあります。エラー率が繰り返し発生する場合は、Amazon CloudSearch サービス制限リクエストフォームから追加の容量を明示的にリクエストできます。

クライアントエラー (4xx) は通常、問題を解決するためにリクエストの修正が必要であることを示しています。単に同じリクエストを再試行するだけでは、ほとんどの場合、同じエラーで済みます。設定サービスで戻される 409 エラーは、リソース制限に達したためにリクエストが拒否されたことを示す場合があります。詳細については、「制限」を参照してください。