Class ElasticsearchConnectorAsyncClient
- All Implemented Interfaces:
Closeable
,AutoCloseable
-
Field Summary
Fields inherited from class co.elastic.clients.ApiClient
transport, transportOptions
-
Constructor Summary
ConstructorsConstructorDescriptionElasticsearchConnectorAsyncClient
(ElasticsearchTransport transport, TransportOptions transportOptions) -
Method Summary
Modifier and TypeMethodDescriptioncheckIn
(CheckInRequest request) Check in a connector.final CompletableFuture<CheckInResponse>
Check in a connector.delete
(DeleteConnectorRequest request) Delete a connector.Delete a connector.get
(GetConnectorRequest request) Get a connector.Get a connector.list()
Get all connectors.list
(ListRequest request) Get all connectors.final CompletableFuture<ListResponse>
Get all connectors.post()
Create a connector.post
(PostRequest request) Create a connector.final CompletableFuture<PostResponse>
Create a connector.put()
Create or update a connector.put
(PutRequest request) Create or update a connector.final CompletableFuture<PutResponse>
Create or update a connector.syncJobCancel
(SyncJobCancelRequest request) Cancel a connector sync job.Cancel a connector sync job.syncJobCheckIn
(SyncJobCheckInRequest request) Check in a connector sync job.Check in a connector sync job.syncJobClaim
(SyncJobClaimRequest request) Claim a connector sync job.Claim a connector sync job.syncJobDelete
(SyncJobDeleteRequest request) Delete a connector sync job.Delete a connector sync job.syncJobError
(SyncJobErrorRequest request) Set a connector sync job error.Set a connector sync job error.syncJobGet
(SyncJobGetRequest request) Get a connector sync job.Get a connector sync job.Get all connector sync jobs.syncJobList
(SyncJobListRequest request) Get all connector sync jobs.Get all connector sync jobs.syncJobPost
(SyncJobPostRequest request) Create a connector sync job.Create a connector sync job.Set the connector sync job stats.syncJobUpdateStats
(Function<SyncJobUpdateStatsRequest.Builder, ObjectBuilder<SyncJobUpdateStatsRequest>> fn) Set the connector sync job stats.Activate the connector draft filter.updateActiveFiltering
(Function<UpdateActiveFilteringRequest.Builder, ObjectBuilder<UpdateActiveFilteringRequest>> fn) Activate the connector draft filter.updateApiKeyId
(UpdateApiKeyIdRequest request) Update the connector API key ID.Update the connector API key ID.Update the connector configuration.updateConfiguration
(Function<UpdateConfigurationRequest.Builder, ObjectBuilder<UpdateConfigurationRequest>> fn) Update the connector configuration.updateError
(UpdateErrorRequest request) Update the connector error field.Update the connector error field.updateFeatures
(UpdateFeaturesRequest request) Update the connector features.Update the connector features.updateFiltering
(UpdateFilteringRequest request) Update the connector filtering.Update the connector filtering.Update the connector draft filtering validation.updateFilteringValidation
(Function<UpdateFilteringValidationRequest.Builder, ObjectBuilder<UpdateFilteringValidationRequest>> fn) Update the connector draft filtering validation.updateIndexName
(UpdateIndexNameRequest request) Update the connector index name.Update the connector index name.updateName
(UpdateNameRequest request) Update the connector name and description.Update the connector name and description.updateNative
(UpdateNativeRequest request) Update the connector is_native flag.Update the connector is_native flag.updatePipeline
(UpdatePipelineRequest request) Update the connector pipeline.Update the connector pipeline.updateScheduling
(UpdateSchedulingRequest request) Update the connector scheduling.updateScheduling
(Function<UpdateSchedulingRequest.Builder, ObjectBuilder<UpdateSchedulingRequest>> fn) Update the connector scheduling.Update the connector service type.updateServiceType
(Function<UpdateServiceTypeRequest.Builder, ObjectBuilder<UpdateServiceTypeRequest>> fn) Update the connector service type.updateStatus
(UpdateStatusRequest request) Update the connector status.Update the connector status.withTransportOptions
(TransportOptions transportOptions) Creates a new client with some request optionsMethods inherited from class co.elastic.clients.ApiClient
_jsonpMapper, _transport, _transportOptions, close, getDeserializer, withTransportOptions
-
Constructor Details
-
ElasticsearchConnectorAsyncClient
-
ElasticsearchConnectorAsyncClient
public ElasticsearchConnectorAsyncClient(ElasticsearchTransport transport, @Nullable TransportOptions transportOptions)
-
-
Method Details
-
withTransportOptions
public ElasticsearchConnectorAsyncClient withTransportOptions(@Nullable TransportOptions transportOptions) Description copied from class:ApiClient
Creates a new client with some request options- Specified by:
withTransportOptions
in classApiClient<ElasticsearchTransport,
ElasticsearchConnectorAsyncClient>
-
checkIn
Check in a connector.Update the
last_seen
field in the connector and set it to the current timestamp.- See Also:
-
checkIn
public final CompletableFuture<CheckInResponse> checkIn(Function<CheckInRequest.Builder, ObjectBuilder<CheckInRequest>> fn) Check in a connector.Update the
last_seen
field in the connector and set it to the current timestamp.- Parameters:
fn
- a function that initializes a builder to create theCheckInRequest
- See Also:
-
delete
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.
- See Also:
-
delete
public final CompletableFuture<DeleteConnectorResponse> delete(Function<DeleteConnectorRequest.Builder, ObjectBuilder<DeleteConnectorRequest>> fn) 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.
- Parameters:
fn
- a function that initializes a builder to create theDeleteConnectorRequest
- See Also:
-
get
Get a connector.Get the details about a connector.
- See Also:
-
get
public final CompletableFuture<GetConnectorResponse> get(Function<GetConnectorRequest.Builder, ObjectBuilder<GetConnectorRequest>> fn) Get a connector.Get the details about a connector.
- Parameters:
fn
- a function that initializes a builder to create theGetConnectorRequest
- See Also:
-
list
Get all connectors.Get information about all connectors.
- See Also:
-
list
public final CompletableFuture<ListResponse> list(Function<ListRequest.Builder, ObjectBuilder<ListRequest>> fn) Get all connectors.Get information about all connectors.
- Parameters:
fn
- a function that initializes a builder to create theListRequest
- See Also:
-
list
Get all connectors.Get information about all connectors.
- See Also:
-
post
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. Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud. Self-managed connectors (Connector clients) are self-managed on your infrastructure.
- See Also:
-
post
public final CompletableFuture<PostResponse> post(Function<PostRequest.Builder, ObjectBuilder<PostRequest>> fn) 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. Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud. Self-managed connectors (Connector clients) are self-managed on your infrastructure.
- Parameters:
fn
- a function that initializes a builder to create thePostRequest
- See Also:
-
post
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. Elastic managed connectors (Native connectors) are a managed service on Elastic Cloud. Self-managed connectors (Connector clients) are self-managed on your infrastructure.
- See Also:
-
put
Create or update a connector.- See Also:
-
put
public final CompletableFuture<PutResponse> put(Function<PutRequest.Builder, ObjectBuilder<PutRequest>> fn) Create or update a connector.- Parameters:
fn
- a function that initializes a builder to create thePutRequest
- See Also:
-
put
Create or update a connector.- See Also:
-
syncJobCancel
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.- See Also:
-
syncJobCancel
public final CompletableFuture<SyncJobCancelResponse> syncJobCancel(Function<SyncJobCancelRequest.Builder, ObjectBuilder<SyncJobCancelRequest>> fn) 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.- Parameters:
fn
- a function that initializes a builder to create theSyncJobCancelRequest
- See Also:
-
syncJobCheckIn
Check in a connector sync job. Check in a connector sync job and set thelast_seen
field to the current time before updating it in the internal index.To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- See Also:
-
syncJobCheckIn
public final CompletableFuture<SyncJobCheckInResponse> syncJobCheckIn(Function<SyncJobCheckInRequest.Builder, ObjectBuilder<SyncJobCheckInRequest>> fn) Check in a connector sync job. Check in a connector sync job and set thelast_seen
field to the current time before updating it in the internal index.To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- Parameters:
fn
- a function that initializes a builder to create theSyncJobCheckInRequest
- See Also:
-
syncJobClaim
Claim a connector sync job. This action updates the job status toin_progress
and sets thelast_seen
andstarted_at
timestamps to the current time. Additionally, it can set thesync_cursor
property for the sync job.This API is not intended for direct connector management by users. It supports the implementation of services that utilize the connector protocol to communicate with Elasticsearch.
To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- See Also:
-
syncJobClaim
public final CompletableFuture<SyncJobClaimResponse> syncJobClaim(Function<SyncJobClaimRequest.Builder, ObjectBuilder<SyncJobClaimRequest>> fn) Claim a connector sync job. This action updates the job status toin_progress
and sets thelast_seen
andstarted_at
timestamps to the current time. Additionally, it can set thesync_cursor
property for the sync job.This API is not intended for direct connector management by users. It supports the implementation of services that utilize the connector protocol to communicate with Elasticsearch.
To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- Parameters:
fn
- a function that initializes a builder to create theSyncJobClaimRequest
- See Also:
-
syncJobDelete
Delete a connector sync job.Remove a connector sync job and its associated data. This is a destructive action that is not recoverable.
- See Also:
-
syncJobDelete
public final CompletableFuture<SyncJobDeleteResponse> syncJobDelete(Function<SyncJobDeleteRequest.Builder, ObjectBuilder<SyncJobDeleteRequest>> fn) Delete a connector sync job.Remove a connector sync job and its associated data. This is a destructive action that is not recoverable.
- Parameters:
fn
- a function that initializes a builder to create theSyncJobDeleteRequest
- See Also:
-
syncJobError
Set a connector sync job error. Set theerror
field for a connector sync job and set itsstatus
toerror
.To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- See Also:
-
syncJobError
public final CompletableFuture<SyncJobErrorResponse> syncJobError(Function<SyncJobErrorRequest.Builder, ObjectBuilder<SyncJobErrorRequest>> fn) Set a connector sync job error. Set theerror
field for a connector sync job and set itsstatus
toerror
.To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- Parameters:
fn
- a function that initializes a builder to create theSyncJobErrorRequest
- See Also:
-
syncJobGet
Get a connector sync job.- See Also:
-
syncJobGet
public final CompletableFuture<SyncJobGetResponse> syncJobGet(Function<SyncJobGetRequest.Builder, ObjectBuilder<SyncJobGetRequest>> fn) Get a connector sync job.- Parameters:
fn
- a function that initializes a builder to create theSyncJobGetRequest
- See Also:
-
syncJobList
Get all connector sync jobs.Get information about all stored connector sync jobs listed by their creation date in ascending order.
- See Also:
-
syncJobList
public final CompletableFuture<SyncJobListResponse> syncJobList(Function<SyncJobListRequest.Builder, ObjectBuilder<SyncJobListRequest>> fn) Get all connector sync jobs.Get information about all stored connector sync jobs listed by their creation date in ascending order.
- Parameters:
fn
- a function that initializes a builder to create theSyncJobListRequest
- See Also:
-
syncJobList
Get all connector sync jobs.Get information about all stored connector sync jobs listed by their creation date in ascending order.
- See Also:
-
syncJobPost
Create a connector sync job.Create a connector sync job document in the internal index and initialize its counters and timestamps with default values.
- See Also:
-
syncJobPost
public final CompletableFuture<SyncJobPostResponse> syncJobPost(Function<SyncJobPostRequest.Builder, ObjectBuilder<SyncJobPostRequest>> fn) Create a connector sync job.Create a connector sync job document in the internal index and initialize its counters and timestamps with default values.
- Parameters:
fn
- a function that initializes a builder to create theSyncJobPostRequest
- See Also:
-
syncJobUpdateStats
public CompletableFuture<SyncJobUpdateStatsResponse> syncJobUpdateStats(SyncJobUpdateStatsRequest request) Set the connector sync job stats. Stats include:deleted_document_count
,indexed_document_count
,indexed_document_volume
, andtotal_document_count
. You can also updatelast_seen
. This API is mainly used by the connector service for updating sync job information.To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- See Also:
-
syncJobUpdateStats
public final CompletableFuture<SyncJobUpdateStatsResponse> syncJobUpdateStats(Function<SyncJobUpdateStatsRequest.Builder, ObjectBuilder<SyncJobUpdateStatsRequest>> fn) Set the connector sync job stats. Stats include:deleted_document_count
,indexed_document_count
,indexed_document_volume
, andtotal_document_count
. You can also updatelast_seen
. This API is mainly used by the connector service for updating sync job information.To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- Parameters:
fn
- a function that initializes a builder to create theSyncJobUpdateStatsRequest
- See Also:
-
updateActiveFiltering
public CompletableFuture<UpdateActiveFilteringResponse> updateActiveFiltering(UpdateActiveFilteringRequest request) Activate the connector draft filter.Activates the valid draft filtering for a connector.
- See Also:
-
updateActiveFiltering
public final CompletableFuture<UpdateActiveFilteringResponse> updateActiveFiltering(Function<UpdateActiveFilteringRequest.Builder, ObjectBuilder<UpdateActiveFilteringRequest>> fn) Activate the connector draft filter.Activates the valid draft filtering for a connector.
- Parameters:
fn
- a function that initializes a builder to create theUpdateActiveFilteringRequest
- See Also:
-
updateApiKeyId
Update the connector API key ID.Update the
api_key_id
andapi_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 Elastic managed (native) connectors. Self-managed connectors (connector clients) do not use this field.- See Also:
-
updateApiKeyId
public final CompletableFuture<UpdateApiKeyIdResponse> updateApiKeyId(Function<UpdateApiKeyIdRequest.Builder, ObjectBuilder<UpdateApiKeyIdRequest>> fn) Update the connector API key ID.Update the
api_key_id
andapi_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 Elastic managed (native) connectors. Self-managed connectors (connector clients) do not use this field.- Parameters:
fn
- a function that initializes a builder to create theUpdateApiKeyIdRequest
- See Also:
-
updateConfiguration
public CompletableFuture<UpdateConfigurationResponse> updateConfiguration(UpdateConfigurationRequest request) Update the connector configuration.Update the configuration field in the connector document.
- See Also:
-
updateConfiguration
public final CompletableFuture<UpdateConfigurationResponse> updateConfiguration(Function<UpdateConfigurationRequest.Builder, ObjectBuilder<UpdateConfigurationRequest>> fn) Update the connector configuration.Update the configuration field in the connector document.
- Parameters:
fn
- a function that initializes a builder to create theUpdateConfigurationRequest
- See Also:
-
updateError
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.
- See Also:
-
updateError
public final CompletableFuture<UpdateErrorResponse> updateError(Function<UpdateErrorRequest.Builder, ObjectBuilder<UpdateErrorRequest>> fn) 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.
- Parameters:
fn
- a function that initializes a builder to create theUpdateErrorRequest
- See Also:
-
updateFeatures
Update the connector features. Update the connector features in the connector document. This API can be used to control the following aspects of a connector:- document-level security
- incremental syncs
- advanced sync rules
- basic sync rules
Normally, the running connector service automatically manages these features. However, you can use this API to override the default behavior.
To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- See Also:
-
updateFeatures
public final CompletableFuture<UpdateFeaturesResponse> updateFeatures(Function<UpdateFeaturesRequest.Builder, ObjectBuilder<UpdateFeaturesRequest>> fn) Update the connector features. Update the connector features in the connector document. This API can be used to control the following aspects of a connector:- document-level security
- incremental syncs
- advanced sync rules
- basic sync rules
Normally, the running connector service automatically manages these features. However, you can use this API to override the default behavior.
To sync data using self-managed connectors, you need to deploy the Elastic connector service on your own infrastructure. This service runs automatically on Elastic Cloud for Elastic managed connectors.
- Parameters:
fn
- a function that initializes a builder to create theUpdateFeaturesRequest
- See Also:
-
updateFiltering
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.
- See Also:
-
updateFiltering
public final CompletableFuture<UpdateFilteringResponse> updateFiltering(Function<UpdateFilteringRequest.Builder, ObjectBuilder<UpdateFilteringRequest>> fn) 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.
- Parameters:
fn
- a function that initializes a builder to create theUpdateFilteringRequest
- See Also:
-
updateFilteringValidation
public CompletableFuture<UpdateFilteringValidationResponse> updateFilteringValidation(UpdateFilteringValidationRequest request) Update the connector draft filtering validation.Update the draft filtering validation info for a connector.
- See Also:
-
updateFilteringValidation
public final CompletableFuture<UpdateFilteringValidationResponse> updateFilteringValidation(Function<UpdateFilteringValidationRequest.Builder, ObjectBuilder<UpdateFilteringValidationRequest>> fn) Update the connector draft filtering validation.Update the draft filtering validation info for a connector.
- Parameters:
fn
- a function that initializes a builder to create theUpdateFilteringValidationRequest
- See Also:
-
updateIndexName
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.- See Also:
-
updateIndexName
public final CompletableFuture<UpdateIndexNameResponse> updateIndexName(Function<UpdateIndexNameRequest.Builder, ObjectBuilder<UpdateIndexNameRequest>> fn) 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.- Parameters:
fn
- a function that initializes a builder to create theUpdateIndexNameRequest
- See Also:
-
updateName
Update the connector name and description.- See Also:
-
updateName
public final CompletableFuture<UpdateNameResponse> updateName(Function<UpdateNameRequest.Builder, ObjectBuilder<UpdateNameRequest>> fn) Update the connector name and description.- Parameters:
fn
- a function that initializes a builder to create theUpdateNameRequest
- See Also:
-
updateNative
Update the connector is_native flag.- See Also:
-
updateNative
public final CompletableFuture<UpdateNativeResponse> updateNative(Function<UpdateNativeRequest.Builder, ObjectBuilder<UpdateNativeRequest>> fn) Update the connector is_native flag.- Parameters:
fn
- a function that initializes a builder to create theUpdateNativeRequest
- See Also:
-
updatePipeline
Update the connector pipeline.When you create a new connector, the configuration of an ingest pipeline is populated with default settings.
- See Also:
-
updatePipeline
public final CompletableFuture<UpdatePipelineResponse> updatePipeline(Function<UpdatePipelineRequest.Builder, ObjectBuilder<UpdatePipelineRequest>> fn) Update the connector pipeline.When you create a new connector, the configuration of an ingest pipeline is populated with default settings.
- Parameters:
fn
- a function that initializes a builder to create theUpdatePipelineRequest
- See Also:
-
updateScheduling
public CompletableFuture<UpdateSchedulingResponse> updateScheduling(UpdateSchedulingRequest request) Update the connector scheduling.- See Also:
-
updateScheduling
public final CompletableFuture<UpdateSchedulingResponse> updateScheduling(Function<UpdateSchedulingRequest.Builder, ObjectBuilder<UpdateSchedulingRequest>> fn) Update the connector scheduling.- Parameters:
fn
- a function that initializes a builder to create theUpdateSchedulingRequest
- See Also:
-
updateServiceType
public CompletableFuture<UpdateServiceTypeResponse> updateServiceType(UpdateServiceTypeRequest request) Update the connector service type.- See Also:
-
updateServiceType
public final CompletableFuture<UpdateServiceTypeResponse> updateServiceType(Function<UpdateServiceTypeRequest.Builder, ObjectBuilder<UpdateServiceTypeRequest>> fn) Update the connector service type.- Parameters:
fn
- a function that initializes a builder to create theUpdateServiceTypeRequest
- See Also:
-
updateStatus
Update the connector status.- See Also:
-
updateStatus
public final CompletableFuture<UpdateStatusResponse> updateStatus(Function<UpdateStatusRequest.Builder, ObjectBuilder<UpdateStatusRequest>> fn) Update the connector status.- Parameters:
fn
- a function that initializes a builder to create theUpdateStatusRequest
- See Also:
-