[Documentation] Document how to use the CreateIndexRequest, particularly the mappings

[cyrille-leclerc]

Description

Could you please provide an example on how to use the CreateIndexRequest API, particularly how to define the mappings?

I didn't catch how to use the CreateIndexRequest.Builder#mappings() API to do something like

PUT /logs
{"mappings": {
    "properties": {
      "@timestamp": { "type": "date" },
      "message": { "type": "match_only_text" }
    }
  }
}

[swallez]

Good catch, match_only_text is missing from the API specification. I opened elastic/elasticsearch-specification#1548 to fix this.

If you use text instead, that would be:

client.indices().create(r -> r
    .index("logs")
    .mappings(m -> m
        .properties("@timestamp", p -> p.date(d -> d))
        .properties("message", p -> p.text(t -> t))
    )
);

[swallez]

This has been fixed in the API specification in elastic/elasticsearch-specification#1549 and in the Java client in 2b5f3d2.