# 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 Machine Extensions API
  version: 1.0.0
extends: openapi/microsoft-azure-machineextensions-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an extension on a VMware vSphere VM
      effect: read
      questions:
      - How do I check one extension installed on an Arc-enabled VMware vSphere VM?
      - What status does a VMware vSphere VM extension report?
      instructions:
      - text: Get extension {extensionName} on VMware vSphere VM {virtualMachineName}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
      - text: Show vSphere VM {virtualMachineName} extension {extensionName}.
        slots:
          virtualMachineName: path.virtualMachineName
          extensionName: path.extensionName
      - text: Fetch vSphere extension {extensionName} of {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Install or update an extension on a vSphere VM
      effect: write
      questions:
      - Can I install an extension on an Arc-enabled VMware vSphere virtual machine?
      - How do I reconfigure an existing extension on a vSphere VM?
      instructions:
      - text: Install extension {extensionName} on VMware vSphere VM {virtualMachineName} in {location}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          location: requestBody.location
      - text: Create or update vSphere VM {virtualMachineName} extension {extensionName} with settings {properties}.
        slots:
          virtualMachineName: path.virtualMachineName
          extensionName: path.extensionName
          properties: requestBody.properties
      - text: Deploy vSphere extension {extensionName} to {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an extension from a vSphere VM
      effect: destructive
      questions:
      - How do I uninstall an extension from a VMware vSphere VM?
      - Can I delete a vSphere machine extension I no longer need?
      instructions:
      - text: Delete extension {extensionName} from VMware vSphere VM {virtualMachineName}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
      - text: Uninstall {extensionName} on vSphere VM {virtualMachineName}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
      - text: Remove vSphere extension {extensionName} from {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an extension on a vSphere VM
      effect: write
      questions:
      - Can I patch the settings or tags of a VMware vSphere VM extension?
      - What is updatable on an existing vSphere machine extension?
      instructions:
      - text: Patch extension {extensionName} on VMware vSphere VM {virtualMachineName} with tags {tags}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          tags: requestBody.tags
      - text: Update vSphere VM {virtualMachineName} extension {extensionName} properties to {properties}.
        slots:
          virtualMachineName: path.virtualMachineName
          extensionName: path.extensionName
          properties: requestBody.properties
      - text: Modify vSphere extension {extensionName} on {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachines/{virtualMachineName}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List extensions on a VMware vSphere VM
      effect: read
      questions:
      - Which extensions are installed on my Arc-enabled VMware vSphere VM?
      - Can I expand instance view details when listing vSphere VM extensions?
      instructions:
      - text: List extensions on VMware vSphere VM {virtualMachineName}.
        slots:
          virtualMachineName: path.virtualMachineName
      - text: List vSphere VM {virtualMachineName} extensions with {expand} expanded.
        slots:
          virtualMachineName: path.virtualMachineName
          expand: query.$expand
      - text: List vSphere VM {virtualMachineName} extensions in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an extension on an SCVMM VM
      effect: read
      questions:
      - How do I check one extension on a System Center VMM virtual machine?
      - What does an SCVMM VM extension look like?
      instructions:
      - text: Get extension {extensionName} on SCVMM VM {virtualMachineName}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
      - text: Show System Center VMM VM {virtualMachineName} extension {extensionName}.
        slots:
          virtualMachineName: path.virtualMachineName
          extensionName: path.extensionName
      - text: Fetch SCVMM extension {extensionName} of {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Install or update an extension on an SCVMM VM
      effect: write
      questions:
      - Can I install an extension on an Arc-enabled SCVMM virtual machine?
      - How do I change settings of an extension on a System Center VMM VM?
      instructions:
      - text: Install extension {extensionName} on SCVMM VM {virtualMachineName}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
      - text: Create or update System Center VMM VM {virtualMachineName} extension {extensionName} with {properties}.
        slots:
          virtualMachineName: path.virtualMachineName
          extensionName: path.extensionName
          properties: requestBody.properties
      - text: Deploy SCVMM extension {extensionName} to {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an extension from an SCVMM VM
      effect: destructive
      questions:
      - How do I uninstall an extension from a System Center VMM VM?
      - Can I delete an SCVMM machine extension?
      instructions:
      - text: Delete extension {extensionName} from SCVMM VM {virtualMachineName}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
      - text: Uninstall {extensionName} on System Center VMM VM {virtualMachineName}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
      - text: Remove SCVMM extension {extensionName} from {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/extensions/{extensionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an extension on an SCVMM VM
      effect: write
      questions:
      - Can I patch tags on an SCVMM virtual machine extension?
      - What fields can I update on an existing System Center VMM extension?
      instructions:
      - text: Patch extension {extensionName} on SCVMM VM {virtualMachineName} with tags {tags}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          tags: requestBody.tags
      - text: Update System Center VMM VM {virtualMachineName} extension {extensionName} settings to {properties}.
        slots:
          virtualMachineName: path.virtualMachineName
          extensionName: path.extensionName
          properties: requestBody.properties
      - text: Modify SCVMM extension {extensionName} on {virtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          extensionName: path.extensionName
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachines/{virtualMachineName}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List extensions on an SCVMM VM
      effect: read
      questions:
      - Which extensions are installed on my System Center VMM virtual machine?
      - Can I list SCVMM VM extensions with expanded instance view?
      instructions:
      - text: List extensions on SCVMM VM {virtualMachineName}.
        slots:
          virtualMachineName: path.virtualMachineName
      - text: List System Center VMM VM {virtualMachineName} extensions with {expand} expanded.
        slots:
          virtualMachineName: path.virtualMachineName
          expand: query.$expand
      - text: List SCVMM VM {virtualMachineName} extensions in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          virtualMachineName: path.virtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'