[OpenAPI] Add doc_tag to machine learning APIs (#2985) (#2990)

Author: github-actions[bot]

.spectral.yaml

@@ -28,7 +28,7 @@ rules:
   oas2-schema: warn
   # Tags
   openapi-tags: warn
-  openapi-tags-alphabetical: info
+  openapi-tags-alphabetical: false
   # Turn off some built-in rules
   operation-description: false
   operation-singular-tag: false

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -139,6 +139,24 @@ actions:
       # M
         - name: ml
           x-displayName: Machine learning
+        - name: ml anomaly
+          x-displayName: Machine learning anomaly detection
+          # description:
+          externalDocs:
+            url: https://www.elastic.co/guide/en/machine-learning/master/ml-ad-finding-anomalies.html
+            description: Finding anomalies
+        - name: ml data frame
+          x-displayName: Machine learning data frame analytics
+          # description:
+          externalDocs:
+            url: https://www.elastic.co/guide/en/machine-learning/master/ml-dfa-overview.html
+            description: Data frame analytics overview
+        - name: ml trained model
+          x-displayName: Machine learning trained model
+          # description:
+          externalDocs:
+            url: https://www.elastic.co/guide/en/machine-learning/master/ml-nlp-overview.html
+            description: Natural language processing overview
         - name: migration
           x-displayName: Migration
         - name: monitoring

output/openapi/elasticsearch-openapi.json

@@ -30,6 +30,7 @@ import { Id } from '@_types/common'
  * @availability stack since=8.5.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges manage_ml
+ * @doc_tag ml trained model
  */
 export interface Request extends RequestBase {
   path_parts: {

output/openapi/elasticsearch-serverless-openapi.json

@@ -32,6 +32,7 @@ import { Duration } from '@_types/Time'
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
  * @doc_id ml-close-job
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

output/schema/schema.json

@@ -28,6 +28,7 @@ import { Id } from '@_types/common'
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
  * @doc_id ml-delete-calendar
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/clear_trained_model_deployment_cache/MlClearTrainedModelDeploymentCacheRequest.ts

@@ -26,6 +26,7 @@ import { Id } from '@_types/common'
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @doc_id ml-delete-calendar-event
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/close_job/MlCloseJobRequest.ts

@@ -27,6 +27,7 @@ import { Id, Ids } from '@_types/common'
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
  * @doc_id ml-delete-calendar-job
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_calendar/MlDeleteCalendarRequest.ts

@@ -28,6 +28,7 @@ import { Duration } from '@_types/Time'
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
  * @doc_id ml-delete-dfanalytics
+ * @doc_tag ml data frame
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_calendar_event/MlDeleteCalendarEventRequest.ts

@@ -27,6 +27,7 @@ import { Id } from '@_types/common'
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
  * @doc_id ml-delete-datafeed
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_calendar_job/MlDeleteCalendarJobRequest.ts

@@ -36,6 +36,7 @@ import { Duration } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_data_frame_analytics/MlDeleteDataFrameAnalyticsRequest.ts

@@ -28,6 +28,7 @@ import { Id } from '@_types/common'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_datafeed/MlDeleteDatafeedRequest.ts

@@ -31,6 +31,7 @@ import { Duration } from '@_types/Time'
  * @availability stack since=6.5.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_expired_data/MlDeleteExpiredDataRequest.ts

@@ -32,6 +32,7 @@ import { Id } from '@_types/common'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_filter/MlDeleteFilterRequest.ts

@@ -29,6 +29,7 @@ import { Id } from '@_types/common'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_forecast/MlDeleteForecastRequest.ts

@@ -27,6 +27,7 @@ import { Id } from '@_types/common'
  * @availability stack since=7.10.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml trained model
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_job/MlDeleteJobRequest.ts

@@ -29,6 +29,7 @@ import { Id, Name } from '@_types/common'
  * @availability stack since=7.13.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml trained model
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/delete_model_snapshot/MlDeleteModelSnapshotRequest.ts

@@ -32,6 +32,7 @@ import { long } from '@_types/Numeric'
  * @availability stack since=7.7.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   body: {

specification/ml/delete_trained_model/MlDeleteTrainedModelRequest.ts

@@ -32,6 +32,7 @@ import { QueryContainer } from '@_types/query_dsl/abstractions'
  * @availability stack since=7.3.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml data frame
  */
 export interface Request extends RequestBase {
   body: {

specification/ml/delete_trained_model_alias/MlDeleteTrainedModelAliasRequest.ts

@@ -39,6 +39,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=7.3.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges monitor_ml
+ * @doc_tag ml data frame
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/estimate_model_memory/MlEstimateModelMemoryRequest.ts

@@ -35,6 +35,7 @@ import { DateTime } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/evaluate_data_frame/MlEvaluateDataFrameRequest.ts

@@ -33,6 +33,7 @@ import { Duration } from '@_types/Time'
  * @availability stack since=6.1.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/explain_data_frame_analytics/MlExplainDataFrameAnalyticsRequest.ts

@@ -30,6 +30,7 @@ import { DateTime } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/flush_job/MlFlushJobRequest.ts

@@ -28,6 +28,7 @@ import { DateTime } from '@_types/Time'
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/forecast/MlForecastJobRequest.ts

@@ -28,6 +28,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_buckets/MlGetBucketsRequest.ts

@@ -28,6 +28,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_calendar_events/MlGetCalendarEventsRequest.ts

@@ -30,6 +30,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=7.3.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml data frame
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_calendars/MlGetCalendarsRequest.ts

@@ -27,6 +27,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=7.3.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml data frame
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_categories/MlGetCategoriesRequest.ts

@@ -32,6 +32,7 @@ import { Ids } from '@_types/common'
  * @availability stack since=5.5.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_data_frame_analytics/MlGetDataFrameAnalyticsRequest.ts

@@ -31,6 +31,7 @@ import { Ids } from '@_types/common'
  * @availability stack since=5.5.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_data_frame_analytics_stats/MlGetDataFrameAnalyticsStatsRequest.ts

@@ -28,6 +28,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=5.5.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_datafeed_stats/MlGetDatafeedStatsRequest.ts

@@ -32,6 +32,7 @@ import { DateTime } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_datafeeds/MlGetDatafeedsRequest.ts

@@ -26,6 +26,7 @@ import { Id } from '@_types/common'
  * @availability stack since=5.5.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_filters/MlGetFiltersRequest.ts

@@ -30,6 +30,7 @@ import { Ids } from '@_types/common'
  * @availability stack since=5.5.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_influencers/MlGetInfluencersRequest.ts

@@ -26,6 +26,7 @@ import { Id } from '@_types/common'
  * @availability stack since=7.16.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_job_stats/MlGetJobStatsRequest.ts

@@ -29,6 +29,7 @@ import { DateTime } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_jobs/MlGetJobsRequest.ts

@@ -46,6 +46,7 @@ import { DateTime, Duration } from '@_types/Time'
  * @availability stack since=6.1.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_model_snapshot_upgrade_stats/MlGetModelSnapshotUpgradeStatsRequest.ts

@@ -39,6 +39,7 @@ import { DateTime } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
  * @cluster_privileges monitor_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_model_snapshots/MlGetModelSnapshotsRequest.ts

@@ -28,6 +28,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=7.10.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml trained model
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_overall_buckets/MlGetOverallBucketsRequest.ts

@@ -29,6 +29,7 @@ import { integer } from '@_types/Numeric'
  * @availability stack since=7.10.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml trained model
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_records/MlGetAnomalyRecordsRequest.ts

@@ -29,6 +29,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name ml.infer_trained_model
  * @availability stack since=8.3.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag ml trained model
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_trained_models/MlGetTrainedModelRequest.ts

@@ -33,6 +33,7 @@ import { Duration } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/get_trained_models_stats/MlGetTrainedModelStatsRequest.ts

@@ -27,6 +27,7 @@ import { CalendarEvent } from '../_types/CalendarEvent'
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/infer_trained_model/MlInferTrainedModelRequest.ts

@@ -30,6 +30,7 @@ import { DateTime } from '@_types/Time'
  * @availability stack since=5.4.0 stability=stable
  * @deprecated 7.11.0 Posting data directly to anomaly detection jobs is deprecated, in a future major version a datafeed will be required.
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request<TData> extends RequestBase {
   path_parts: {

specification/ml/open_job/MlOpenJobRequest.ts

@@ -28,6 +28,7 @@ import { DataframePreviewConfig } from './types'
  * @availability stack since=7.13.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges monitor_ml
+ * @doc_tag ml data frame
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/post_calendar_events/MlPostCalendarEventsRequest.ts

@@ -38,6 +38,7 @@ import { DateTime } from '@_types/Time'
  * @availability serverless stability=stable visibility=public
  * @index_privileges read
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/post_data/MlPostJobDataRequest.ts

@@ -26,6 +26,7 @@ import { Id } from '@_types/common'
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/ml/preview_data_frame_analytics/MlPreviewDataFrameAnalyticsRequest.ts

@@ -26,6 +26,7 @@ import { Id, Ids } from '@_types/common'
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_ml
+ * @doc_tag ml anomaly
  */
 export interface Request extends RequestBase {
   path_parts: {