Amazon CloudSearch 向けドキュメントサービス API リファレンス - アマゾン CloudSearch

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

Amazon CloudSearch 向けドキュメントサービス API リファレンス

Amazon CloudSearch ドメインでドキュメントを追加、置換、削除するには、ドキュメントサービス API を使用します。検索ドメインのドキュメント管理の詳細については、「upload documents」を参照してください。

Amazon CloudSearch を操作するために使用するその他の API は次のとおりです。

Amazon CloudSearch でのドキュメントサービスリクエストの送信

重要

Amazon CloudSearch ドメインにデータをアップロードする前に、以下のガイドラインに従ってください。

  • ドキュメントをグループ化Batchをアップロードする前にアップロードしてください。1 つのドキュメントのみで構成されるバッチを継続的にアップロードすると、Amazon CloudSearch が更新を処理できる速度に大きな悪影響を及ぼします。代わりに、できるだけ制限に近いバッチを作成し、アップロード頻度を低くします。最大バッチサイズとアップロード頻度について詳しくは、Amazon を理解する CloudSearch 制限

  • ドメインのドキュメントエンドポイントと検索エンドポイントは、ドメインが存在している間変わりません。すべてのアップロードリクエストや検索リクエストの前にエンドポイントを取得するのではなく、エンドポイントをキャッシュに保存してください。を呼び出すことによって、Amazon CloudSearch 設定サービスにクエリを実行するaws cloudsearch describe-domainsまたはDescribeDomainsすべてのリクエストの前にを実行すると、リクエストが調整される可能性があります。

いずれかの AWS SDK を使用するか、AWS CLIをクリックして、ドキュメントのアップロードリクエストを送信します。SDKAWS CLIは、リクエスト署名を処理し、すべての Amazon CloudSearch アクションを簡単に実行する方法を提供します。Amazon CloudSearch コンソールを使用して、個々のバッチをアップロードし、DynamoDB または S3 からデータをインポートすることもできます。

たとえば、次のリクエストは、AWS CLI。

aws cloudsearchdomain --endpoint-url http://doc-movies-y6gelr4lv3jeu4rvoelunxsl2e.us-east-1.cloudsearch.amazonaws.com upload-documents --content-type application/json --documents movie-data-2013.json

開発およびテストの目的で、ドメインのドキュメントサービスへの匿名アクセスを許可し、署名されていない HTTP POST リクエストをドメインのドキュメントサービスに直接送信できます。実稼働環境では、ドメインへのアクセスを特定の IAM ユーザー、グループ、またはロールに制限し、署名付きリクエストを送信します。Amazon CloudSearch のアクセスの制御については、「」を参照してください。configure access policies。リクエストの署名の詳細については、「」を参照してください。AWS API リクエストの署名

たとえば、次の POST リクエストは、JSON でフォーマットされたドキュメントのバッチをドメインエンドポイントの doc-movies-123456789012.us-east-1.cloudsearch.amazonaws.com にアップロードします。

curl -X POST --upload-file data1.json doc-movies-123456789012.us-east-1.cloudsearch.amazonaws.com/2013-01-01/documents/batch --header "Content-Type: application/json"