Add descriptions for final cat APIs

[lcawl]

This PR pulls descriptions from these docs:

• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-segments.html
• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-shards.html
• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-snapshots.html
• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-tasks.html
• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-templates.html
• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-thread-pool.html
• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-trained-model.html
• https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-transforms.html

NOTE: I changed parent_task?: long to parent_task_id?: string in cat tasks due to local tests.

[sethmlarson]

To not bottle-neck these reviews, I'm going to assign @elastic/clients-team as a reviewer :) Anyone should be able to pick these up.

[github-actions]

Following you can find the validation results for the APIs you have changed.

API	Status	Request	Response
cat.ml_data_frame_analytics	🟢	5/5	5/5
cat.ml_datafeeds	🟢	4/4	4/4
cat.ml_jobs	🟢	4/4	4/4
cat.ml_trained_models	🟢	1/1	1/1
cat.nodes	🟢	11/11	11/11
cat.segments	🟢	9/9	9/9
cat.shards	🟢	10/10	10/10
cat.snapshots	🟢	4/4	4/4
cat.tasks	🟢	11/11	11/11
cat.templates	🟢	14/14	14/14
cat.thread_pool	🟢	9/9	9/9
cat.transforms	🟢	5/5	5/5
ml.clear_trained_model_deployment_cache	🟢	1/1	1/1
ml.close_job	🟢	64/64	63/63
ml.delete_calendar_event	🟢	4/4	4/4
ml.delete_calendar_job	🟢	3/3	3/3
ml.delete_calendar	🟢	5/5	5/5
ml.delete_data_frame_analytics	🟢	2/2	2/2
ml.delete_datafeed	🟢	3/3	3/3
ml.delete_expired_data	🟢	5/5	5/5
ml.delete_filter	🟢	27/27	27/27
ml.delete_forecast	🟢	3/3	3/3
ml.delete_job	🟢	47/47	47/47
ml.delete_model_snapshot	🟢	2/2	2/2
ml.delete_trained_model_alias	🟢	3/3	3/3
ml.delete_trained_model	🟢	3/3	3/3
ml.estimate_model_memory	🟢	16/16	16/16
ml.evaluate_data_frame	🟢	22/22	22/22
ml.explain_data_frame_analytics	🟢	7/7	7/7
ml.flush_job	🟢	15/15	15/15
ml.forecast	🟢	1/1	1/1
ml.get_buckets	🟢	14/14	14/14
ml.get_calendar_events	🟢	17/17	17/17
ml.get_calendars	🟢	17/17	17/17
ml.get_categories	🟢	12/12	12/12
ml.get_data_frame_analytics_stats	🟢	12/12	12/12
ml.get_data_frame_analytics	🔴	17/17	14/17
ml.get_datafeed_stats	🟢	27/27	27/27
ml.get_datafeeds	🟢	20/20	20/20
ml.get_filters	🟢	13/13	13/13
ml.get_influencers	🟢	11/11	11/11
ml.get_job_stats	🟢	32/32	32/32
ml.get_jobs	🟢	31/31	31/31
ml.get_memory_stats	🟢	6/6	6/6
ml.get_model_snapshot_upgrade_stats	🟢	3/3	3/3
ml.get_model_snapshots	🟢	18/18	18/18
ml.get_overall_buckets	🟢	16/16	15/15
ml.get_records	🟢	8/8	8/8
ml.get_trained_models_stats	🔴	17/17	10/17
ml.get_trained_models	🔴	26/32	32/32
ml.infer_trained_model	🔴	10/10	6/10
ml.info	🟢	10/10	10/10
ml.open_job	🟢	83/83	83/83
ml.post_calendar_events	🟢	21/21	21/21
ml.post_data	🔴	9/11	14/18
ml.preview_data_frame_analytics	🟢	3/3	3/3
ml.preview_datafeed	🔴	10/17	17/17
ml.put_calendar_job	🔴	11/12	12/12
ml.put_calendar	🟢	135/135	135/135
ml.put_data_frame_analytics	🔴	32/33	32/33
ml.put_datafeed	🔴	70/71	71/71
ml.put_filter	🟢	27/27	27/27
ml.put_job	🔴	219/227	225/225
ml.put_trained_model_alias	🟢	12/12	12/12
ml.put_trained_model_definition_part	⚪	Missing test	Missing test
ml.put_trained_model_vocabulary	⚪	Missing test	Missing test
ml.put_trained_model	🟢	5/5	5/5
ml.reset_job	🟢	2/2	2/2
ml.revert_model_snapshot	🟢	2/2	2/2
ml.set_upgrade_mode	🟢	6/6	6/6
ml.start_data_frame_analytics	🟢	1/1	1/1
ml.start_datafeed	🟢	24/24	24/24
ml.start_trained_model_deployment	🔴	6/13	13/13
ml.stop_data_frame_analytics	🟢	5/5	5/5
ml.stop_datafeed	🟢	17/17	17/17
ml.stop_trained_model_deployment	🟢	10/10	10/10
ml.update_data_frame_analytics	🟢	2/2	2/2
ml.update_datafeed	🟢	7/7	7/7
ml.update_filter	🟢	3/3	3/3
ml.update_job	🔴	4/5	5/5
ml.update_model_snapshot	🟢	3/3	3/3
ml.update_trained_model_deployment	🟠	Missing type	Missing type
ml.upgrade_job_snapshot	🟢	3/3	3/3
ml.validate_detector	🟢	2/2	2/2
ml.validate	🟢	3/3	3/3

You can validate these APIs yourself by using the make validate target.

[droberts195]

ML parts LGTM