Lindorm:Connect to and use the search engine with curl commands

Create an index

Create an index named lindorm_search with 4 primary shards:

curl -XPUT "http://ld-t4n5668xk31ui****-proxy-search-public.lindorm.rds.aliyuncs.com:30070/lindorm_search" \
  -u <username>:<password> \
  -H 'Content-Type: application/json' \
  -d '{
    "settings": {
      "number_of_shards": 4
    }
  }'

A successful operation returns:

{"acknowledged":true,"shards_acknowledged":true,"index":"lindorm_search"}

• acknowledged: Confirms the cluster processed the request.

• shards_acknowledged: Confirms all primary shards were started before the timeout.

• index: The name of the created index.

Set the index mapping

Define the field types for the lindorm_search index. The following example sets id as a long integer, name as a keyword, and describe as full-text:

curl -XPUT "http://ld-t4n5668xk31ui****-proxy-search-public.lindorm.rds.aliyuncs.com:30070/lindorm_search/_doc/_mapping" \
  -u <username>:<password> \
  -H 'Content-Type: application/json' \
  -d '{
    "_doc": {
      "properties": {
        "id":       {"type": "long"},
        "name":     {"type": "keyword"},
        "describe": {"type": "text"}
      }
    }
  }'

A successful operation returns:

{"_index":"lindorm_search","_type":"_doc","_id":"_mapping","_version":1,"result":"created","_shards":{"total":1,"successful":1,"failed":0},"_seq_no":0,"_primary_term":1}

List indexes

curl -XGET "http://ld-t4n5668xk31ui****-proxy-search-public.lindorm.rds.aliyuncs.com:30070/_cat/indices?v" \
  -u <username>:<password>

Example output:

health status index          uuid           pri rep docs.count docs.deleted store.size pri.store.size
green  open   lindorm_search lindorm_search   1   0          0            0       208b           208b

If no indexes exist, only the header row is returned.

Delete an index

curl -XDELETE "http://ld-t4n5668xk31ui****-proxy-search-public.lindorm.rds.aliyuncs.com:30070/lindorm_search" \
  -u <username>:<password>

A successful deletion returns:

{"acknowledged":true}

Index a single document

Index a document with ID 1 into lindorm_search:

curl -XPOST "http://ld-t4n5668xk31ui****-proxy-search-public.lindorm.rds.aliyuncs.com:30070/lindorm_search/_doc/1" \
  -u <username>:<password> \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 100,
    "name": "shenzhen",
    "describe": "just a test"
  }'

Index multiple documents

Use the bulk API to index multiple documents in a single request. Each document requires two lines: an action line and a source line.

curl -XPOST "http://ld-t4n5668xk31ui****-proxy-search-public.lindorm.rds.aliyuncs.com:30070/_bulk" \
  -u <username>:<password> \
  -H 'Content-Type: application/json' \
  -d '
{ "index": { "_index": "lindorm_search", "_type": "_doc", "_id": "1" } }
{"id":200,"name":"shanghai","describe":"just"}
{ "index": { "_index": "lindorm_search", "_type": "_doc", "_id": "2" } }
{"id":300,"name":"beijing","describe":"good luck"}
'

Use the bulk API when indexing large volumes of data — it reduces network overhead compared to individual requests.

Get a document by ID

Retrieve the document with ID 1:

curl -XGET "http://ld-t4n5668xk31ui****-proxy-search-public.lindorm.rds.aliyuncs.com:30070/lindorm_search/_doc/1?pretty" \
  -u <username>:<password>

Example output:

{
  "_index" : "lindorm_search",
  "_id" : "1",
  "_version" : 1,
  "_seq_no" : 0,
  "_primary_term" : 1,
  "found" : true,
  "_source" : {
    "id" : 100,
    "name" : "shenzhen",
    "describe" : "just a test"
  }
}

• found: true means the document exists.

• _version: Increments each time the document is updated.

• _source: The original document data you indexed.