# 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 Load Balancers API
  version: 1.0.0
extends: openapi/microsoft-azure-load-balancers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/loadBalancers'].get
  update:
    x-apievangelist-phrasing:
      intent: List Kubernetes runtime load balancers
      effect: read
      questions:
      - Which Kubernetes runtime load balancers exist on my Arc-connected cluster?
      - Can I list the LoadBalancer resources under a given cluster resource?
      instructions:
      - text: List Kubernetes runtime load balancers under {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Show every KubernetesRuntime LoadBalancer on cluster resource {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/loadBalancers/{loadBalancerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Kubernetes runtime load balancer
      effect: read
      questions:
      - How do I see the address pools and settings of one Kubernetes runtime load balancer?
      - What does a single KubernetesRuntime LoadBalancer return?
      instructions:
      - text: Show Kubernetes runtime load balancer {loadBalancerName} under {resourceUri}.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceUri: path.resourceUri
      - text: Get KubernetesRuntime LoadBalancer {loadBalancerName} on cluster {resourceUri}.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/loadBalancers/{loadBalancerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Kubernetes runtime load balancer
      effect: write
      questions:
      - How do I add a load balancer to my Arc Kubernetes cluster through the KubernetesRuntime provider?
      - Can I replace an existing Kubernetes runtime load balancer's configuration?
      instructions:
      - text: Create Kubernetes runtime load balancer {loadBalancerName} under {resourceUri}.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceUri: path.resourceUri
      - text: Create or replace KubernetesRuntime LoadBalancer {loadBalancerName} on cluster {resourceUri} with these properties.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/loadBalancers/{loadBalancerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Kubernetes runtime load balancer
      effect: destructive
      questions:
      - Can I remove a load balancer from my Arc Kubernetes cluster?
      - What happens when I delete a KubernetesRuntime LoadBalancer?
      instructions:
      - text: Delete Kubernetes runtime load balancer {loadBalancerName} under {resourceUri}.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceUri: path.resourceUri
      - text: Remove KubernetesRuntime LoadBalancer {loadBalancerName} from cluster {resourceUri}.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure network load balancer
      effect: read
      questions:
      - How do I view the frontend IPs, backend pools and rules of one Azure load balancer?
      - What does a single network load balancer in a resource group return?
      instructions:
      - text: Show network load balancer {loadBalancerName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Get the configuration of Azure load balancer {loadBalancerName}.
        slots:
          loadBalancerName: path.loadBalancerName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a network load balancer
      effect: write
      questions:
      - How do I create an Azure load balancer in a resource group?
      - Is location required when I create or replace a network load balancer?
      instructions:
      - text: Create network load balancer {loadBalancerName} in {location} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          loadBalancerName: path.loadBalancerName
          location: requestBody.location
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Create or update Azure load balancer {loadBalancerName} in region {location} with tags {tags}.
        slots:
          loadBalancerName: path.loadBalancerName
          location: requestBody.location
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network load balancer
      effect: destructive
      questions:
      - Can I delete an Azure load balancer I no longer need?
      - Is deleting a network load balancer from a resource group reversible?
      instructions:
      - text: Delete network load balancer {loadBalancerName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          loadBalancerName: path.loadBalancerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove Azure load balancer {loadBalancerName}.
        slots:
          loadBalancerName: path.loadBalancerName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/loadBalancers'].get
  update:
    x-apievangelist-phrasing:
      intent: List all load balancers in a subscription
      effect: read
      questions:
      - Which load balancers exist anywhere in my Azure subscription?
      - Can I list load balancers across every resource group at once?
      instructions:
      - text: List all load balancers in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every network load balancer across my whole subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers'].get
  update:
    x-apievangelist-phrasing:
      intent: List load balancers in a resource group
      effect: read
      questions:
      - What load balancers are in a specific resource group?
      - How do I list network load balancers for just one resource group?
      instructions:
      - text: List load balancers in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the network load balancers in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'