[Recipes] Creating Elasticsearch Index and Adding Documents

​Creating an index using PUT

PUT /employee?pretty

Will get a success response.

Verifying the index with _cat/indices

GET /_cat/indices?v

Creating a Document Specifying ID

PUT /employee/_doc/1?pretty
{
  "name": "Heartin",
  "salary": 10000000
}

Examine the response. It should be similar to:

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

You may also verify using the id returned:

GET /employee/_doc/1?pretty

Creating a Document Without Specifying ID

You may also create a document without specifying an ID using POST

POST /employee/_doc
{
  "name": "Sneha"
}

Error Cases

1. Try using PUT to create doc without specifying id.

   1. Request:
      PUT /employee/_doc
      {
        "name": "Deny"
      }

   2. Response:
      {
        "error": "Incorrect HTTP method for uri [/employee/_doc] and method [PUT], allowed: [POST]",
        "status": 405
      }

2. Try doing POST to /employee/

   1. Request:
      POST /employee/
      {
        "name": "Deny"
      }

   2. Response:
      {
        "error": "Incorrect HTTP method for uri [/employee/] and method [POST], allowed: [PUT, GET, DELETE, HEAD]",
        "status": 405
      }

   3. Try to do a POST with a different type field

      1. Request:
         POST /employee/another
         {
           "name": "Deny"
         }

      2. Response:
         ...
         "illegal_argument_exception",
             "reason": "Rejecting mapping update to [employee] as the final mapping would have more than 1 type: [_doc, another]"
           },
           "status": 400