コネクタ名と説明APIの更新

この機能はベータ版であり、変更される可能性があります。設計とコードは公式GA機能よりも成熟しておらず、保証なしでそのまま提供されています。ベータ機能は公式GA機能のサポートSLAの対象外です。

コネクタのnameおよびdescriptionフィールドを更新します。

コネクタAPIを始めるには、チュートリアルを確認してください。

リクエスト

PUT _connector/<connector_id>/_name

前提条件

  • 自己管理コネクタを使用してデータを同期するには、独自のインフラストラクチャにElasticコネクタサービスをデプロイする必要があります。このサービスは、ネイティブコネクタ用にElastic Cloud上で自動的に実行されます。
  • connector_idパラメータは、既存のコネクタを参照する必要があります。

パスパラメータ

  • <connector_id>
  • (必須、文字列)

リクエストボディ

  • name
  • (必須、文字列) コネクタの名前。
  • description
  • (オプション、文字列) コネクタの説明。

レスポンスコード

  • 200
  • コネクタnameおよびdescriptionフィールドが正常に更新されました。
  • 400
  • connector_idが提供されていないか、リクエストペイロードが不正です。
  • 404 (リソースが不足しています)
  • connector_idに一致するコネクタが見つかりませんでした。

次の例では、ID my-connectorのコネクタのnameおよびdescriptionフィールドを更新します:

Python

  1. resp = client.connector.update_name(
  2. connector_id="my-connector",
  3. name="Custom connector",
  4. description="This is my customized connector",
  5. )
  6. print(resp)

Ruby

  1. response = client.connector.update_name(
  2. connector_id: 'my-connector',
  3. body: {
  4. name: 'Custom connector',
  5. description: 'This is my customized connector'
  6. }
  7. )
  8. puts response

Js

  1. const response = await client.connector.updateName({
  2. connector_id: "my-connector",
  3. name: "Custom connector",
  4. description: "This is my customized connector",
  5. });
  6. console.log(response);

コンソール

  1. PUT _connector/my-connector/_name
  2. {
  3. "name": "Custom connector",
  4. "description": "This is my customized connector"
  5. }

コンソール-結果

  1. {
  2. "result": "updated"
  3. }