# 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 Azure Arc VMware Management Service Virtual…
  version: 1.0.0
extends: openapi/microsoft-azure-virtualmachineinstances-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: 8
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vSphere virtual machine instance
      effect: read
      questions:
      - What is the configuration of my Arc-enabled VMware VM?
      - Can I read the VM instance attached to a machine resource?
      instructions:
      - text: Show the vSphere VM instance under {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Get power state and settings of the VMware VM at {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a vSphere VM instance
      effect: write
      questions:
      - How do I create a VMware vSphere VM through Azure Arc?
      - Which VM instance properties can only be set when the VM is first created?
      instructions:
      - text: Create a vSphere VM instance at {resourceUri} with {properties}.
        slots:
          resourceUri: path.resourceUri
          properties: requestBody.properties
      - text: Provision a VMware VM at {resourceUri} in extended location {extendedLocation}.
        slots:
          resourceUri: path.resourceUri
          extendedLocation: requestBody.extendedLocation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances/default'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a vSphere VM instance
      effect: destructive
      questions:
      - Can I delete a VMware VM from Azure and from the vCenter host too?
      - Is there a way to force-delete a vSphere VM instance?
      instructions:
      - text: Delete the vSphere VM instance at {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Force delete the VM at {resourceUri} and remove it from the host.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a vSphere VM instance
      effect: write
      questions:
      - How do I change the hardware settings of an existing VMware VM?
      - Can I patch a vSphere VM instance without recreating it?
      instructions:
      - text: Update the vSphere VM at {resourceUri} with {properties}.
        slots:
          resourceUri: path.resourceUri
          properties: requestBody.properties
      - text: Patch settings on the existing VMware VM at {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances'].get
  update:
    x-apievangelist-phrasing:
      intent: List vSphere VM instances under a resource
      effect: read
      questions:
      - Which VMware VM instances exist under a parent resource?
      - Can I enumerate every vSphere VM instance for a machine?
      instructions:
      - text: List the vSphere VM instances under {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Enumerate all VMware VM instances beneath {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances/default/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Power off a vSphere VM
      effect: write
      questions:
      - How do I stop a VMware VM, and can I skip the guest shutdown?
      - Can I hard power off a vSphere VM instance?
      instructions:
      - text: Stop the vSphere VM at {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Power off the VMware VM at {resourceUri} with skip shutdown set to {skipShutdown}.
        slots:
          resourceUri: path.resourceUri
          skipShutdown: requestBody.skipShutdown
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances/default/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a vSphere VM
      effect: write
      questions:
      - How do I power on a stopped VMware VM through Azure?
      - Can I start a vSphere VM instance remotely?
      instructions:
      - text: Start the vSphere VM at {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Power on the VMware VM instance under {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineInstances/default/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart a vSphere VM
      effect: write
      questions:
      - How do I reboot a VMware VM managed through Azure Arc?
      - Can I restart a vSphere VM instance without stopping and starting it myself?
      instructions:
      - text: Restart the vSphere VM at {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      - text: Reboot the VMware VM instance under {resourceUri}.
        slots:
          resourceUri: path.resourceUri
      method: generated
      generated: '2026-09-26'