From 8b36da0121582a8cc19960a922c8d8509cfb0fcb Mon Sep 17 00:00:00 2001 From: lcawl Date: Tue, 22 Oct 2024 16:53:00 -0700 Subject: [PATCH 01/11] [OpenAPI] Edit connector API summaries --- docs/overlays/elasticsearch-shared-overlays.yaml | 1 + .../connector/check_in/ConnectorCheckInRequest.ts | 4 +++- specification/connector/delete/ConnectorDeleteRequest.ts | 7 ++++++- specification/connector/get/ConnectorGetRequest.ts | 4 +++- .../connector/last_sync/ConnectorUpdateLastSyncRequest.ts | 5 ++++- specification/connector/list/ConnectorListRequest.ts | 4 +++- specification/connector/post/ConnectorPostRequest.ts | 6 +++++- specification/connector/put/ConnectorPutRequest.ts | 2 +- .../connector/sync_job_cancel/SyncJobCancelRequest.ts | 5 ++++- .../connector/sync_job_delete/SyncJobDeleteRequest.ts | 5 ++++- specification/connector/sync_job_get/SyncJobGetRequest.ts | 2 +- .../connector/sync_job_list/SyncJobListRequest.ts | 4 +++- .../connector/sync_job_post/SyncJobPostRequest.ts | 4 +++- .../ConnectorUpdateActiveFilteringRequest.ts | 2 ++ .../update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts | 7 ++++++- .../ConnectorUpdateConfigurationRequest.ts | 4 +++- .../connector/update_error/ConnectorUpdateErrorRequest.ts | 6 +++++- .../update_filtering/ConnectorUpdateFilteringRequest.ts | 6 +++++- .../ConnectorUpdateFilteringValidationRequest.ts | 4 +++- .../update_index_name/ConnectorUpdateIndexNameRequest.ts | 4 +++- .../connector/update_name/ConnectorUpdateNameRequest.ts | 2 +- .../update_native/ConnectorUpdateNativeRequest.ts | 2 +- .../update_pipeline/ConnectorUpdatePipelineRequest.ts | 4 +++- .../update_scheduling/ConnectorUpdateSchedulingRequest.ts | 2 +- .../ConnectorUpdateServiceTypeRequest.ts | 2 +- .../update_status/ConnectorUpdateStatusRequest.ts | 2 +- 26 files changed, 76 insertions(+), 24 deletions(-) diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml index 6150292046..bb1721e2bd 100644 --- a/docs/overlays/elasticsearch-shared-overlays.yaml +++ b/docs/overlays/elasticsearch-shared-overlays.yaml @@ -36,6 +36,7 @@ actions: Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure: * Native connectors are a managed service on Elastic Cloud + * Connector clients are self-managed on your infrastructure This API provides an alternative to relying solely on Kibana UI for connector and sync job management. The API comes with a set of validations and assertions to ensure that the state representation in the internal index remains valid. diff --git a/specification/connector/check_in/ConnectorCheckInRequest.ts b/specification/connector/check_in/ConnectorCheckInRequest.ts index 4c29b9c956..e4469f0dce 100644 --- a/specification/connector/check_in/ConnectorCheckInRequest.ts +++ b/specification/connector/check_in/ConnectorCheckInRequest.ts @@ -20,7 +20,9 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Updates the last_seen field in the connector, and sets it to current timestamp + * Check in a connector. + * + * Updates the `last_seen` field in the connector and sets it to the current timestamp. * @rest_spec_name connector.check_in * @availability stack since=8.12.0 stability=experimental * @availability serverless stability=experimental visibility=public diff --git a/specification/connector/delete/ConnectorDeleteRequest.ts b/specification/connector/delete/ConnectorDeleteRequest.ts index b3a9e6965e..d64153139b 100644 --- a/specification/connector/delete/ConnectorDeleteRequest.ts +++ b/specification/connector/delete/ConnectorDeleteRequest.ts @@ -20,7 +20,12 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Deletes a connector. + * Delete a connector. + * + * Removes a connector and associated sync jobs. + * This is a destructive action that is not recoverable. + * NOTE: This action doesn’t delete any API keys, ingest pipelines, or data indices associated with the connector. + * These need to be removed manually. * @rest_spec_name connector.delete * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/get/ConnectorGetRequest.ts b/specification/connector/get/ConnectorGetRequest.ts index 23a3caf040..e357985489 100644 --- a/specification/connector/get/ConnectorGetRequest.ts +++ b/specification/connector/get/ConnectorGetRequest.ts @@ -20,7 +20,9 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Retrieves a connector. + * Get a connector. + * + * Get the details about a connector. * @rest_spec_name connector.get * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/last_sync/ConnectorUpdateLastSyncRequest.ts b/specification/connector/last_sync/ConnectorUpdateLastSyncRequest.ts index d243b5770e..701a621539 100644 --- a/specification/connector/last_sync/ConnectorUpdateLastSyncRequest.ts +++ b/specification/connector/last_sync/ConnectorUpdateLastSyncRequest.ts @@ -24,7 +24,10 @@ import { DateTime } from '@_types/Time' import { SyncStatus } from '../_types/Connector' /** - * Updates last sync stats in the connector document + * Update the connector last sync stats. + * + * Update the fields related to the last sync of a connector. + * This action is used for analytics and monitoring. * @rest_spec_name connector.last_sync * @availability stack since=8.12.0 stability=experimental visibility=private * @availability serverless stability=experimental visibility=private diff --git a/specification/connector/list/ConnectorListRequest.ts b/specification/connector/list/ConnectorListRequest.ts index ea44fe6e11..ca818c84b8 100644 --- a/specification/connector/list/ConnectorListRequest.ts +++ b/specification/connector/list/ConnectorListRequest.ts @@ -21,7 +21,9 @@ import { Indices, Names } from '@_types/common' import { integer } from '@_types/Numeric' /** - * Returns existing connectors. + * Get all connectors. + * + * Get information about all connectors. * @rest_spec_name connector.list * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/post/ConnectorPostRequest.ts b/specification/connector/post/ConnectorPostRequest.ts index c9d2d0816d..56e67c690f 100644 --- a/specification/connector/post/ConnectorPostRequest.ts +++ b/specification/connector/post/ConnectorPostRequest.ts @@ -20,7 +20,11 @@ import { RequestBase } from '@_types/Base' import { IndexName } from '@_types/common' /** - * Creates a connector. + * Create a connector. + * + * Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure. + * Native connectors are a managed service on Elastic Cloud. + * Connector clients are self-managed on your infrastructure. * @rest_spec_name connector.post * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/put/ConnectorPutRequest.ts b/specification/connector/put/ConnectorPutRequest.ts index 10ce3fb8e9..579f47b31f 100644 --- a/specification/connector/put/ConnectorPutRequest.ts +++ b/specification/connector/put/ConnectorPutRequest.ts @@ -20,7 +20,7 @@ import { RequestBase } from '@_types/Base' import { Id, IndexName } from '@_types/common' /** - * Creates or updates a connector. + * Create or update a connector. * @rest_spec_name connector.put * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/sync_job_cancel/SyncJobCancelRequest.ts b/specification/connector/sync_job_cancel/SyncJobCancelRequest.ts index 27a89047a6..ec5841760f 100644 --- a/specification/connector/sync_job_cancel/SyncJobCancelRequest.ts +++ b/specification/connector/sync_job_cancel/SyncJobCancelRequest.ts @@ -20,7 +20,10 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Cancels a connector sync job. + * Cancel a connector sync job. + * + * Cancel a connector sync job, which sets the status to cancelling and updates `cancellation_requested_at` to the current time. + * The connector service is then responsible for setting the status of connector sync jobs to cancelled. * @rest_spec_name connector.sync_job_cancel * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts b/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts index 19aad70b22..821e17d302 100644 --- a/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts +++ b/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts @@ -20,7 +20,10 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Deletes a connector sync job. + * Delete a connector sync job. + * + * Remove a connector sync job and its associated data. + * This is a destructive action that is not recoverable. * @rest_spec_name connector.sync_job_delete * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/sync_job_get/SyncJobGetRequest.ts b/specification/connector/sync_job_get/SyncJobGetRequest.ts index cf2753871b..2310a95b57 100644 --- a/specification/connector/sync_job_get/SyncJobGetRequest.ts +++ b/specification/connector/sync_job_get/SyncJobGetRequest.ts @@ -20,7 +20,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Retrieves a connector sync job. + * Get a connector sync job. * @rest_spec_name connector.sync_job_get * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/sync_job_list/SyncJobListRequest.ts b/specification/connector/sync_job_list/SyncJobListRequest.ts index ab2637233e..1693640a2d 100644 --- a/specification/connector/sync_job_list/SyncJobListRequest.ts +++ b/specification/connector/sync_job_list/SyncJobListRequest.ts @@ -23,7 +23,9 @@ import { SyncStatus } from '../_types/Connector' import { SyncJobType } from '../_types/SyncJob' /** - * Lists connector sync jobs. + * Get all connector sync jobs. + * + * Get information about all stored connector sync jobs listed by their creation date in ascending order. * @rest_spec_name connector.sync_job_list * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/sync_job_post/SyncJobPostRequest.ts b/specification/connector/sync_job_post/SyncJobPostRequest.ts index be386dbbb0..27b9bfca50 100644 --- a/specification/connector/sync_job_post/SyncJobPostRequest.ts +++ b/specification/connector/sync_job_post/SyncJobPostRequest.ts @@ -21,7 +21,9 @@ import { Id } from '@_types/common' import { SyncJobTriggerMethod, SyncJobType } from '../_types/SyncJob' /** - * Creates a connector sync job. + * Create a connector sync job. + * + * Create a connector sync job document in the internal index and initialize its counters and timestamps with default values. * @rest_spec_name connector.sync_job_post * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts b/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts index a92fb2b7bc..3acd9e9880 100644 --- a/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts +++ b/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts @@ -20,6 +20,8 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** + * Activate the connector draft filter. + * * Activates the valid draft filtering for a connector. * @rest_spec_name connector.update_active_filtering * @availability stack since=8.12.0 stability=experimental diff --git a/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts b/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts index e7305bbc2d..9f002b6ddd 100644 --- a/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts +++ b/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts @@ -19,7 +19,12 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Updates the API key id in the connector document + * Update the connector API key ID. + * + * Update the `api_key_id` and `api_key_secret_id` fields of a connector. + * You can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored. + * The connector secret ID is required only for native connectors. + * Connector clients do not use this field. * @rest_spec_name connector.update_api_key_id * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_configuration/ConnectorUpdateConfigurationRequest.ts b/specification/connector/update_configuration/ConnectorUpdateConfigurationRequest.ts index 06a2febc8f..531c8812d4 100644 --- a/specification/connector/update_configuration/ConnectorUpdateConfigurationRequest.ts +++ b/specification/connector/update_configuration/ConnectorUpdateConfigurationRequest.ts @@ -23,7 +23,9 @@ import { Id } from '@_types/common' import { ConnectorConfiguration } from '../_types/Connector' /** - * Updates the configuration field in the connector document + * Update the connector configuration. + * + * Update the configuration field in the connector document. * @rest_spec_name connector.update_configuration * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_error/ConnectorUpdateErrorRequest.ts b/specification/connector/update_error/ConnectorUpdateErrorRequest.ts index a7b81e52ea..99d268d026 100644 --- a/specification/connector/update_error/ConnectorUpdateErrorRequest.ts +++ b/specification/connector/update_error/ConnectorUpdateErrorRequest.ts @@ -21,7 +21,11 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Updates the filtering field in the connector document + * Update the connector error field. + * + * Set the error field for the connector. + * If the error provided in the request body is non-null, the connector’s status is updated to error. + * Otherwise, if the error is reset to null, the connector status is updated to connected. * @rest_spec_name connector.update_error * @availability stack since=8.12.0 stability=experimental * @availability serverless stability=experimental visibility=public diff --git a/specification/connector/update_filtering/ConnectorUpdateFilteringRequest.ts b/specification/connector/update_filtering/ConnectorUpdateFilteringRequest.ts index 198bb87320..db09904c15 100644 --- a/specification/connector/update_filtering/ConnectorUpdateFilteringRequest.ts +++ b/specification/connector/update_filtering/ConnectorUpdateFilteringRequest.ts @@ -25,7 +25,11 @@ import { } from '../_types/Connector' /** - * Updates the filtering field in the connector document + * Update the connector filtering. + * + * Update the draft filtering configuration of a connector and marks the draft validation state as edited. + * The filtering draft is activated once validated by the running Elastic connector service. + * The filtering property is used to configure sync rules (both basic and advanced) for a connector. * @rest_spec_name connector.update_filtering * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_filtering_validation/ConnectorUpdateFilteringValidationRequest.ts b/specification/connector/update_filtering_validation/ConnectorUpdateFilteringValidationRequest.ts index bbdb80f4ac..4fe343e682 100644 --- a/specification/connector/update_filtering_validation/ConnectorUpdateFilteringValidationRequest.ts +++ b/specification/connector/update_filtering_validation/ConnectorUpdateFilteringValidationRequest.ts @@ -21,7 +21,9 @@ import { Id } from '@_types/common' import { FilteringRulesValidation } from 'connector/_types/Connector' /** - * Updates the draft filtering validation info for a connector. + * Update the connector draft filtering validation. + * + * Update the draft filtering validation info for a connector. * @rest_spec_name connector.update_filtering_validation * @availability stack since=8.12.0 stability=experimental * @availability serverless stability=experimental visibility=public diff --git a/specification/connector/update_index_name/ConnectorUpdateIndexNameRequest.ts b/specification/connector/update_index_name/ConnectorUpdateIndexNameRequest.ts index 74dc1ca0bf..8e7b48593a 100644 --- a/specification/connector/update_index_name/ConnectorUpdateIndexNameRequest.ts +++ b/specification/connector/update_index_name/ConnectorUpdateIndexNameRequest.ts @@ -21,7 +21,9 @@ import { RequestBase } from '@_types/Base' import { Id, IndexName } from '@_types/common' /** - * Updates the index_name in the connector document + * Update the connector index name. + * + * Update the `index_name` field of a connector, specifying the index where the data ingested by the connector is stored. * @rest_spec_name connector.update_index_name * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_name/ConnectorUpdateNameRequest.ts b/specification/connector/update_name/ConnectorUpdateNameRequest.ts index a50fbd06ea..b381fc4d3c 100644 --- a/specification/connector/update_name/ConnectorUpdateNameRequest.ts +++ b/specification/connector/update_name/ConnectorUpdateNameRequest.ts @@ -20,7 +20,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Updates the name and description fields in the connector document + * Update the connector name and description. * @rest_spec_name connector.update_name * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_native/ConnectorUpdateNativeRequest.ts b/specification/connector/update_native/ConnectorUpdateNativeRequest.ts index 0c180055ca..0f9bbfb54c 100644 --- a/specification/connector/update_native/ConnectorUpdateNativeRequest.ts +++ b/specification/connector/update_native/ConnectorUpdateNativeRequest.ts @@ -20,7 +20,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Updates the is_native flag in the connector document + * Update the connector is_native flag. * @rest_spec_name connector.update_native * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_pipeline/ConnectorUpdatePipelineRequest.ts b/specification/connector/update_pipeline/ConnectorUpdatePipelineRequest.ts index bcd7f80638..cdeb6e8c1c 100644 --- a/specification/connector/update_pipeline/ConnectorUpdatePipelineRequest.ts +++ b/specification/connector/update_pipeline/ConnectorUpdatePipelineRequest.ts @@ -21,7 +21,9 @@ import { Id } from '@_types/common' import { IngestPipelineParams } from '../_types/Connector' /** - * Updates the pipeline field in the connector document + * Update the connector pipeline. + * + * When you create a new connector, the configuration of an ingest pipeline is populated with default settings. * @rest_spec_name connector.update_pipeline * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_scheduling/ConnectorUpdateSchedulingRequest.ts b/specification/connector/update_scheduling/ConnectorUpdateSchedulingRequest.ts index dfc368c874..2eba24d783 100644 --- a/specification/connector/update_scheduling/ConnectorUpdateSchedulingRequest.ts +++ b/specification/connector/update_scheduling/ConnectorUpdateSchedulingRequest.ts @@ -21,7 +21,7 @@ import { Id } from '@_types/common' import { SchedulingConfiguration } from '../_types/Connector' /** - * Updates the scheduling field in the connector document + * Update the connector scheduling. * @rest_spec_name connector.update_scheduling * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_service_type/ConnectorUpdateServiceTypeRequest.ts b/specification/connector/update_service_type/ConnectorUpdateServiceTypeRequest.ts index 565c3821af..e8b29ea071 100644 --- a/specification/connector/update_service_type/ConnectorUpdateServiceTypeRequest.ts +++ b/specification/connector/update_service_type/ConnectorUpdateServiceTypeRequest.ts @@ -20,7 +20,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Updates the service type of the connector + * Update the connector service type. * @rest_spec_name connector.update_service_type * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_status/ConnectorUpdateStatusRequest.ts b/specification/connector/update_status/ConnectorUpdateStatusRequest.ts index e1242c0e47..9d4cc8dd7b 100644 --- a/specification/connector/update_status/ConnectorUpdateStatusRequest.ts +++ b/specification/connector/update_status/ConnectorUpdateStatusRequest.ts @@ -21,7 +21,7 @@ import { Id } from '@_types/common' import { ConnectorStatus } from '../_types/Connector' /** - * Updates the status of the connector + * Update the connector status. * @rest_spec_name connector.update_status * @availability stack since=8.12.0 stability=experimental * @availability serverless stability=experimental visibility=public From 63e3b584a2bee2dc47ef71a74dbbbe11bcc3d26d Mon Sep 17 00:00:00 2001 From: lcawl Date: Tue, 22 Oct 2024 16:54:50 -0700 Subject: [PATCH 02/11] Generate output --- output/openapi/elasticsearch-openapi.json | 70 +++++---- .../elasticsearch-serverless-openapi.json | 67 +++++---- output/schema/schema.json | 136 +++++++++--------- .../check_in/ConnectorCheckInRequest.ts | 2 +- 4 files changed, 155 insertions(+), 120 deletions(-) diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index be06e8e079..23fc3ed728 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -4036,7 +4036,8 @@ "tags": [ "connector" ], - "summary": "Updates the last_seen field in the connector, and sets it to current timestamp", + "summary": "Check in a connector", + "description": "Update the `last_seen` field in the connector and set it to the current timestamp.", "operationId": "connector-check-in", "parameters": [ { @@ -4079,7 +4080,8 @@ "tags": [ "connector" ], - "summary": "Retrieves a connector", + "summary": "Get a connector", + "description": "Get the details about a connector.", "operationId": "connector-get", "parameters": [ { @@ -4112,7 +4114,7 @@ "tags": [ "connector" ], - "summary": "Creates or updates a connector", + "summary": "Create or update a connector", "operationId": "connector-put", "parameters": [ { @@ -4133,7 +4135,8 @@ "tags": [ "connector" ], - "summary": "Deletes a connector", + "summary": "Delete a connector", + "description": "Removes a connector and associated sync jobs.\nThis is a destructive action that is not recoverable.\nNOTE: This action doesn’t delete any API keys, ingest pipelines, or data indices associated with the connector.\nThese need to be removed manually.", "operationId": "connector-delete", "parameters": [ { @@ -4178,7 +4181,8 @@ "tags": [ "connector" ], - "summary": "Updates last sync stats in the connector document", + "summary": "Update the connector last sync stats", + "description": "Update the fields related to the last sync of a connector.\nThis action is used for analytics and monitoring.", "operationId": "connector-last-sync", "parameters": [ { @@ -4269,7 +4273,8 @@ "tags": [ "connector" ], - "summary": "Returns existing connectors", + "summary": "Get all connectors", + "description": "Get information about all connectors.", "operationId": "connector-list", "parameters": [ { @@ -4366,7 +4371,7 @@ "tags": [ "connector" ], - "summary": "Creates or updates a connector", + "summary": "Create or update a connector", "operationId": "connector-put-1", "requestBody": { "$ref": "#/components/requestBodies/connector.put" @@ -4382,7 +4387,8 @@ "tags": [ "connector" ], - "summary": "Creates a connector", + "summary": "Create a connector", + "description": "Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", "operationId": "connector-post", "requestBody": { "content": { @@ -4445,7 +4451,8 @@ "tags": [ "connector" ], - "summary": "Cancels a connector sync job", + "summary": "Cancel a connector sync job", + "description": "Cancel a connector sync job, which sets the status to cancelling and updates `cancellation_requested_at` to the current time.\nThe connector service is then responsible for setting the status of connector sync jobs to cancelled.", "operationId": "connector-sync-job-cancel", "parameters": [ { @@ -4488,7 +4495,7 @@ "tags": [ "connector" ], - "summary": "Retrieves a connector sync job", + "summary": "Get a connector sync job", "operationId": "connector-sync-job-get", "parameters": [ { @@ -4521,7 +4528,8 @@ "tags": [ "connector" ], - "summary": "Deletes a connector sync job", + "summary": "Delete a connector sync job", + "description": "Remove a connector sync job and its associated data.\nThis is a destructive action that is not recoverable.", "operationId": "connector-sync-job-delete", "parameters": [ { @@ -4556,7 +4564,8 @@ "tags": [ "connector" ], - "summary": "Lists connector sync jobs", + "summary": "Get all connector sync jobs", + "description": "Get information about all stored connector sync jobs listed by their creation date in ascending order.", "operationId": "connector-sync-job-list", "parameters": [ { @@ -4653,7 +4662,8 @@ "tags": [ "connector" ], - "summary": "Creates a connector sync job", + "summary": "Create a connector sync job", + "description": "Create a connector sync job document in the internal index and initialize its counters and timestamps with default values.", "operationId": "connector-sync-job-post", "requestBody": { "content": { @@ -4707,7 +4717,8 @@ "tags": [ "connector" ], - "summary": "Activates the valid draft filtering for a connector", + "summary": "Activate the connector draft filter", + "description": "Activates the valid draft filtering for a connector.", "operationId": "connector-update-active-filtering", "parameters": [ { @@ -4750,7 +4761,8 @@ "tags": [ "connector" ], - "summary": "Updates the API key id in the connector document", + "summary": "Update the connector API key ID", + "description": "Update the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", "operationId": "connector-update-api-key-id", "parameters": [ { @@ -4811,7 +4823,8 @@ "tags": [ "connector" ], - "summary": "Updates the configuration field in the connector document", + "summary": "Update the connector configuration", + "description": "Update the configuration field in the connector document.", "operationId": "connector-update-configuration", "parameters": [ { @@ -4875,7 +4888,8 @@ "tags": [ "connector" ], - "summary": "Updates the filtering field in the connector document", + "summary": "Update the connector error field", + "description": "Set the error field for the connector.\nIf the error provided in the request body is non-null, the connector’s status is updated to error.\nOtherwise, if the error is reset to null, the connector status is updated to connected.", "operationId": "connector-update-error", "parameters": [ { @@ -4943,7 +4957,8 @@ "tags": [ "connector" ], - "summary": "Updates the filtering field in the connector document", + "summary": "Update the connector filtering", + "description": "Update the draft filtering configuration of a connector and marks the draft validation state as edited.\nThe filtering draft is activated once validated by the running Elastic connector service.\nThe filtering property is used to configure sync rules (both basic and advanced) for a connector.", "operationId": "connector-update-filtering", "parameters": [ { @@ -5013,7 +5028,8 @@ "tags": [ "connector" ], - "summary": "Updates the draft filtering validation info for a connector", + "summary": "Update the connector draft filtering validation", + "description": "Update the draft filtering validation info for a connector.", "operationId": "connector-update-filtering-validation", "parameters": [ { @@ -5074,7 +5090,8 @@ "tags": [ "connector" ], - "summary": "Updates the index_name in the connector document", + "summary": "Update the connector index name", + "description": "Update the `index_name` field of a connector, specifying the index where the data ingested by the connector is stored.", "operationId": "connector-update-index-name", "parameters": [ { @@ -5142,7 +5159,7 @@ "tags": [ "connector" ], - "summary": "Updates the name and description fields in the connector document", + "summary": "Update the connector name and description", "operationId": "connector-update-name", "parameters": [ { @@ -5203,7 +5220,7 @@ "tags": [ "connector" ], - "summary": "Updates the is_native flag in the connector document", + "summary": "Update the connector is_native flag", "operationId": "connector-update-native", "parameters": [ { @@ -5264,7 +5281,8 @@ "tags": [ "connector" ], - "summary": "Updates the pipeline field in the connector document", + "summary": "Update the connector pipeline", + "description": "When you create a new connector, the configuration of an ingest pipeline is populated with default settings.", "operationId": "connector-update-pipeline", "parameters": [ { @@ -5325,7 +5343,7 @@ "tags": [ "connector" ], - "summary": "Updates the scheduling field in the connector document", + "summary": "Update the connector scheduling", "operationId": "connector-update-scheduling", "parameters": [ { @@ -5386,7 +5404,7 @@ "tags": [ "connector" ], - "summary": "Updates the service type of the connector", + "summary": "Update the connector service type", "operationId": "connector-update-service-type", "parameters": [ { @@ -5447,7 +5465,7 @@ "tags": [ "connector" ], - "summary": "Updates the status of the connector", + "summary": "Update the connector status", "operationId": "connector-update-status", "parameters": [ { diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index 2e4c9f2fa5..0b3f93e702 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -1707,7 +1707,8 @@ "tags": [ "connector" ], - "summary": "Updates the last_seen field in the connector, and sets it to current timestamp", + "summary": "Check in a connector", + "description": "Update the `last_seen` field in the connector and set it to the current timestamp.", "operationId": "connector-check-in", "parameters": [ { @@ -1750,7 +1751,8 @@ "tags": [ "connector" ], - "summary": "Retrieves a connector", + "summary": "Get a connector", + "description": "Get the details about a connector.", "operationId": "connector-get", "parameters": [ { @@ -1783,7 +1785,7 @@ "tags": [ "connector" ], - "summary": "Creates or updates a connector", + "summary": "Create or update a connector", "operationId": "connector-put", "parameters": [ { @@ -1804,7 +1806,8 @@ "tags": [ "connector" ], - "summary": "Deletes a connector", + "summary": "Delete a connector", + "description": "Removes a connector and associated sync jobs.\nThis is a destructive action that is not recoverable.\nNOTE: This action doesn’t delete any API keys, ingest pipelines, or data indices associated with the connector.\nThese need to be removed manually.", "operationId": "connector-delete", "parameters": [ { @@ -1849,7 +1852,8 @@ "tags": [ "connector" ], - "summary": "Returns existing connectors", + "summary": "Get all connectors", + "description": "Get information about all connectors.", "operationId": "connector-list", "parameters": [ { @@ -1946,7 +1950,7 @@ "tags": [ "connector" ], - "summary": "Creates or updates a connector", + "summary": "Create or update a connector", "operationId": "connector-put-1", "requestBody": { "$ref": "#/components/requestBodies/connector.put" @@ -1962,7 +1966,8 @@ "tags": [ "connector" ], - "summary": "Creates a connector", + "summary": "Create a connector", + "description": "Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", "operationId": "connector-post", "requestBody": { "content": { @@ -2025,7 +2030,8 @@ "tags": [ "connector" ], - "summary": "Cancels a connector sync job", + "summary": "Cancel a connector sync job", + "description": "Cancel a connector sync job, which sets the status to cancelling and updates `cancellation_requested_at` to the current time.\nThe connector service is then responsible for setting the status of connector sync jobs to cancelled.", "operationId": "connector-sync-job-cancel", "parameters": [ { @@ -2068,7 +2074,7 @@ "tags": [ "connector" ], - "summary": "Retrieves a connector sync job", + "summary": "Get a connector sync job", "operationId": "connector-sync-job-get", "parameters": [ { @@ -2101,7 +2107,8 @@ "tags": [ "connector" ], - "summary": "Deletes a connector sync job", + "summary": "Delete a connector sync job", + "description": "Remove a connector sync job and its associated data.\nThis is a destructive action that is not recoverable.", "operationId": "connector-sync-job-delete", "parameters": [ { @@ -2136,7 +2143,8 @@ "tags": [ "connector" ], - "summary": "Lists connector sync jobs", + "summary": "Get all connector sync jobs", + "description": "Get information about all stored connector sync jobs listed by their creation date in ascending order.", "operationId": "connector-sync-job-list", "parameters": [ { @@ -2233,7 +2241,8 @@ "tags": [ "connector" ], - "summary": "Creates a connector sync job", + "summary": "Create a connector sync job", + "description": "Create a connector sync job document in the internal index and initialize its counters and timestamps with default values.", "operationId": "connector-sync-job-post", "requestBody": { "content": { @@ -2287,7 +2296,8 @@ "tags": [ "connector" ], - "summary": "Activates the valid draft filtering for a connector", + "summary": "Activate the connector draft filter", + "description": "Activates the valid draft filtering for a connector.", "operationId": "connector-update-active-filtering", "parameters": [ { @@ -2330,7 +2340,8 @@ "tags": [ "connector" ], - "summary": "Updates the API key id in the connector document", + "summary": "Update the connector API key ID", + "description": "Update the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", "operationId": "connector-update-api-key-id", "parameters": [ { @@ -2391,7 +2402,8 @@ "tags": [ "connector" ], - "summary": "Updates the configuration field in the connector document", + "summary": "Update the connector configuration", + "description": "Update the configuration field in the connector document.", "operationId": "connector-update-configuration", "parameters": [ { @@ -2455,7 +2467,8 @@ "tags": [ "connector" ], - "summary": "Updates the filtering field in the connector document", + "summary": "Update the connector error field", + "description": "Set the error field for the connector.\nIf the error provided in the request body is non-null, the connector’s status is updated to error.\nOtherwise, if the error is reset to null, the connector status is updated to connected.", "operationId": "connector-update-error", "parameters": [ { @@ -2523,7 +2536,8 @@ "tags": [ "connector" ], - "summary": "Updates the filtering field in the connector document", + "summary": "Update the connector filtering", + "description": "Update the draft filtering configuration of a connector and marks the draft validation state as edited.\nThe filtering draft is activated once validated by the running Elastic connector service.\nThe filtering property is used to configure sync rules (both basic and advanced) for a connector.", "operationId": "connector-update-filtering", "parameters": [ { @@ -2593,7 +2607,8 @@ "tags": [ "connector" ], - "summary": "Updates the draft filtering validation info for a connector", + "summary": "Update the connector draft filtering validation", + "description": "Update the draft filtering validation info for a connector.", "operationId": "connector-update-filtering-validation", "parameters": [ { @@ -2654,7 +2669,8 @@ "tags": [ "connector" ], - "summary": "Updates the index_name in the connector document", + "summary": "Update the connector index name", + "description": "Update the `index_name` field of a connector, specifying the index where the data ingested by the connector is stored.", "operationId": "connector-update-index-name", "parameters": [ { @@ -2722,7 +2738,7 @@ "tags": [ "connector" ], - "summary": "Updates the name and description fields in the connector document", + "summary": "Update the connector name and description", "operationId": "connector-update-name", "parameters": [ { @@ -2783,7 +2799,7 @@ "tags": [ "connector" ], - "summary": "Updates the is_native flag in the connector document", + "summary": "Update the connector is_native flag", "operationId": "connector-update-native", "parameters": [ { @@ -2844,7 +2860,8 @@ "tags": [ "connector" ], - "summary": "Updates the pipeline field in the connector document", + "summary": "Update the connector pipeline", + "description": "When you create a new connector, the configuration of an ingest pipeline is populated with default settings.", "operationId": "connector-update-pipeline", "parameters": [ { @@ -2905,7 +2922,7 @@ "tags": [ "connector" ], - "summary": "Updates the scheduling field in the connector document", + "summary": "Update the connector scheduling", "operationId": "connector-update-scheduling", "parameters": [ { @@ -2966,7 +2983,7 @@ "tags": [ "connector" ], - "summary": "Updates the service type of the connector", + "summary": "Update the connector service type", "operationId": "connector-update-service-type", "parameters": [ { @@ -3027,7 +3044,7 @@ "tags": [ "connector" ], - "summary": "Updates the status of the connector", + "summary": "Update the connector status", "operationId": "connector-update-status", "parameters": [ { diff --git a/output/schema/schema.json b/output/schema/schema.json index 09518e42d5..b70d9278b8 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -2890,7 +2890,7 @@ "stability": "experimental" } }, - "description": "Updates the last_seen field in the connector, and sets it to current timestamp", + "description": "Check in a connector.\n\nUpdate the `last_seen` field in the connector and set it to the current timestamp.", "docId": "connector-checkin", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/check-in-connector-api.html", "name": "connector.check_in", @@ -2926,7 +2926,7 @@ "stability": "beta" } }, - "description": "Deletes a connector.", + "description": "Delete a connector.\n\nRemoves a connector and associated sync jobs.\nThis is a destructive action that is not recoverable.\nNOTE: This action doesn’t delete any API keys, ingest pipelines, or data indices associated with the connector.\nThese need to be removed manually.", "docId": "connector-delete", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-connector-api.html", "name": "connector.delete", @@ -2962,7 +2962,7 @@ "stability": "beta" } }, - "description": "Retrieves a connector.", + "description": "Get a connector.\n\nGet the details about a connector.", "docId": "connector-get", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-connector-api.html", "name": "connector.get", @@ -2999,7 +2999,7 @@ "visibility": "private" } }, - "description": "Updates last sync stats in the connector document", + "description": "Update the connector last sync stats.\n\nUpdate the fields related to the last sync of a connector.\nThis action is used for analytics and monitoring.", "docId": "connector-last-sync", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-last-sync-api.html", "name": "connector.last_sync", @@ -3038,7 +3038,7 @@ "stability": "beta" } }, - "description": "Returns existing connectors.", + "description": "Get all connectors.\n\nGet information about all connectors.", "docId": "connector-list", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/list-connector-api.html", "name": "connector.list", @@ -3074,7 +3074,7 @@ "stability": "beta" } }, - "description": "Creates a connector.", + "description": "Create a connector.\n\nConnectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", "docId": "connector-post", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/create-connector-api.html", "name": "connector.post", @@ -3113,7 +3113,7 @@ "stability": "beta" } }, - "description": "Creates or updates a connector.", + "description": "Create or update a connector.", "docId": "connector-put", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/create-connector-api.html", "name": "connector.put", @@ -3258,7 +3258,7 @@ "stability": "beta" } }, - "description": "Cancels a connector sync job.", + "description": "Cancel a connector sync job.\n\nCancel a connector sync job, which sets the status to cancelling and updates `cancellation_requested_at` to the current time.\nThe connector service is then responsible for setting the status of connector sync jobs to cancelled.", "docId": "connector-sync-job-cancel", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cancel-connector-sync-job-api.html", "name": "connector.sync_job_cancel", @@ -3347,7 +3347,7 @@ "stability": "beta" } }, - "description": "Deletes a connector sync job.", + "description": "Delete a connector sync job.\n\nRemove a connector sync job and its associated data.\nThis is a destructive action that is not recoverable.", "docId": "connector-sync-job-delete", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-connector-sync-job-api.html", "name": "connector.sync_job_delete", @@ -3411,7 +3411,7 @@ "stability": "beta" } }, - "description": "Retrieves a connector sync job.", + "description": "Get a connector sync job.", "docId": "connector-sync-job-get", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-connector-sync-job-api.html", "name": "connector.sync_job_get", @@ -3447,7 +3447,7 @@ "stability": "beta" } }, - "description": "Lists connector sync jobs.", + "description": "Get all connector sync jobs.\n\nGet information about all stored connector sync jobs listed by their creation date in ascending order.", "docId": "connector-sync-job-list", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/list-connector-sync-jobs-api.html", "name": "connector.sync_job_list", @@ -3483,7 +3483,7 @@ "stability": "beta" } }, - "description": "Creates a connector sync job.", + "description": "Create a connector sync job.\n\nCreate a connector sync job document in the internal index and initialize its counters and timestamps with default values.", "docId": "connector-sync-job-post", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/create-connector-sync-job-api.html", "name": "connector.sync_job_post", @@ -3550,7 +3550,7 @@ "stability": "experimental" } }, - "description": "Activates the valid draft filtering for a connector.", + "description": "Activate the connector draft filter. \n\nActivates the valid draft filtering for a connector.", "docId": "connector-update-filtering", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-filtering-api.html", "name": "connector.update_active_filtering", @@ -3589,7 +3589,7 @@ "stability": "beta" } }, - "description": "Updates the API key id in the connector document", + "description": "Update the connector API key ID.\n\nUpdate the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", "docId": "connector-update-api-key-id", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-api-key-id-api.html", "name": "connector.update_api_key_id", @@ -3628,7 +3628,7 @@ "stability": "beta" } }, - "description": "Updates the configuration field in the connector document", + "description": "Update the connector configuration.\n\nUpdate the configuration field in the connector document.", "docId": "connector-configuration", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-configuration-api.html", "name": "connector.update_configuration", @@ -3667,7 +3667,7 @@ "stability": "experimental" } }, - "description": "Updates the filtering field in the connector document", + "description": "Update the connector error field.\n\nSet the error field for the connector.\nIf the error provided in the request body is non-null, the connector’s status is updated to error.\nOtherwise, if the error is reset to null, the connector status is updated to connected.", "docId": "connector-update-error", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-error-api.html", "name": "connector.update_error", @@ -3734,7 +3734,7 @@ "stability": "beta" } }, - "description": "Updates the filtering field in the connector document", + "description": "Update the connector filtering.\n\nUpdate the draft filtering configuration of a connector and marks the draft validation state as edited.\nThe filtering draft is activated once validated by the running Elastic connector service.\nThe filtering property is used to configure sync rules (both basic and advanced) for a connector.", "docId": "connector-update-filtering", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-filtering-api.html", "name": "connector.update_filtering", @@ -3773,7 +3773,7 @@ "stability": "experimental" } }, - "description": "Updates the draft filtering validation info for a connector.", + "description": "Update the connector draft filtering validation.\n\nUpdate the draft filtering validation info for a connector.", "docId": "connector-update-filtering-validation", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-filtering-validation-api.html", "name": "connector.update_filtering_validation", @@ -3812,7 +3812,7 @@ "stability": "beta" } }, - "description": "Updates the index_name in the connector document", + "description": "Update the connector index name.\n\nUpdate the `index_name` field of a connector, specifying the index where the data ingested by the connector is stored.", "docId": "connector-update-index-name", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-index-name-api.html", "name": "connector.update_index_name", @@ -3851,7 +3851,7 @@ "stability": "beta" } }, - "description": "Updates the name and description fields in the connector document", + "description": "Update the connector name and description.", "docId": "connector-update-name", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-name-description-api.html", "name": "connector.update_name", @@ -3890,7 +3890,7 @@ "stability": "beta" } }, - "description": "Updates the is_native flag in the connector document", + "description": "Update the connector is_native flag.", "docId": "connector-update-native", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-native-api.html", "name": "connector.update_native", @@ -3929,7 +3929,7 @@ "stability": "beta" } }, - "description": "Updates the pipeline field in the connector document", + "description": "Update the connector pipeline.\n\nWhen you create a new connector, the configuration of an ingest pipeline is populated with default settings.", "docId": "connector-update-pipeline", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-pipeline-api.html", "name": "connector.update_pipeline", @@ -3968,7 +3968,7 @@ "stability": "beta" } }, - "description": "Updates the scheduling field in the connector document", + "description": "Update the connector scheduling.", "docId": "connector-update-scheduling", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-scheduling-api.html", "name": "connector.update_scheduling", @@ -4007,7 +4007,7 @@ "stability": "beta" } }, - "description": "Updates the service type of the connector", + "description": "Update the connector service type.", "docId": "connector-update-service-type", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-service-type-api.html", "name": "connector.update_service_type", @@ -4046,7 +4046,7 @@ "stability": "experimental" } }, - "description": "Updates the status of the connector", + "description": "Update the connector status.", "docId": "connector-update-status", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-status-api.html", "name": "connector.update_status", @@ -113318,7 +113318,7 @@ "body": { "kind": "no_body" }, - "description": "Updates the last_seen field in the connector, and sets it to current timestamp", + "description": "Check in a connector.\n\nUpdate the `last_seen` field in the connector and set it to the current timestamp.", "inherits": { "type": { "name": "RequestBase", @@ -113344,7 +113344,7 @@ } ], "query": [], - "specLocation": "connector/check_in/ConnectorCheckInRequest.ts#L22-L36" + "specLocation": "connector/check_in/ConnectorCheckInRequest.ts#L22-L38" }, { "kind": "response", @@ -113378,7 +113378,7 @@ "body": { "kind": "no_body" }, - "description": "Deletes a connector.", + "description": "Delete a connector.\n\nRemoves a connector and associated sync jobs.\nThis is a destructive action that is not recoverable.\nNOTE: This action doesn’t delete any API keys, ingest pipelines, or data indices associated with the connector.\nThese need to be removed manually.", "inherits": { "type": { "name": "RequestBase", @@ -113417,7 +113417,7 @@ } } ], - "specLocation": "connector/delete/ConnectorDeleteRequest.ts#L22-L42" + "specLocation": "connector/delete/ConnectorDeleteRequest.ts#L22-L47" }, { "kind": "response", @@ -113445,7 +113445,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves a connector.", + "description": "Get a connector.\n\nGet the details about a connector.", "inherits": { "type": { "name": "RequestBase", @@ -113471,7 +113471,7 @@ } ], "query": [], - "specLocation": "connector/get/ConnectorGetRequest.ts#L22-L36" + "specLocation": "connector/get/ConnectorGetRequest.ts#L22-L38" }, { "kind": "response", @@ -113629,7 +113629,7 @@ } ] }, - "description": "Updates last sync stats in the connector document", + "description": "Update the connector last sync stats.\n\nUpdate the fields related to the last sync of a connector.\nThis action is used for analytics and monitoring.", "inherits": { "type": { "name": "RequestBase", @@ -113655,7 +113655,7 @@ } ], "query": [], - "specLocation": "connector/last_sync/ConnectorUpdateLastSyncRequest.ts#L26-L57" + "specLocation": "connector/last_sync/ConnectorUpdateLastSyncRequest.ts#L26-L60" }, { "kind": "response", @@ -113689,7 +113689,7 @@ "body": { "kind": "no_body" }, - "description": "Returns existing connectors.", + "description": "Get all connectors.\n\nGet information about all connectors.", "inherits": { "type": { "name": "RequestBase", @@ -113775,7 +113775,7 @@ } } ], - "specLocation": "connector/list/ConnectorListRequest.ts#L23-L57" + "specLocation": "connector/list/ConnectorListRequest.ts#L23-L59" }, { "kind": "response", @@ -113891,7 +113891,7 @@ } ] }, - "description": "Creates a connector.", + "description": "Create a connector.\n\nConnectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", "inherits": { "type": { "name": "RequestBase", @@ -113904,7 +113904,7 @@ }, "path": [], "query": [], - "specLocation": "connector/post/ConnectorPostRequest.ts#L22-L42" + "specLocation": "connector/post/ConnectorPostRequest.ts#L22-L46" }, { "kind": "response", @@ -114017,7 +114017,7 @@ } ] }, - "description": "Creates or updates a connector.", + "description": "Create or update a connector.", "inherits": { "type": { "name": "RequestBase", @@ -114088,7 +114088,7 @@ "body": { "kind": "no_body" }, - "description": "Cancels a connector sync job.", + "description": "Cancel a connector sync job.\n\nCancel a connector sync job, which sets the status to cancelling and updates `cancellation_requested_at` to the current time.\nThe connector service is then responsible for setting the status of connector sync jobs to cancelled.", "inherits": { "type": { "name": "RequestBase", @@ -114114,7 +114114,7 @@ } ], "query": [], - "specLocation": "connector/sync_job_cancel/SyncJobCancelRequest.ts#L22-L36" + "specLocation": "connector/sync_job_cancel/SyncJobCancelRequest.ts#L22-L39" }, { "kind": "response", @@ -114148,7 +114148,7 @@ "body": { "kind": "no_body" }, - "description": "Deletes a connector sync job.", + "description": "Delete a connector sync job.\n\nRemove a connector sync job and its associated data.\nThis is a destructive action that is not recoverable.", "inherits": { "type": { "name": "RequestBase", @@ -114174,7 +114174,7 @@ } ], "query": [], - "specLocation": "connector/sync_job_delete/SyncJobDeleteRequest.ts#L22-L36" + "specLocation": "connector/sync_job_delete/SyncJobDeleteRequest.ts#L22-L39" }, { "kind": "response", @@ -114202,7 +114202,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves a connector sync job.", + "description": "Get a connector sync job.", "inherits": { "type": { "name": "RequestBase", @@ -114256,7 +114256,7 @@ "body": { "kind": "no_body" }, - "description": "Lists connector sync jobs.", + "description": "Get all connector sync jobs.\n\nGet information about all stored connector sync jobs listed by their creation date in ascending order.", "inherits": { "type": { "name": "RequestBase", @@ -114345,7 +114345,7 @@ } } ], - "specLocation": "connector/sync_job_list/SyncJobListRequest.ts#L25-L55" + "specLocation": "connector/sync_job_list/SyncJobListRequest.ts#L25-L57" }, { "kind": "response", @@ -114429,7 +114429,7 @@ } ] }, - "description": "Creates a connector sync job.", + "description": "Create a connector sync job.\n\nCreate a connector sync job document in the internal index and initialize its counters and timestamps with default values.", "inherits": { "type": { "name": "RequestBase", @@ -114442,7 +114442,7 @@ }, "path": [], "query": [], - "specLocation": "connector/sync_job_post/SyncJobPostRequest.ts#L23-L43" + "specLocation": "connector/sync_job_post/SyncJobPostRequest.ts#L23-L45" }, { "kind": "response", @@ -114476,7 +114476,7 @@ "body": { "kind": "no_body" }, - "description": "Activates the valid draft filtering for a connector.", + "description": "Activate the connector draft filter. \n\nActivates the valid draft filtering for a connector.", "inherits": { "type": { "name": "RequestBase", @@ -114502,7 +114502,7 @@ } ], "query": [], - "specLocation": "connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts#L22-L36" + "specLocation": "connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts#L22-L38" }, { "kind": "response", @@ -114560,7 +114560,7 @@ } ] }, - "description": "Updates the API key id in the connector document", + "description": "Update the connector API key ID.\n\nUpdate the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", "inherits": { "type": { "name": "RequestBase", @@ -114586,7 +114586,7 @@ } ], "query": [], - "specLocation": "connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts#L21-L42" + "specLocation": "connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts#L21-L47" }, { "kind": "response", @@ -114651,7 +114651,7 @@ } ] }, - "description": "Updates the configuration field in the connector document", + "description": "Update the connector configuration.\n\nUpdate the configuration field in the connector document.", "inherits": { "type": { "name": "RequestBase", @@ -114677,7 +114677,7 @@ } ], "query": [], - "specLocation": "connector/update_configuration/ConnectorUpdateConfigurationRequest.ts#L25-L47" + "specLocation": "connector/update_configuration/ConnectorUpdateConfigurationRequest.ts#L25-L49" }, { "kind": "response", @@ -114733,7 +114733,7 @@ } ] }, - "description": "Updates the filtering field in the connector document", + "description": "Update the connector error field.\n\nSet the error field for the connector.\nIf the error provided in the request body is non-null, the connector’s status is updated to error.\nOtherwise, if the error is reset to null, the connector status is updated to connected.", "inherits": { "type": { "name": "RequestBase", @@ -114759,7 +114759,7 @@ } ], "query": [], - "specLocation": "connector/update_error/ConnectorUpdateErrorRequest.ts#L23-L44" + "specLocation": "connector/update_error/ConnectorUpdateErrorRequest.ts#L23-L48" }, { "kind": "response", @@ -114834,7 +114834,7 @@ } ] }, - "description": "Updates the filtering field in the connector document", + "description": "Update the connector filtering.\n\nUpdate the draft filtering configuration of a connector and marks the draft validation state as edited.\nThe filtering draft is activated once validated by the running Elastic connector service.\nThe filtering property is used to configure sync rules (both basic and advanced) for a connector.", "inherits": { "type": { "name": "RequestBase", @@ -114860,7 +114860,7 @@ } ], "query": [], - "specLocation": "connector/update_filtering/ConnectorUpdateFilteringRequest.ts#L27-L50" + "specLocation": "connector/update_filtering/ConnectorUpdateFilteringRequest.ts#L27-L54" }, { "kind": "response", @@ -114907,7 +114907,7 @@ } ] }, - "description": "Updates the draft filtering validation info for a connector.", + "description": "Update the connector draft filtering validation.\n\nUpdate the draft filtering validation info for a connector.", "inherits": { "type": { "name": "RequestBase", @@ -114933,7 +114933,7 @@ } ], "query": [], - "specLocation": "connector/update_filtering_validation/ConnectorUpdateFilteringValidationRequest.ts#L23-L40" + "specLocation": "connector/update_filtering_validation/ConnectorUpdateFilteringValidationRequest.ts#L23-L42" }, { "kind": "response", @@ -114989,7 +114989,7 @@ } ] }, - "description": "Updates the index_name in the connector document", + "description": "Update the connector index name.\n\nUpdate the `index_name` field of a connector, specifying the index where the data ingested by the connector is stored.", "inherits": { "type": { "name": "RequestBase", @@ -115015,7 +115015,7 @@ } ], "query": [], - "specLocation": "connector/update_index_name/ConnectorUpdateIndexNameRequest.ts#L23-L43" + "specLocation": "connector/update_index_name/ConnectorUpdateIndexNameRequest.ts#L23-L45" }, { "kind": "response", @@ -115073,7 +115073,7 @@ } ] }, - "description": "Updates the name and description fields in the connector document", + "description": "Update the connector name and description.", "inherits": { "type": { "name": "RequestBase", @@ -115146,7 +115146,7 @@ } ] }, - "description": "Updates the is_native flag in the connector document", + "description": "Update the connector is_native flag.", "inherits": { "type": { "name": "RequestBase", @@ -115219,7 +115219,7 @@ } ] }, - "description": "Updates the pipeline field in the connector document", + "description": "Update the connector pipeline.\n\nWhen you create a new connector, the configuration of an ingest pipeline is populated with default settings.", "inherits": { "type": { "name": "RequestBase", @@ -115245,7 +115245,7 @@ } ], "query": [], - "specLocation": "connector/update_pipeline/ConnectorUpdatePipelineRequest.ts#L23-L44" + "specLocation": "connector/update_pipeline/ConnectorUpdatePipelineRequest.ts#L23-L46" }, { "kind": "response", @@ -115292,7 +115292,7 @@ } ] }, - "description": "Updates the scheduling field in the connector document", + "description": "Update the connector scheduling.", "inherits": { "type": { "name": "RequestBase", @@ -115365,7 +115365,7 @@ } ] }, - "description": "Updates the service type of the connector", + "description": "Update the connector service type.", "inherits": { "type": { "name": "RequestBase", @@ -115438,7 +115438,7 @@ } ] }, - "description": "Updates the status of the connector", + "description": "Update the connector status.", "inherits": { "type": { "name": "RequestBase", diff --git a/specification/connector/check_in/ConnectorCheckInRequest.ts b/specification/connector/check_in/ConnectorCheckInRequest.ts index e4469f0dce..af9c2f915d 100644 --- a/specification/connector/check_in/ConnectorCheckInRequest.ts +++ b/specification/connector/check_in/ConnectorCheckInRequest.ts @@ -22,7 +22,7 @@ import { Id } from '@_types/common' /** * Check in a connector. * - * Updates the `last_seen` field in the connector and sets it to the current timestamp. + * Update the `last_seen` field in the connector and set it to the current timestamp. * @rest_spec_name connector.check_in * @availability stack since=8.12.0 stability=experimental * @availability serverless stability=experimental visibility=public From 28211693306e79d07dfacfff16a577d24fc63efb Mon Sep 17 00:00:00 2001 From: lcawl Date: Tue, 22 Oct 2024 17:11:13 -0700 Subject: [PATCH 03/11] Fix whitespaces --- output/schema/schema.json | 4 ++-- specification/connector/check_in/ConnectorCheckInRequest.ts | 2 +- .../connector/sync_job_delete/SyncJobDeleteRequest.ts | 2 +- .../ConnectorUpdateActiveFilteringRequest.ts | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/output/schema/schema.json b/output/schema/schema.json index b70d9278b8..cfb051bdc5 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -3550,7 +3550,7 @@ "stability": "experimental" } }, - "description": "Activate the connector draft filter. \n\nActivates the valid draft filtering for a connector.", + "description": "Activate the connector draft filter.\n\nActivates the valid draft filtering for a connector.", "docId": "connector-update-filtering", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-filtering-api.html", "name": "connector.update_active_filtering", @@ -114476,7 +114476,7 @@ "body": { "kind": "no_body" }, - "description": "Activate the connector draft filter. \n\nActivates the valid draft filtering for a connector.", + "description": "Activate the connector draft filter.\n\nActivates the valid draft filtering for a connector.", "inherits": { "type": { "name": "RequestBase", diff --git a/specification/connector/check_in/ConnectorCheckInRequest.ts b/specification/connector/check_in/ConnectorCheckInRequest.ts index af9c2f915d..8a7e0628b8 100644 --- a/specification/connector/check_in/ConnectorCheckInRequest.ts +++ b/specification/connector/check_in/ConnectorCheckInRequest.ts @@ -21,7 +21,7 @@ import { Id } from '@_types/common' /** * Check in a connector. - * + * * Update the `last_seen` field in the connector and set it to the current timestamp. * @rest_spec_name connector.check_in * @availability stack since=8.12.0 stability=experimental diff --git a/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts b/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts index 821e17d302..49b0edd1a2 100644 --- a/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts +++ b/specification/connector/sync_job_delete/SyncJobDeleteRequest.ts @@ -23,7 +23,7 @@ import { Id } from '@_types/common' * Delete a connector sync job. * * Remove a connector sync job and its associated data. - * This is a destructive action that is not recoverable. + * This is a destructive action that is not recoverable. * @rest_spec_name connector.sync_job_delete * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts b/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts index 3acd9e9880..d82acff0bb 100644 --- a/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts +++ b/specification/connector/update_active_filtering/ConnectorUpdateActiveFilteringRequest.ts @@ -20,7 +20,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Activate the connector draft filter. + * Activate the connector draft filter. * * Activates the valid draft filtering for a connector. * @rest_spec_name connector.update_active_filtering From ee9e7b17d48387710fe17341cf9d4ff87abff24d Mon Sep 17 00:00:00 2001 From: Lisa Cawley Date: Wed, 23 Oct 2024 07:36:10 -0700 Subject: [PATCH 04/11] Update docs/overlays/elasticsearch-shared-overlays.yaml Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com> --- docs/overlays/elasticsearch-shared-overlays.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml index bb1721e2bd..8cbbd397fe 100644 --- a/docs/overlays/elasticsearch-shared-overlays.yaml +++ b/docs/overlays/elasticsearch-shared-overlays.yaml @@ -35,9 +35,9 @@ actions: Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure: - * Native connectors are a managed service on Elastic Cloud + * Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud - * Connector clients are self-managed on your infrastructure + * Self-managed connectors (Connector clients) are self-managed on your infrastructure This API provides an alternative to relying solely on Kibana UI for connector and sync job management. The API comes with a set of validations and assertions to ensure that the state representation in the internal index remains valid. externalDocs: From 44b3b967f1c45b112b7a4b388c42f94fb820bc30 Mon Sep 17 00:00:00 2001 From: lcawl Date: Wed, 23 Oct 2024 07:51:53 -0700 Subject: [PATCH 05/11] Fix connector terminology --- specification/connector/post/ConnectorPostRequest.ts | 4 ++-- .../update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/connector/post/ConnectorPostRequest.ts b/specification/connector/post/ConnectorPostRequest.ts index 56e67c690f..5062c10df5 100644 --- a/specification/connector/post/ConnectorPostRequest.ts +++ b/specification/connector/post/ConnectorPostRequest.ts @@ -23,8 +23,8 @@ import { IndexName } from '@_types/common' * Create a connector. * * Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure. - * Native connectors are a managed service on Elastic Cloud. - * Connector clients are self-managed on your infrastructure. + * Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud. + * Self-managed connectors (Connector clients) are self-managed on your infrastructure. * @rest_spec_name connector.post * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public diff --git a/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts b/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts index 9f002b6ddd..6ef8fc506b 100644 --- a/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts +++ b/specification/connector/update_api_key_id/ConnectorUpdateAPIKeyIDRequest.ts @@ -23,8 +23,8 @@ import { Id } from '@_types/common' * * Update the `api_key_id` and `api_key_secret_id` fields of a connector. * You can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored. - * The connector secret ID is required only for native connectors. - * Connector clients do not use this field. + * The connector secret ID is required only for Elastic managed (native) connectors. + * Self-managed connectors (connector clients) do not use this field. * @rest_spec_name connector.update_api_key_id * @availability stack since=8.12.0 stability=beta * @availability serverless stability=beta visibility=public From b97b337998c1ee7a789efd6d9a56b7e76172b718 Mon Sep 17 00:00:00 2001 From: lcawl Date: Wed, 23 Oct 2024 07:52:42 -0700 Subject: [PATCH 06/11] Generate output --- output/openapi/elasticsearch-openapi.json | 4 ++-- output/openapi/elasticsearch-serverless-openapi.json | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 23fc3ed728..1cb28c2448 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -4388,7 +4388,7 @@ "connector" ], "summary": "Create a connector", - "description": "Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", + "description": "Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nElastic managed connectors (Native connectors) are a managed service on Elastic Cloud.\nSelf-managed connectors (Connector clients) are self-managed on your infrastructure.", "operationId": "connector-post", "requestBody": { "content": { @@ -4762,7 +4762,7 @@ "connector" ], "summary": "Update the connector API key ID", - "description": "Update the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", + "description": "Update the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for Elastic managed (native) connectors.\nSelf-managed connectors (connector clients) do not use this field.", "operationId": "connector-update-api-key-id", "parameters": [ { diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index 0b3f93e702..67f9f3960a 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -1967,7 +1967,7 @@ "connector" ], "summary": "Create a connector", - "description": "Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", + "description": "Connectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nElastic managed connectors (Native connectors) are a managed service on Elastic Cloud.\nSelf-managed connectors (Connector clients) are self-managed on your infrastructure.", "operationId": "connector-post", "requestBody": { "content": { @@ -2341,7 +2341,7 @@ "connector" ], "summary": "Update the connector API key ID", - "description": "Update the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", + "description": "Update the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for Elastic managed (native) connectors.\nSelf-managed connectors (connector clients) do not use this field.", "operationId": "connector-update-api-key-id", "parameters": [ { From bb28e00c27d4199e606e5f52e8ebe70c87c18bda Mon Sep 17 00:00:00 2001 From: lcawl Date: Wed, 23 Oct 2024 07:57:44 -0700 Subject: [PATCH 07/11] Update overlay URLs --- .../elasticsearch-shared-overlays.yaml | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml index 8cbbd397fe..a83a5b2be6 100644 --- a/docs/overlays/elasticsearch-shared-overlays.yaml +++ b/docs/overlays/elasticsearch-shared-overlays.yaml @@ -41,7 +41,7 @@ actions: This API provides an alternative to relying solely on Kibana UI for connector and sync job management. The API comes with a set of validations and assertions to ensure that the state representation in the internal index remains valid. externalDocs: - url: https://www.elastic.co/guide/en/enterprise-search/current/connectors-tutorial-api.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/es-connectors-tutorial-api.html description: To get started with Connector APIs, check out the tutorial. - name: ccr x-displayName: Cross-cluster replication @@ -72,14 +72,14 @@ actions: description: > Event Query Language (EQL) is a query language for event-based time series data, such as logs, metrics, and traces. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/eql.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/eql.html description: EQL search - name: esql x-displayName: ES|QL description: > The Elasticsearch Query Language (ES|QL) provides a powerful way to filter, transform, and analyze data stored in Elasticsearch, and in the future in other runtimes. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/esql.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/esql.html description: ES|QL overview and tutorials # F - name: features @@ -93,7 +93,7 @@ actions: description: > The graph explore API enables you to extract and summarize information about the documents and terms in an Elasticsearch data stream or index. externalDocs: - url: https://www.elastic.co/guide/en/kibana/current/xpack-graph.html + url: https://www.elastic.co/guide/en/kibana/master/xpack-graph.html description: Getting started with Graph # I - name: indices @@ -105,7 +105,7 @@ actions: - name: ilm x-displayName: Index lifecycle management externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/index-lifecycle-management.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/index-lifecycle-management.html description: Manage the index lifecycle - name: inference x-displayName: Inference @@ -127,7 +127,7 @@ actions: description: > Logstash APIs enable you to manage pipelines that are used by Logstash Central Management. externalDocs: - url: https://www.elastic.co/guide/en/logstash/current/logstash-centralized-pipeline-management.html + url: https://www.elastic.co/guide/en/logstash/master/logstash-centralized-pipeline-management.html description: Centralized pipeline management # M - name: ml @@ -168,7 +168,7 @@ actions: If a query matches one or more rules in the ruleset, the query is re-written to apply the rules before searching. This allows pinning documents for only queries that match a specific term. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-rule-query.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/query-dsl-rule-query.html description: Rule query # R - name: rollup @@ -201,21 +201,21 @@ actions: description: > Snapshot and restore APIs enable you to set up snapshot repositories, manage snapshot backups, and restore snapshots to a running cluster. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshot-restore.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/snapshot-restore.html description: Snapshot and restore - name: slm x-displayName: Snapshot lifecycle management description: > Snapshot lifecycle management (SLM) APIs enable you to set up policies to automatically take snapshots and control how long they are retained. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshots-take-snapshot.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/snapshots-take-snapshot.html description: Create a snapshot - name: sql x-displayName: SQL description: > Elasticsearch's SQL APIs enable you to run SQL queries on Elasticsearch indices and data streams. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/xpack-sql.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/xpack-sql.html description: An overview and tutorials for the Elasticsearch SQL features - name: synonyms x-displayName: Synonyms @@ -1017,7 +1017,7 @@ actions: All the options that are supported by Elasticsearch can be used, as this object is passed verbatim to Elasticsearch. By default, this property has the following value: `{"match_all": {"boost": 1}}`. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/query-dsl.html description: Query DSL - target: "$.components['schemas']['ml._types:CategorizationAnalyzerDefinition'].properties.tokenizer" description: Remove tokenizer object from ML anomaly detection analysis config @@ -1038,7 +1038,7 @@ actions: Additionally, the `ml_classic` tokenizer is available, which tokenizes in the same way as the non-customizable tokenizer in old versions of the product (before 6.2). `ml_classic` was the default categorization tokenizer in versions 6.2 to 7.13, so if you need categorization identical to the default for jobs created in these versions, specify `"tokenizer": "ml_classic"` in your `categorization_analyzer`. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-tokenizers.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/analysis-tokenizers.html description: Tokenizer reference - target: "$.components['schemas']['ml._types:DataframeAnalyticsSource'].properties.query" description: Remove query object from data frame analytics source @@ -1055,7 +1055,7 @@ actions: All the options that are supported by Elasticsearch can be used, as this object is passed verbatim to Elasticsearch. By default, this property has the following value: `{"match_all": {}}`. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/query-dsl.html description: Query DSL - target: "$.components['schemas']['transform._types:Source'].properties.query" description: Remove query object from transform source @@ -1069,7 +1069,7 @@ actions: description: > A query clause that retrieves a subset of data from the source index. externalDocs: - url: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html + url: https://www.elastic.co/guide/en/elasticsearch/reference/master/query-dsl.html description: Query DSL # Examples - target: "$.components['requestBodies']['async_search.submit']" From 5f6977de5d13f8f3ce17a48057292f0dd50dcb27 Mon Sep 17 00:00:00 2001 From: Lisa Cawley Date: Wed, 23 Oct 2024 08:19:48 -0700 Subject: [PATCH 08/11] Update docs/overlays/elasticsearch-shared-overlays.yaml Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com> --- docs/overlays/elasticsearch-shared-overlays.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml index a83a5b2be6..52c5b8167d 100644 --- a/docs/overlays/elasticsearch-shared-overlays.yaml +++ b/docs/overlays/elasticsearch-shared-overlays.yaml @@ -37,7 +37,7 @@ actions: * Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud - * Self-managed connectors (Connector clients) are self-managed on your infrastructure + * Self-managed connectors (Connector clients) are self-managed on your infrastructure. This API provides an alternative to relying solely on Kibana UI for connector and sync job management. The API comes with a set of validations and assertions to ensure that the state representation in the internal index remains valid. externalDocs: From 978f1ae49bd82dba827325b4e53b0d3957374cae Mon Sep 17 00:00:00 2001 From: Lisa Cawley Date: Wed, 23 Oct 2024 08:20:52 -0700 Subject: [PATCH 09/11] Update docs/overlays/elasticsearch-shared-overlays.yaml Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com> --- docs/overlays/elasticsearch-shared-overlays.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml index c0b6b65949..4f612ebcd5 100644 --- a/docs/overlays/elasticsearch-shared-overlays.yaml +++ b/docs/overlays/elasticsearch-shared-overlays.yaml @@ -42,7 +42,7 @@ actions: This API provides an alternative to relying solely on Kibana UI for connector and sync job management. The API comes with a set of validations and assertions to ensure that the state representation in the internal index remains valid. externalDocs: url: https://www.elastic.co/guide/en/elasticsearch/reference/master/es-connectors-tutorial-api.html - description: To get started with Connector APIs, check out the tutorial. + description: Connector API tutorial - name: ccr x-displayName: Cross-cluster replication # D From 0b33664eda3e79e752241699a906716f3f69309a Mon Sep 17 00:00:00 2001 From: lcawl Date: Wed, 23 Oct 2024 08:27:53 -0700 Subject: [PATCH 10/11] Regenerate output --- output/schema/schema.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/output/schema/schema.json b/output/schema/schema.json index d3cee887bc..3bcf5f45cd 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -3074,7 +3074,7 @@ "stability": "beta" } }, - "description": "Create a connector.\n\nConnectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", + "description": "Create a connector.\n\nConnectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nElastic managed connectors (Native connectors) are a managed service on Elastic Cloud.\nSelf-managed connectors (Connector clients) are self-managed on your infrastructure.", "docId": "connector-post", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/create-connector-api.html", "name": "connector.post", @@ -3589,7 +3589,7 @@ "stability": "beta" } }, - "description": "Update the connector API key ID.\n\nUpdate the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", + "description": "Update the connector API key ID.\n\nUpdate the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for Elastic managed (native) connectors.\nSelf-managed connectors (connector clients) do not use this field.", "docId": "connector-update-api-key-id", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/update-connector-api-key-id-api.html", "name": "connector.update_api_key_id", @@ -113895,7 +113895,7 @@ } ] }, - "description": "Create a connector.\n\nConnectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nNative connectors are a managed service on Elastic Cloud.\nConnector clients are self-managed on your infrastructure.", + "description": "Create a connector.\n\nConnectors are Elasticsearch integrations that bring content from third-party data sources, which can be deployed on Elastic Cloud or hosted on your own infrastructure.\nElastic managed connectors (Native connectors) are a managed service on Elastic Cloud.\nSelf-managed connectors (Connector clients) are self-managed on your infrastructure.", "inherits": { "type": { "name": "RequestBase", @@ -114564,7 +114564,7 @@ } ] }, - "description": "Update the connector API key ID.\n\nUpdate the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for native connectors.\nConnector clients do not use this field.", + "description": "Update the connector API key ID.\n\nUpdate the `api_key_id` and `api_key_secret_id` fields of a connector.\nYou can specify the ID of the API key used for authorization and the ID of the connector secret where the API key is stored.\nThe connector secret ID is required only for Elastic managed (native) connectors.\nSelf-managed connectors (connector clients) do not use this field.", "inherits": { "type": { "name": "RequestBase", From b5ebd0ad4979bc82020bcd52dc7ac69ff51ccb27 Mon Sep 17 00:00:00 2001 From: lcawl Date: Wed, 23 Oct 2024 08:32:51 -0700 Subject: [PATCH 11/11] Fix spacing in intro --- docs/overlays/elasticsearch-shared-overlays.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml index 4f612ebcd5..ce78fe914b 100644 --- a/docs/overlays/elasticsearch-shared-overlays.yaml +++ b/docs/overlays/elasticsearch-shared-overlays.yaml @@ -39,6 +39,7 @@ actions: * Self-managed connectors (Connector clients) are self-managed on your infrastructure. + This API provides an alternative to relying solely on Kibana UI for connector and sync job management. The API comes with a set of validations and assertions to ensure that the state representation in the internal index remains valid. externalDocs: url: https://www.elastic.co/guide/en/elasticsearch/reference/master/es-connectors-tutorial-api.html