Skip to content

Commit

Permalink
Add specification for claim connector sync job (#3366) (#3387)
Browse files Browse the repository at this point in the history
(cherry picked from commit 68dcbfb)
  • Loading branch information
lcawl authored Dec 19, 2024
1 parent 0960a6e commit 6c3b4fc
Show file tree
Hide file tree
Showing 7 changed files with 230 additions and 10 deletions.
59 changes: 59 additions & 0 deletions output/openapi/elasticsearch-openapi.json

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

85 changes: 81 additions & 4 deletions output/schema/schema.json

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

6 changes: 0 additions & 6 deletions output/schema/validation-errors.json

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

11 changes: 11 additions & 0 deletions output/typescript/types.ts

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

2 changes: 2 additions & 0 deletions specification/_doc_ids/table.csv
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,8 @@ cluster,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cluster
common-options,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/common-options.html
community-id-processor,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/community-id-processor.html
connector-sync-job-cancel,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/cancel-connector-sync-job-api.html
connector-sync-job-checkin,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/check-in-connector-sync-job-api.html
connector-sync-job-claim,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/claim-connector-sync-job-api.html
collapse-search-results,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/collapse-search-results.html
connector-sync-job-delete,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-connector-sync-job-api.html
connector-sync-job-get,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-connector-sync-job-api.html
Expand Down
55 changes: 55 additions & 0 deletions specification/connector/sync_job_claim/SyncJobClaimRequest.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
/*
* Licensed to Elasticsearch B.V. under one or more contributor
* license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright
* ownership. Elasticsearch B.V. licenses this file to you under
* the Apache License, Version 2.0 (the "License"); you may
* not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
import { UserDefinedValue } from '@spec_utils/UserDefinedValue'
import { RequestBase } from '@_types/Base'
import { Id } from '@_types/common'

/**
* Claim a connector sync job.
* This action updates the job status to `in_progress` and sets the `last_seen` and `started_at` timestamps to the current time.
* Additionally, it can set the `sync_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.
* @rest_spec_name connector.sync_job_claim
* @availability stack stability=experimental visibility=public
* @doc_id connector-sync-job-claim
*/
export interface Request extends RequestBase {
path_parts: {
/**
* The unique identifier of the connector sync job.
*/
connector_sync_job_id: Id
}
body: {
/**
* The cursor object from the last incremental sync job.
* This should reference the `sync_cursor` field in the connector state for which the job runs.
*/
sync_cursor?: UserDefinedValue
/**
* The host name of the current system that will run the job.
*/
worker_hostname: string
}
}
22 changes: 22 additions & 0 deletions specification/connector/sync_job_claim/SyncJobClaimResponse.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
/*
* Licensed to Elasticsearch B.V. under one or more contributor
* license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright
* ownership. Elasticsearch B.V. licenses this file to you under
* the Apache License, Version 2.0 (the "License"); you may
* not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/

export class Response {
body: {}
}

0 comments on commit 6c3b4fc

Please sign in to comment.