すべてのプロダクト
Search

このプロダクト

    Elasticsearch:Postman を使用して Alibaba Cloud Elasticsearch クラスターにアクセスし、管理する

    ドキュメントセンター

    Elasticsearch:Postman を使用して Alibaba Cloud Elasticsearch クラスターにアクセスし、管理する

    最終更新日:Jan 11, 2025

    オープンソースの Elasticsearch は、さまざまな RESTful API を提供しています。 curl コマンドを実行してこれらの API を呼び出すか、Kibana または Postman でこれらの API を使用できます。このトピックでは、Postman を使用して Alibaba Cloud Elasticsearch クラスターにアクセスし、管理する方法について説明します。

    前提条件

    • Postman がインストールされていること。

      説明

      • この例では、Postman 10.16.9 クライアントを使用しています。 Postman コンソールの GUI 要素は、Postman クライアントのバージョンによって異なる場合があります。

      • Postman をダウンロードするには、Postman のダウンロード にアクセスしてください。

    • Alibaba Cloud Elasticsearch クラスターが作成され、Elasticsearch クラスターに対してパブリックネットワークアクセス機能が有効になっており、Postman がインストールされているデバイスの IP アドレスが Elasticsearch クラスターのパブリック IP アドレスホワイトリストに追加されていること。

      説明

    手順

    1. Postman コンソールにログインします。

    2. 左側のナビゲーションペインで、[新規] をクリックし、[ワークスペース] を選択します。表示されるページで、[ワークスペースの作成] をクリックしてワークスペースを作成します。

      この例では、test-workspaces という名前のワークスペースが作成されます。

    3. 環境を作成し、その環境に切り替えます。

      1. 左側のナビゲーションペインで、[環境] をクリックし、image.png アイコンをクリックして環境を作成します。この例では、aliyun_Environment という名前の環境が作成されます。

      2. ページの右上隅で、aliyun_Environment 環境を選択します。

      説明

      環境の詳細については、環境の管理 をご参照ください。

    4. コレクション を作成します。

      1. 左側のナビゲーションペインで、[コレクション] をクリックし、image.png アイコンをクリックします。 [新しいコレクション] フィールドに、コレクションの名前を入力します。この例では、ES Collection という名前のコレクションが作成されます。

      2. [ES Collection] ページで、[認証] タブをクリックし、認証情報を設定します。

        • [タイプ]: [Basic 認証] を選択します。

        • [ユーザー名]: Elasticsearch クラスターのユーザー名である elastic を入力します。

        • [パスワード]: Elasticsearch クラスターのパスワードを入力します。

    5. リクエスト を作成します。

      • ページの左側で、[ES Collection] をクリックします。次に、[リクエストを追加] をクリックします。 [新しいリクエスト] フィールドに、リクエストの名前を入力します。この例では、ES Request という名前のリクエストが作成されます。

      • [ES Request] ページで、[認証] タブをクリックします。 [認証] タブで、[タイプ] パラメーターに [Basic 認証] を選択します。

      説明

      コレクション内に複数のリクエストを作成できます。コレクション内に複数のリクエストを作成する場合は、各リクエストの [認証] タブで [タイプ] パラメーターに [Basic 認証] を選択する必要があります。

    6. [ES Request] ページで、リクエストを実行します。

      1. GET、POST、PUT などのリクエストメソッドを選択します。

      2. http://<Elasticsearch クラスターのパブリックエンドポイント>:<パブリックポート>/<パス>/<クエリパラメーター> 形式の URL を入力します。

      3. オプション。リクエストボディを入力します。 [本文] タブをクリックします。 [本文] タブで、[raw] を選択し、ドロップダウンリストから JSON を選択します。コードエディターで、リクエストボディを入力します。

      4. 入力した URL の横にある [送信] をクリックしてリクエストを実行します。

      image.png

      説明

    Elasticsearch クラスターを管理するためのコマンド

    このセクションでは、Elasticsearch クラスターの管理に使用できるコマンドについて説明します。その他のコマンドについては、オープンソースの Elasticsearch ドキュメント をご参照ください。

    クラスター情報の表示

    • Elasticsearch クラスターのヘルスステータスをクエリするには、次のコマンドを実行します。

      GET
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/_cat/health?v

    • Elasticsearch クラスターのインデックスをクエリするには、次のコマンドを実行します。

      GET
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/_cat/indices?v

    インデックスとドキュメントの作成

    1. インデックスを作成します。

      product_info という名前のインデックスを作成するには、次のコマンドを実行します。

      PUT
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/product_info

    2. インデックスのマッピングを設定するには、次のコマンドを実行します。

      PUT
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/product_info/_mapping
{
   "properties": {
       "productName": {"type": "text","analyzer": "ik_smart"},
       "annual_rate":{"type":"keyword"},
       "describe": {"type": "text","analyzer": "ik_smart"}
      }
}

    3. ドキュメントを作成し、ドキュメントにデータレコードを挿入します。

      • 単一のドキュメントを作成し、ドキュメントにデータレコードを挿入します。

        product_info インデックスに 1 という名前のドキュメントを作成し、ドキュメントにデータレコードを挿入するには、次のコマンドを実行します。

        • POST
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/product_info/_doc/1
{
"productName":"testpro",
"annual_rate":"3.22%",
"describe":"testpro"
}

      • 複数のドキュメントを作成し、各ドキュメントにデータレコードを挿入します。

        product_info インデックスに 1 という名前のドキュメントと 2 という名前の別のドキュメントを作成し、各ドキュメントにデータレコードを挿入するには、次のコマンドを実行します。

        POST
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/_bulk
{ "index" : { "_index": "product_info", "_id" : "1" } }
{"productName":"testpro","annual_rate":"3.22%","describe":"testpro"}
{ "index" : { "_index": "product_info", "_id" : "2" } }
{"productName":"testpro1","annual_rate":"3.26%","describe":"testpro"}

        Postman コンソールで bulk API を呼び出して複数のドキュメントにデータレコードを挿入する場合は、各ドキュメントにデータレコードを挿入するための各コード行の末尾に改行を使用し、コードブロック全体の最後の行が空であることを確認する必要があります。

        image.png

    ドキュメントの検索

    1 という名前のドキュメントを検索するには、次のコマンドを実行します。

    GET
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/product_info/_doc/1?pretty

    インデックスの削除

    product_info という名前のインデックスを削除するには、次のコマンドを実行します。

    DELETE
http://es-xxxxx.public.elasticsearch.aliyuncs.com:9200/product_info