cat.asciidoc 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. [[breaking_50_cat_api]]
  2. === CAT API changes
  3. ==== Use Accept header for specifying response media type
  4. Previous versions of Elasticsearch accepted the Content-type header
  5. field for controlling the media type of the response in the cat API.
  6. This is in opposition to the HTTP spec which specifies the Accept
  7. header field for this purpose. Elasticsearch now uses the Accept header
  8. field and support for using the Content-Type header field for this
  9. purpose has been removed.
  10. ==== Host field removed from the cat nodes API
  11. The `host` field has been removed from the cat nodes API as its value
  12. is always equal to the `ip` field. The `name` field is available in the
  13. cat nodes API and should be used instead of the `host` field.
  14. ==== Changes to cat recovery API
  15. The fields `bytes_recovered` and `files_recovered` have been added to
  16. the cat recovery API. These fields, respectively, indicate the total
  17. number of bytes and files that have been recovered.
  18. The fields `total_files` and `total_bytes` have been renamed to
  19. `files_total` and `bytes_total`, respectively.
  20. Additionally, the field `translog` has been renamed to
  21. `translog_ops_recovered`, the field `translog_total` to
  22. `translog_ops` and the field `translog_percent` to
  23. `translog_ops_percent`. The short aliases for these fields are `tor`,
  24. `to`, and `top`, respectively.
  25. ==== Changes to cat nodes API
  26. The cat nodes endpoint returns `m` for master eligible, `d` for data,
  27. and `i` for ingest. A node with no explicit roles will be a coordinating
  28. only node and marked with `-`. A node can have multiple roles. The
  29. master column has been adapted to return only whether a node is the
  30. current master (`*`) or not (`-`).