# 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 PUT API
  version: 1.0.0
extends: openapi/microsoft-azure-put-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a Databricks private endpoint
      effect: write
      questions:
      - How do I approve a pending private endpoint connection to my Databricks workspace?
      - Can I reject a private endpoint connection on a Databricks workspace?
      instructions:
      - text: Set the status of private endpoint connection {privateEndpointConnectionName} on Databricks workspace {workspaceName} to {properties}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      - text: Approve Databricks endpoint {privateEndpointConnectionName} on {workspaceName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an IoT hub
      effect: write
      questions:
      - How do I create a new IoT hub with a chosen SKU and region?
      - Can I update an IoT hub only if nobody else has changed it since I last read it?
      instructions:
      - text: Create IoT hub {resourceName} in resource group {resourceGroupName} in {location} on SKU {sku}.
        slots:
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
          sku: requestBody.sku
      - text: Update IoT hub {resourceName} in subscription {subscriptionId} only if its etag matches {If-Match}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
          If-Match: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/eventHubEndpoints/{eventHubEndpointName}/ConsumerGroups/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a consumer group to an IoT hub event endpoint
      effect: write
      questions:
      - How do I add a consumer group to my IoT hub's built-in Event Hub-compatible endpoint?
      - Can I give a separate reader its own consumer group on an IoT hub?
      instructions:
      - text: Add consumer group {name} to endpoint {eventHubEndpointName} on IoT hub {resourceName} in resource group {resourceGroupName}.
        slots:
          name: path.name
          eventHubEndpointName: path.eventHubEndpointName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
      - text: Create consumer group {name} with properties {properties} on IoT hub {resourceName}, subscription {subscriptionId}, endpoint {eventHubEndpointName}.
        slots:
          name: path.name
          properties: requestBody.properties
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
          eventHubEndpointName: path.eventHubEndpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/iotHubs/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject an IoT hub private endpoint
      effect: write
      questions:
      - How do I approve a private endpoint connection to my IoT hub?
      - Can I change the status of an IoT hub's private endpoint connection?
      instructions:
      - text: Set the status of private endpoint connection {privateEndpointConnectionName} on IoT hub {resourceName} to {properties}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          resourceName: path.resourceName
          properties: requestBody.properties
      - text: Approve IoT hub private endpoint {privateEndpointConnectionName} on hub {resourceName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'