› › ›

API обновления ошибки подключения

Данная функциональность находится в техническом превью и может быть изменена или удалена в будущих версиях. Elastic будет работать над устранением проблем, но функции в техническом превью не подпадают под SLA поддержки официальных функций GA.

Обновляет поле error подключения.

Чтобы начать работу с Connector API, ознакомьтесь с нашим руководством.

Запрос

PUT _connector/<connector_id>/_error

Предварительные условия

Для синхронизации данных с помощью собственных подключений, необходимо развернуть службу подключения Elastic на собственной инфраструктуре. Эта служба запускается автоматически на Elastic Cloud для управляемых Elastic подключений.
Параметр connector_id должен ссылаться на существующее подключение.

Описание

Устанавливает поле error для указанного подключения. Если значение error, предоставленное в теле запроса, не null, состояние подключения обновляется на error. В противном случае, если error сброшено на null, состояние подключения обновляется на connected.

Параметры пути

<connector_id>: (Обязательный, строка)

Тело запроса

error: (Обязательный, строка) Сообщение, связанное с последней ошибкой, возникшей в подключении.

Коды ответов

200: Поле подключения error было успешно обновлено.
400: Поле connector_id не было предоставлено или тело запроса имело неверный формат.
404 (Отсутствующие ресурсы): Не найдено подключение, соответствующее connector_id.

Примеры

В следующем примере обновляется поле error для подключения с идентификатором my-connector:

resp = client.connector.update_error(
    connector_id="my-connector",
    error="Houston, we have a problem!",
)
print(resp)

response = client.connector.update_error(
  connector_id: 'my-connector',
  body: {
    error: 'Houston, we have a problem!'
  }
)
puts response

const response = await client.connector.updateError({
  connector_id: "my-connector",
  error: "Houston, we have a problem!",
});
console.log(response);

PUT _connector/my-connector/_error
{
    "error": "Houston, we have a problem!"
}

{
    "result": "updated"
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/update-connector-error-api.html