# 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 Virtual Machines API
  version: 1.0.0
extends: openapi/microsoft-azure-virtual-machines-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: 53
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/assessPatches'].post
  update:
    x-apievangelist-phrasing:
      intent: Assess missing patches on a vSphere VM
      effect: write
      questions:
      - Can Azure check which patches a VMware vSphere machine connected through Arc is missing?
      - How do I run a patch assessment on an Arc-enabled vSphere virtual machine?
      instructions:
      - text: Assess pending patches on vSphere machine {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Run a patch assessment scan on Arc-connected vSphere VM {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/installPatches'].post
  update:
    x-apievangelist-phrasing:
      intent: Install patches on a vSphere VM
      effect: write
      questions:
      - What's the way to install OS updates on an Arc-enabled VMware vSphere machine?
      - Can I cap how long a patch install runs and control whether the vSphere VM reboots?
      instructions:
      - text: Install patches on vSphere machine {vm} in resource group {rg} of subscription {sub}, allowing at most {duration}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          duration: requestBody.maximumDuration
      - text: Patch Arc-connected vSphere VM {vm} with reboot setting {reboot}.
        slots:
          vm: path.virtualMachineName
          reboot: requestBody.rebootSetting
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Arc-enabled vSphere VM
      effect: read
      questions:
      - What are the details of a VMware vSphere virtual machine registered with Azure Arc?
      - Where can I see the configuration of one Arc-connected vSphere VM?
      instructions:
      - text: Show vSphere virtual machine {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch the Arc vSphere VM resource named {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Arc-enabled vSphere VM
      effect: write
      questions:
      - Can I create a VMware vSphere virtual machine resource through Azure Arc?
      - Can I redefine an existing Arc vSphere VM by sending its full definition again?
      instructions:
      - text: Create vSphere virtual machine {vm} in resource group {rg} of subscription {sub} in location {location}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Replace the definition of Arc vSphere VM {vm} with properties {properties}.
        slots:
          vm: path.virtualMachineName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Arc-enabled vSphere VM
      effect: destructive
      questions:
      - How do I remove a VMware vSphere virtual machine from Azure Arc?
      - Can deleting an Arc vSphere VM also delete it from the vCenter host?
      instructions:
      - text: Delete vSphere virtual machine {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Force delete Arc vSphere VM {vm} and remove it from the host too, deleteFromHost {from_host}.
        slots:
          vm: path.virtualMachineName
          from_host: query.deleteFromHost
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Arc-enabled vSphere VM
      effect: write
      questions:
      - Can I change just the tags or identity on an Arc-connected vSphere VM without redefining it?
      - How do I patch a few properties of a VMware vSphere machine in Azure?
      instructions:
      - text: Update tags on vSphere virtual machine {vm} in resource group {rg} of subscription {sub} to {tags}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          tags: requestBody.tags
      - text: Patch the identity of Arc vSphere VM {vm} to {identity}.
        slots:
          vm: path.virtualMachineName
          identity: requestBody.identity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an Arc-enabled vSphere VM
      effect: write
      questions:
      - Is there a way to power down a VMware vSphere VM managed through Azure Arc?
      - Can I skip the guest shutdown and hard stop a vSphere machine?
      instructions:
      - text: Stop vSphere VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Hard stop Arc vSphere machine {vm} with skipShutdown {skip}.
        slots:
          vm: path.virtualMachineName
          skip: requestBody.skipShutdown
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an Arc-enabled vSphere VM
      effect: write
      questions:
      - What call powers on a stopped VMware vSphere VM from the Azure side?
      - Can Azure Arc boot a vSphere machine that is currently off?
      instructions:
      - text: Start vSphere VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Power on Arc vSphere machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart an Arc-enabled vSphere VM
      effect: write
      questions:
      - How do I reboot a VMware vSphere VM connected through Azure Arc?
      - Is there a single call to restart an Arc vSphere machine?
      instructions:
      - text: Restart vSphere VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reboot Arc vSphere machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere VMs in a subscription
      effect: read
      questions:
      - Which VMware vSphere machines are registered with Azure Arc across my whole subscription?
      - Can I see every Arc vSphere VM without picking a resource group?
      instructions:
      - text: List all Arc-enabled vSphere VMs in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every vSphere virtual machine connected through Arc in my subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere VMs in a resource group
      effect: read
      questions:
      - Which Arc-enabled vSphere VMs live in a particular resource group?
      - What VMware vSphere machines has my team registered in one Azure resource group?
      instructions:
      - text: List Arc vSphere VMs in resource group {rg} of subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the vSphere virtual machines inside resource group {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List virtual machines in a DevTest lab
      effect: read
      questions:
      - Which virtual machines exist in my DevTest Labs lab?
      - Can I filter and sort the lab VMs, or return only the top few?
      - How do I expand extra properties when listing DevTest lab machines?
      instructions:
      - text: List VMs in DevTest lab {lab} in resource group {rg} of subscription {sub}.
        slots:
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the first {top} virtual machines in lab {lab} matching {filter}.
        slots:
          top: query.$top
          lab: path.labName
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DevTest lab virtual machine
      effect: read
      questions:
      - What are the settings of one virtual machine in my DevTest lab?
      - Can I expand nested details when fetching a single lab VM?
      instructions:
      - text: Get DevTest lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show lab machine {name} from lab {lab} with {expand} expanded.
        slots:
          name: path.name
          lab: path.labName
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a DevTest lab virtual machine
      effect: write
      questions:
      - How do I create a new virtual machine inside a DevTest Labs lab?
      - Can I replace an existing lab VM's definition, and does it take a while?
      instructions:
      - text: Create DevTest lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Replace lab machine {name} in lab {lab} using properties {properties}.
        slots:
          name: path.name
          lab: path.labName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DevTest lab virtual machine
      effect: destructive
      questions:
      - Can I remove a virtual machine from my DevTest lab?
      - Does deleting a lab VM in DevTest Labs run as a long operation?
      instructions:
      - text: Delete DevTest lab VM {name} from lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove machine {name} from lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a DevTest lab VM
      effect: write
      questions:
      - Can I change the tags on a DevTest lab virtual machine?
      - Which properties of a lab VM can I modify after it is created?
      instructions:
      - text: Set tags {tags} on DevTest lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          tags: requestBody.tags
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Retag lab machine {name} in lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/addDataDisk'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a data disk to a lab VM
      effect: write
      questions:
      - Can I add a data disk to a DevTest lab virtual machine?
      - Can I attach an existing lab disk instead of creating a new one?
      instructions:
      - text: Attach a new data disk to lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Attach existing lab disk {disk_id} to machine {name} in lab {lab}.
        slots:
          disk_id: requestBody.existingLabDiskId
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/applyArtifacts'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply artifacts to a lab VM
      effect: write
      questions:
      - Is it possible to install DevTest Labs artifacts on an existing lab machine?
      - Can I push software artifacts to a lab VM after it is running?
      instructions:
      - text: Apply artifacts {artifacts} to lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          artifacts: requestBody.artifacts
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Run the lab artifacts on machine {name} in lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/claim'].post
  update:
    x-apievangelist-phrasing:
      intent: Claim ownership of a lab VM
      effect: write
      questions:
      - Which call takes ownership of a claimable virtual machine in a DevTest lab?
      - Can I claim a lab VM from the shared pool for myself?
      instructions:
      - text: Claim lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Take ownership of machine {name} in DevTest lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/detachDataDisk'].post
  update:
    x-apievangelist-phrasing:
      intent: Detach a data disk from a lab VM
      effect: write
      questions:
      - How do I detach a data disk from a DevTest lab machine?
      - Can I unplug one lab disk from a VM without deleting the disk?
      instructions:
      - text: Detach lab disk {disk_id} from lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          disk_id: requestBody.existingLabDiskId
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Unplug the data disk {disk_id} from machine {name}.
        slots:
          disk_id: requestBody.existingLabDiskId
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/getRdpFileContents'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the RDP file for a lab VM
      effect: read
      questions:
      - Can I get a Remote Desktop file to connect to my DevTest lab machine?
      - Where can I download RDP connection details for a lab VM?
      instructions:
      - text: Get the RDP file contents for lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me the Remote Desktop connection file for machine {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/listApplicableSchedules'].post
  update:
    x-apievangelist-phrasing:
      intent: List start/stop schedules for a lab VM
      effect: read
      questions:
      - Which auto start or auto shutdown schedules apply to my DevTest lab VM?
      - Is a lab machine covered by any start/stop schedule?
      instructions:
      - text: List the applicable schedules for lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which shutdown schedules affect machine {name} in lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/redeploy'].post
  update:
    x-apievangelist-phrasing:
      intent: Redeploy a lab VM to a new compute node
      effect: write
      questions:
      - A student can't connect to their lab VM - can I move it to another host?
      - What does redeploying a lab virtual machine do for connectivity problems?
      instructions:
      - text: Redeploy virtual machine {name} in lab {labName}.
        slots:
          name: path.name
          labName: path.labName
      - text: Move lab VM {name} to a different compute node.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/resize'].post
  update:
    x-apievangelist-phrasing:
      intent: Resize a lab VM
      effect: write
      questions:
      - What changes the size of a virtual machine in my DevTest lab?
      - Can I scale a lab VM up to a bigger size?
      instructions:
      - text: Resize lab VM {name} in lab {lab}, resource group {rg}, subscription {sub} to size {size}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          size: requestBody.size
      - text: Change machine {name} in lab {lab} to the {size} size.
        slots:
          name: path.name
          lab: path.labName
          size: requestBody.size
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart a lab VM
      effect: write
      questions:
      - How do I reboot a virtual machine in a DevTest lab?
      - Is restarting a DevTest lab machine a long-running operation?
      instructions:
      - text: Restart lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reboot DevTest machine {name} in lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a lab VM
      effect: write
      questions:
      - How do I start a stopped virtual machine in my DevTest lab?
      - Can I turn a DevTest lab machine back on from the API?
      instructions:
      - text: Start lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn on DevTest machine {name} in lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a lab VM
      effect: write
      questions:
      - Can I shut down a DevTest lab virtual machine to save cost?
      - Can I stop a lab VM I am not using right now?
      instructions:
      - text: Stop lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Shut down DevTest machine {name} in lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/transferDisks'].post
  update:
    x-apievangelist-phrasing:
      intent: Transfer a lab VM's data disks to me
      effect: write
      questions:
      - How do I take ownership of all the data disks attached to a DevTest lab VM?
      - Can the disks on a lab machine be transferred to the current user?
      instructions:
      - text: Transfer the data disks of lab VM {name} in lab {lab}, resource group {rg}, subscription {sub} to me.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Make me the owner of every disk attached to machine {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/virtualmachines/{name}/unClaim'].post
  update:
    x-apievangelist-phrasing:
      intent: Release ownership of a lab VM
      effect: write
      questions:
      - How do I give back a DevTest lab VM I claimed so others can use it?
      - Can I unclaim a lab machine and return it to the pool?
      instructions:
      - text: Unclaim lab VM {name} in lab {lab}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          lab: path.labName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Release my ownership of machine {name} in DevTest lab {lab}.
        slots:
          name: path.name
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusters/{clusterName}/listHosts'].post
  update:
    x-apievangelist-phrasing:
      intent: List the hosts of an HDInsight cluster
      effect: read
      questions:
      - Which hosts make up my HDInsight cluster?
      - How do I see the nodes behind an HDInsight cluster?
      instructions:
      - text: List the hosts in HDInsight cluster {cluster} in resource group {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show cluster {cluster}'s HDInsight host machines.
        slots:
          cluster: path.clusterName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusters/{clusterName}/restartHosts'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart hosts in an HDInsight cluster
      effect: write
      questions:
      - How do I restart specific hosts in an HDInsight cluster?
      - Can I reboot unhealthy HDInsight nodes without recreating the cluster?
      instructions:
      - text: Restart the specified hosts in HDInsight cluster {cluster} in resource group {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reboot the HDInsight nodes of cluster {cluster}.
        slots:
          cluster: path.clusterName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusters/{clusterName}/restartHosts/azureasyncoperations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an HDInsight host restart status
      effect: read
      questions:
      - Has my HDInsight host restart finished yet?
      - How do I poll the async status of restarting cluster hosts?
      instructions:
      - text: Check restart operation {operation} on HDInsight cluster {cluster} in resource group {rg} of subscription {sub}.
        slots:
          operation: path.operationId
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get the status of host restart {operation} for cluster {cluster}.
        slots:
          operation: path.operationId
          cluster: path.clusterName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommand'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a command or script on an Azure VM
      effect: write
      questions:
      - How do I run a shell or PowerShell script on an Azure compute VM without logging in?
      - Can I pass parameters to a run command script on a virtual machine?
      instructions:
      - text: Run command {command} on Azure VM {vm_name} in resource group {rg}.
        slots:
          command: requestBody.commandId
          vm_name: path.vmName
          rg: path.resourceGroupName
      - text: Execute script {script} on compute VM {vm_name} using command id {command}.
        slots:
          script: requestBody.script
          vm_name: path.vmName
          command: requestBody.commandId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an SCVMM virtual machine
      effect: read
      questions:
      - What are the details of a System Center VMM virtual machine exposed in Azure?
      - Where do I look up one SCVMM VM's configuration?
      instructions:
      - text: Show SCVMM virtual machine {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch System Center VMM machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an SCVMM virtual machine
      effect: write
      questions:
      - Can I deploy a virtual machine onto SCVMM fabric from Azure?
      - Which extended location and properties does an SCVMM VM need when I create it?
      instructions:
      - text: Create SCVMM virtual machine {vm} in resource group {rg} of subscription {sub} in location {location}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Deploy System Center VMM machine {vm} to extended location {ext}.
        slots:
          vm: path.virtualMachineName
          ext: requestBody.extendedLocation
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an SCVMM virtual machine
      effect: destructive
      questions:
      - How do I delete a virtual machine deployed on SCVMM fabric?
      - Can I retain the SCVMM machine and only remove its Azure resource?
      instructions:
      - text: Delete SCVMM virtual machine {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove System Center VMM machine {vm} from Azure but retain it, retain {retain}.
        slots:
          vm: path.virtualMachineName
          retain: query.retain
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an SCVMM virtual machine
      effect: write
      questions:
      - Can I patch the tags or properties of an SCVMM virtual machine in Azure?
      - How do I change a System Center VMM VM without a full redeploy?
      instructions:
      - text: Update tags on SCVMM virtual machine {vm} in resource group {rg} of subscription {sub} to {tags}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          tags: requestBody.tags
      - text: Patch System Center VMM machine {vm} with properties {properties}.
        slots:
          vm: path.virtualMachineName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an SCVMM virtual machine
      effect: write
      questions:
      - How do I power off a System Center VMM virtual machine from Azure?
      - Can I stop an SCVMM VM without a graceful guest shutdown?
      instructions:
      - text: Stop SCVMM VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Power off System Center VMM machine {vm}, skipShutdown {skip}.
        slots:
          vm: path.virtualMachineName
          skip: requestBody.skipShutdown
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an SCVMM virtual machine
      effect: write
      questions:
      - How do I power on a System Center VMM machine through Azure?
      - Can Azure start an SCVMM VM that is shut down?
      instructions:
      - text: Start SCVMM VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Boot System Center VMM machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart an SCVMM virtual machine
      effect: write
      questions:
      - How do I reboot a System Center VMM virtual machine from Azure?
      - Is there an API to restart an SCVMM-hosted VM?
      instructions:
      - text: Restart SCVMM VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reboot System Center VMM machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/createCheckpoint'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a checkpoint on an SCVMM VM
      effect: write
      questions:
      - How do I take a checkpoint of an SCVMM virtual machine before a risky change?
      - Can I name and describe an SCVMM VM checkpoint?
      instructions:
      - text: Create checkpoint {checkpoint} on SCVMM VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          checkpoint: requestBody.name
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Snapshot System Center VMM machine {vm} with description {description}.
        slots:
          vm: path.virtualMachineName
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/deleteCheckpoint'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a checkpoint on an SCVMM VM
      effect: destructive
      questions:
      - How do I remove an old checkpoint from an SCVMM virtual machine?
      - Can I clean up SCVMM VM checkpoints I no longer need?
      instructions:
      - text: Delete checkpoint {checkpoint} from SCVMM VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          checkpoint: requestBody.id
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Drop checkpoint {checkpoint} on System Center VMM machine {vm}.
        slots:
          checkpoint: requestBody.id
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/restoreCheckpoint'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore an SCVMM VM to a checkpoint
      effect: write
      questions:
      - How do I roll an SCVMM virtual machine back to an earlier checkpoint?
      - Can I revert a System Center VMM VM after a bad update?
      instructions:
      - text: Restore SCVMM VM {vm} in resource group {rg} of subscription {sub} to checkpoint {checkpoint}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          checkpoint: requestBody.id
      - text: Revert System Center VMM machine {vm} to checkpoint {checkpoint}.
        slots:
          vm: path.virtualMachineName
          checkpoint: requestBody.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCVMM VMs in a resource group
      effect: read
      questions:
      - Which System Center VMM virtual machines are in one resource group?
      - What SCVMM VMs has my team placed in a given Azure resource group?
      instructions:
      - text: List SCVMM VMs in resource group {rg} of subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the System Center VMM machines inside resource group {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ScVmm/virtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCVMM VMs in a subscription
      effect: read
      questions:
      - Which SCVMM virtual machines exist anywhere in my subscription?
      - Can I list all System Center VMM VMs across resource groups?
      instructions:
      - text: List all SCVMM VMs in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every System Center VMM machine in my subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/virtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List CloudSimple VMs in a subscription
      effect: read
      questions:
      - Which VMware Solution by CloudSimple virtual machines are in my subscription?
      - Can I filter or page through CloudSimple VMs across the subscription?
      instructions:
      - text: List CloudSimple virtual machines in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show the first {top} CloudSimple VMs in my subscription matching {filter}.
        slots:
          top: query.$top
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VMwareCloudSimple/virtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List CloudSimple VMs in a resource group
      effect: read
      questions:
      - Which CloudSimple virtual machines are in a particular resource group?
      - How do I page through CloudSimple VMs in one resource group with a skip token?
      instructions:
      - text: List CloudSimple VMs in resource group {rg} of subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show CloudSimple machines in resource group {rg} matching {filter}.
        slots:
          rg: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VMwareCloudSimple/virtualMachines/{virtualMachineName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a CloudSimple virtual machine
      effect: read
      questions:
      - What are the details of one CloudSimple virtual machine?
      - Where can I check the configuration of a VMware VM running on CloudSimple?
      instructions:
      - text: Get CloudSimple VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch the CloudSimple machine named {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VMwareCloudSimple/virtualMachines/{virtualMachineName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a CloudSimple VM
      effect: write
      questions:
      - How do I create a virtual machine in my CloudSimple private cloud?
      - Which location and properties does a new CloudSimple VM need?
      instructions:
      - text: Create CloudSimple VM {vm} in resource group {rg} of subscription {sub} in location {location}, referer {referer}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
          referer: header.Referer
      - text: Update CloudSimple machine {vm} with properties {properties}.
        slots:
          vm: path.virtualMachineName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VMwareCloudSimple/virtualMachines/{virtualMachineName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a CloudSimple virtual machine
      effect: destructive
      questions:
      - How do I delete a virtual machine from my CloudSimple private cloud?
      - Can I tear down a CloudSimple VM I no longer need?
      instructions:
      - text: Delete CloudSimple VM {vm} in resource group {rg} of subscription {sub}, referer {referer}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          referer: header.Referer
      - text: Tear down CloudSimple machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VMwareCloudSimple/virtualMachines/{virtualMachineName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a CloudSimple VM
      effect: write
      questions:
      - Can I change the tags on a CloudSimple virtual machine?
      - How do I patch a CloudSimple VM's properties?
      instructions:
      - text: Set tags {tags} on CloudSimple VM {vm} in resource group {rg} of subscription {sub}.
        slots:
          tags: requestBody.tags
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Retag CloudSimple machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VMwareCloudSimple/virtualMachines/{virtualMachineName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Power on a CloudSimple VM
      effect: write
      questions:
      - What powers on a CloudSimple virtual machine?
      - Can I start a CloudSimple VM that is powered off?
      instructions:
      - text: Power on CloudSimple VM {vm} in resource group {rg} of subscription {sub}, referer {referer}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          referer: header.Referer
      - text: Start CloudSimple machine {vm}.
        slots:
          vm: path.virtualMachineName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VMwareCloudSimple/virtualMachines/{virtualMachineName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Power off, shut down or suspend a CloudSimple VM
      effect: write
      questions:
      - How do I power off a CloudSimple virtual machine?
      - Can I choose between shutdown, power off and suspend for a CloudSimple VM?
      instructions:
      - text: Power off CloudSimple VM {vm} in resource group {rg} of subscription {sub}, referer {referer}.
        slots:
          vm: path.virtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          referer: header.Referer
      - text: Suspend CloudSimple machine {vm} using mode {mode}.
        slots:
          vm: path.virtualMachineName
          mode: query.mode
      method: generated
      generated: '2026-10-01'