Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[OpenAPI] Edits connector API summaries #3051

Merged
merged 13 commits into from
Oct 23, 2024
33 changes: 17 additions & 16 deletions docs/overlays/elasticsearch-shared-overlays.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -35,12 +35,13 @@ 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
* Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud

* Self-managed connectors (Connector clients) are self-managed on your infrastructure
lcawl marked this conversation as resolved.
Show resolved Hide resolved

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.
lcawl marked this conversation as resolved.
Show resolved Hide resolved
- name: ccr
x-displayName: Cross-cluster replication
Expand Down Expand Up @@ -71,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
Expand All @@ -92,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
Expand All @@ -104,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
Expand All @@ -126,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
Expand Down Expand Up @@ -167,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
Expand Down Expand Up @@ -200,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
Expand Down Expand Up @@ -1016,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
Expand All @@ -1037,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
Expand All @@ -1054,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
Expand All @@ -1068,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']"
Expand Down
70 changes: 44 additions & 26 deletions output/openapi/elasticsearch-openapi.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading