# 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 Hosts API
  version: 1.0.0
extends: openapi/microsoft-azure-hosts-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/hosts/{hostName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Arc-enabled vSphere host
      effect: read
      questions:
      - How do I view a VMware ESXi host that is projected into Azure through Arc?
      - What is the status of one vSphere host resource in my resource group?
      instructions:
      - text: Get vSphere host {host} in resource group {rg}.
        slots:
          host: path.hostName
          rg: path.resourceGroupName
      - text: Show the Arc VMware host {host} in subscription {sub}, group {rg}.
        slots:
          host: path.hostName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/hosts/{hostName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Arc vSphere host
      effect: write
      questions:
      - How do I enable an ESXi host from my vCenter in Azure Arc?
      - Which location and extended location does a vSphere host resource need?
      instructions:
      - text: Create vSphere host {host} in resource group {rg} in location {location} with properties {properties}.
        slots:
          host: path.hostName
          rg: path.resourceGroupName
          location: requestBody.location
          properties: requestBody.properties
      - text: Onboard ESXi host {host} into subscription {sub}, group {rg} using custom location {ext} and region {location}.
        slots:
          host: path.hostName
          sub: path.subscriptionId
          rg: path.resourceGroupName
          ext: requestBody.extendedLocation
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/hosts/{hostName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Arc vSphere host
      effect: destructive
      questions:
      - How do I remove an ESXi host resource from Azure Arc?
      - Can I force-delete a vSphere host resource that will not go away?
      instructions:
      - text: Delete vSphere host {host} from resource group {rg}.
        slots:
          host: path.hostName
          rg: path.resourceGroupName
      - text: Force-remove Arc VMware host {host} in subscription {sub}, group {rg} with force {force}.
        slots:
          host: path.hostName
          sub: path.subscriptionId
          rg: path.resourceGroupName
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/hosts/{hostName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an Arc vSphere host
      effect: write
      questions:
      - How do I retag a vSphere host resource in Azure?
      - What properties can I patch on an Arc VMware host?
      instructions:
      - text: Set tags {tags} on vSphere host {host} in resource group {rg}.
        slots:
          tags: requestBody.tags
          host: path.hostName
          rg: path.resourceGroupName
      - text: Patch Arc VMware host {host} in subscription {sub}, group {rg}.
        slots:
          host: path.hostName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConnectedVMwarevSphere/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere hosts in a subscription
      effect: read
      questions:
      - Which VMware hosts are Arc-enabled across my entire subscription?
      - Can I inventory every vSphere host resource in one subscription?
      instructions:
      - text: List all vSphere hosts in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every Arc VMware host across subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere hosts in a resource group
      effect: read
      questions:
      - What vSphere hosts are in a specific resource group?
      - Can I limit the Arc VMware host list to one resource group?
      instructions:
      - text: List vSphere hosts in resource group {rg}.
        slots:
          rg: path.resourceGroupName
      - text: Show the Arc VMware hosts in subscription {sub}, resource group {rg}.
        slots:
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}/listHosts'].post
  update:
    x-apievangelist-phrasing:
      intent: List hosts reporting to a Datadog monitor
      effect: read
      questions:
      - Which hosts are being monitored by my Datadog monitor resource in Azure?
      - How can I see the host list behind a Datadog monitor?
      instructions:
      - text: List the hosts for Datadog monitor {monitor} in resource group {rg}.
        slots:
          monitor: path.monitorName
          rg: path.resourceGroupName
      - text: Show monitored hosts of Datadog resource {monitor} in subscription {sub}, group {rg}.
        slots:
          monitor: path.monitorName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'