# 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 Microsoft.KubernetesRuntime Bgp Peers API
  version: 1.0.0
extends: openapi/microsoft-azure-bgppeers-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['/{resourceUri}/providers/Microsoft.KubernetesRuntime/bgpPeers'].get
  update:
    x-apievangelist-phrasing:
      intent: List BGP peers on a Kubernetes cluster
      effect: read
      questions:
      - Which BGP peers are configured for my Arc-enabled Kubernetes cluster's load balancer?
      - How do I list the BGP peer resources under a cluster?
      instructions:
      - text: List BGP peers under {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Show all BGP peer resources for cluster {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/bgpPeers/{bgpPeerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a BGP peer
      effect: read
      questions:
      - What ASN and peer address does a BGP peer on my cluster use?
      - How do I check one BGP peer's configuration?
      instructions:
      - text: Get BGP peer {bgpPeerName} under {resourceUri}.
        slots:
          bgpPeerName: path.bgpPeerName
          resourceUri: path.resourceUri
      - text: Show the settings of BGP peer {bgpPeerName}.
        slots:
          bgpPeerName: path.bgpPeerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/bgpPeers/{bgpPeerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a BGP peer
      effect: write
      questions:
      - How do I add a BGP peer so my cluster advertises load balancer IPs to a router?
      - Can I update an existing BGP peer's properties?
      instructions:
      - text: Create BGP peer {bgpPeerName} under {resourceUri} with {properties}.
        slots:
          bgpPeerName: path.bgpPeerName
          resourceUri: path.resourceUri
          properties: requestBody.properties
      - text: Add a BGP peer named {bgpPeerName} to cluster {resourceUri}.
        slots:
          bgpPeerName: path.bgpPeerName
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/bgpPeers/{bgpPeerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a BGP peer
      effect: destructive
      questions:
      - How do I remove a BGP peer from my cluster?
      - Can I stop peering with a router by deleting the BGP peer resource?
      instructions:
      - text: Delete BGP peer {bgpPeerName} under {resourceUri}.
        slots:
          bgpPeerName: path.bgpPeerName
          resourceUri: path.resourceUri
      - text: Remove the BGP peer {bgpPeerName}.
        slots:
          bgpPeerName: path.bgpPeerName
      method: generated
      generated: '2026-09-26'