WARNING: Version 5.6 of Elasticsearch has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Field Capabilities API
editField Capabilities API
editThis functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
The field capabilities API allows to retrieve the capabilities of fields among multiple indices.
The field capabilities api by default executes on all indices:
GET _field_caps?fields=rating
- but the request can also be restricted to specific indices:
GET twitter/_field_caps?fields=rating
Alternatively the fields
option can also be defined in the request body:
POST _field_caps { "fields" : ["rating"] }
This is equivalent to the previous request.
Supported request options:
|
A list of fields to compute stats for. The field name supports wildcard notation. For example, using |
Field Capabilities
editThe field capabilities api returns the following information per field:
|
Whether this field is indexed for search on all indices. |
|
Whether this field can be aggregated on all indices. |
|
The list of indices where this field has the same type, or null if all indices have the same type for the field. |
|
The list of indices where this field is not searchable, or null if all indices have the same definition for the field. |
|
The list of indices where this field is not aggregatable, or null if all indices have the same definition for the field. |
Response format
editRequest:
GET _field_caps?fields=rating,title
{ "fields": { "rating": { "long": { "searchable": true, "aggregatable": false, "indices": ["index1", "index2"], "non_aggregatable_indices": ["index1"] }, "keyword": { "searchable": false, "aggregatable": true, "indices": ["index3", "index4"], "non_searchable_indices": ["index4"] } }, "title": { "text": { "searchable": true, "aggregatable": false } } } }