# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure KustoManagementClient Event Hub Connections…
  version: 1.0.0
extends: openapi/microsoft-azure-eventhubconnections-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/eventhubconnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List Event Hub connections of a Kusto database
      effect: read
      questions:
      - Which Event Hub connections feed data into my Kusto database?
      - Can I list all Event Hub ingestion connections on a Data Explorer database?
      instructions:
      - text: List Event Hub connections for database {databaseName} on Kusto cluster {clusterName} ({resourceGroupName}, {subscriptionId}).
        slots:
          databaseName: path.databaseName
          clusterName: path.clusterName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every Event Hub connection on Kusto database {databaseName} in cluster {clusterName}.
        slots:
          databaseName: path.databaseName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/eventhubConnectionValidation'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate Event Hub connection parameters
      effect: read
      questions:
      - Can I check that my Event Hub data connection settings are valid before creating it?
      - How do I test Event Hub connection parameters against a Kusto database?
      instructions:
      - text: Validate Event Hub connection {eventhubConnectionName} for database {databaseName} on cluster {clusterName} ({resourceGroupName}, {subscriptionId}).
        slots:
          eventhubConnectionName: requestBody.eventhubConnectionName
          databaseName: path.databaseName
          clusterName: path.clusterName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Check whether the Event Hub settings {properties} are valid for Kusto database {databaseName} in {clusterName}.
        slots:
          properties: requestBody.properties
          databaseName: path.databaseName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/eventhubconnections/{eventHubConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Kusto Event Hub connection
      effect: read
      questions:
      - What Event Hub and consumer group does a given Kusto data connection use?
      - Can I view one Event Hub connection on my Data Explorer database by name?
      instructions:
      - text: Get Event Hub connection {eventHubConnectionName} on database {databaseName}, cluster {clusterName} ({resourceGroupName}, {subscriptionId}).
        slots:
          eventHubConnectionName: path.eventHubConnectionName
          databaseName: path.databaseName
          clusterName: path.clusterName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show Kusto Event Hub connection {eventHubConnectionName} in database {databaseName}.
        slots:
          eventHubConnectionName: path.eventHubConnectionName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/eventhubconnections/{eventHubConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Kusto Event Hub connection
      effect: write
      questions:
      - How do I stream events from an Event Hub into my Kusto database?
      - Can I set up a new Event Hub ingestion connection on a Data Explorer database?
      instructions:
      - text: Create Event Hub connection {eventHubConnectionName} on database {databaseName}, cluster {clusterName} ({resourceGroupName}, {subscriptionId}).
        slots:
          eventHubConnectionName: path.eventHubConnectionName
          databaseName: path.databaseName
          clusterName: path.clusterName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Connect Kusto database {databaseName} to an Event Hub as {eventHubConnectionName} using settings {properties}.
        slots:
          databaseName: path.databaseName
          eventHubConnectionName: path.eventHubConnectionName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/eventhubconnections/{eventHubConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Kusto Event Hub connection
      effect: destructive
      questions:
      - How do I stop ingesting from an Event Hub into my Kusto database?
      - Can I delete one Event Hub data connection by name?
      instructions:
      - text: Delete Event Hub connection {eventHubConnectionName} from database {databaseName}, cluster {clusterName} ({resourceGroupName}, {subscriptionId}).
        slots:
          eventHubConnectionName: path.eventHubConnectionName
          databaseName: path.databaseName
          clusterName: path.clusterName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove Kusto Event Hub connection {eventHubConnectionName} from database {databaseName}.
        slots:
          eventHubConnectionName: path.eventHubConnectionName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/eventhubconnections/{eventHubConnectionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Kusto Event Hub connection
      effect: write
      questions:
      - Can I change the settings of an Event Hub connection that already exists on my Kusto database?
      - Is it possible to patch an Event Hub data connection without recreating it?
      instructions:
      - text: Update Event Hub connection {eventHubConnectionName} on database {databaseName}, cluster {clusterName} ({resourceGroupName}, {subscriptionId}).
        slots:
          eventHubConnectionName: path.eventHubConnectionName
          databaseName: path.databaseName
          clusterName: path.clusterName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Patch Kusto Event Hub connection {eventHubConnectionName} in database {databaseName} with new settings {properties}.
        slots:
          eventHubConnectionName: path.eventHubConnectionName
          databaseName: path.databaseName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'