[OpenAPI] Edits Logstash APIs

Author: lcawl

specification/_doc_ids/table.csv

@@ -253,6 +253,7 @@ knn-inner-hits,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/
 logstash-api-delete-pipeline,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/logstash-api-delete-pipeline.html
 logstash-api-get-pipeline,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/logstash-api-get-pipeline.html
 logstash-api-put-pipeline,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/logstash-api-put-pipeline.html
+logstash-centralized-pipeline-management,https://www.elastic.co/guide/en/logstash/{branch}/logstash-centralized-pipeline-management.html
 logstash-configuration-file-structure,https://www.elastic.co/guide/en/logstash/{branch}/configuration-file-structure.html
 logstash-logstash-settings-file,https://www.elastic.co/guide/en/logstash/{branch}/logstash-settings-file.html
 lowercase-processor,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/lowercase-processor.html

specification/logstash/_types/Pipeline.ts

@@ -59,34 +59,33 @@ export class PipelineSettings {
 }
 export class Pipeline {
   /**
-   * Description of the pipeline.
+   * A description of the pipeline.
    * This description is not used by Elasticsearch or Logstash.
    */
   description: string
   /**
-   * Date the pipeline was last updated.
-   * Must be in the `yyyy-MM-dd'T'HH:mm:ss.SSSZZ` strict_date_time format.
+   * The date the pipeline was last updated.
+   * It must be in the `yyyy-MM-dd'T'HH:mm:ss.SSSZZ` strict_date_time format.
    */
   last_modified: DateTime
   /**
-   * Optional metadata about the pipeline.
-   * May have any contents.
-   * This metadata is not generated or used by Elasticsearch or Logstash.
-   */
-  pipeline_metadata: PipelineMetadata
-  /**
-   * User who last updated the pipeline.
+   * The configuration for the pipeline.
+   * @ext_doc_id logstash-configuration-file-structure
    */
-  username: string
+  pipeline: string
   /**
-   * Configuration for the pipeline.
-   * @doc_id logstash-configuration-file-structure
+   * Optional metadata about the pipeline, which can have any contents.
+   * This metadata is not generated or used by Elasticsearch or Logstash.
    */
-  pipeline: string
+  pipeline_metadata: PipelineMetadata
   /**
    * Settings for the pipeline.
-   * Supports only flat keys in dot notation.
-   * @doc_id logstash-logstash-settings-file
+   * It supports only flat keys in dot notation.
+   * @ext_doc_id logstash-logstash-settings-file
    */
   pipeline_settings: PipelineSettings
+  /**
+   * The user who last updated the pipeline.
+   */
+  username: string
 }

specification/logstash/delete_pipeline/LogstashDeletePipelineRequest.ts

@@ -21,16 +21,19 @@ import { RequestBase } from '@_types/Base'
 import { Id } from '@_types/common'
 
 /**
- * Deletes a pipeline used for Logstash Central Management.
+ * Delete a Logstash pipeline.
+ *
+ * Delete a pipeline that is used for Logstash Central Management.
  * @rest_spec_name logstash.delete_pipeline
  * @availability stack since=7.12.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_logstash_pipelines
+ * @ext_doc_id logstash-centralized-pipeline-management
  */
 export interface Request extends RequestBase {
   path_parts: {
     /**
-     * Identifier for the pipeline.
+     * An identifier for the pipeline.
      */
     id: Id
   }

specification/logstash/get_pipeline/LogstashGetPipelineRequest.ts

@@ -21,16 +21,19 @@ import { RequestBase } from '@_types/Base'
 import { Ids } from '@_types/common'
 
 /**
- * Retrieves pipelines used for Logstash Central Management.
+ * Get Logstash pipelines.
+ *
+ * Get pipelines that are used for Logstash Central Management.
  * @rest_spec_name logstash.get_pipeline
  * @availability stack since=7.12.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_logstash_pipelines
+ * @ext_doc_id logstash-centralized-pipeline-management
  */
 export interface Request extends RequestBase {
   path_parts: {
     /**
-     * Comma-separated list of pipeline identifiers.
+     * A comma-separated list of pipeline identifiers.
      */
     id?: Ids
   }

specification/logstash/put_pipeline/LogstashPutPipelineRequest.ts

@@ -21,16 +21,21 @@ import { Pipeline } from '@logstash/_types/Pipeline'
 import { RequestBase } from '@_types/Base'
 import { Id } from '@_types/common'
 
-/** Creates or updates a pipeline used for Logstash Central Management.
+/**
+ * Create or update a Logstash pipeline.
+ *
+ * Create a pipeline that is used for Logstash Central Management.
+ * If the specified pipeline exists, it is replaced.
  * @rest_spec_name logstash.put_pipeline
  * @availability stack since=7.12.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @cluster_privileges manage_logstash_pipelines
+ * @ext_doc_id logstash-centralized-pipeline-management
  */
 export interface Request extends RequestBase {
   path_parts: {
     /**
-     * Identifier for the pipeline.
+     * An identifier for the pipeline.
      */
     id: Id
   }