# 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 Machine Templates API
  version: 1.0.0
extends: openapi/microsoft-azure-virtualmachinetemplates-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: 14
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineTemplates/{virtualMachineTemplateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Arc-enabled vSphere VM template
      effect: read
      questions:
      - How do I view a VMware vSphere VM template that's connected to Azure Arc?
      - What properties does a connected vSphere virtual machine template expose?
      instructions:
      - text: Show vSphere VM template {template} in resource group {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
      - text: Get details of the Arc vSphere template {template}.
        slots:
          template: path.virtualMachineTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineTemplates/{virtualMachineTemplateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Arc vSphere VM template
      effect: write
      questions:
      - How do I register a vCenter VM template as an Azure resource?
      - What location and properties are required to create a connected vSphere template?
      instructions:
      - text: Create vSphere VM template {template} in subscription {subscription}, group {resource_group}, at {location}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
          location: requestBody.location
      - text: Onboard vCenter template {template} with properties {properties}.
        slots:
          template: path.virtualMachineTemplateName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineTemplates/{virtualMachineTemplateName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Arc vSphere VM template
      effect: destructive
      questions:
      - Can I force-delete a connected vSphere VM template from Azure?
      - How do I remove a vSphere template resource from my resource group?
      instructions:
      - text: Delete vSphere VM template {template} in {resource_group} under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
      - text: Force delete the Arc vSphere template {template}.
        slots:
          template: path.virtualMachineTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineTemplates/{virtualMachineTemplateName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an Arc vSphere VM template
      effect: write
      questions:
      - Can I change the tags on a connected vSphere VM template?
      - Which properties of a vSphere template resource can be patched?
      instructions:
      - text: Set tags {tags} on vSphere VM template {template}.
        slots:
          tags: requestBody.tags
          template: path.virtualMachineTemplateName
      - text: Update the vSphere template {template} in {resource_group} of subscription {subscription} with new tags.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere VM templates in a subscription
      effect: read
      questions:
      - Which connected vSphere VM templates exist across my whole subscription?
      - How do I see every Arc vSphere template I've onboarded?
      instructions:
      - text: List all Arc vSphere VM templates in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every connected vCenter template across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualMachineTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere VM templates in a resource group
      effect: read
      questions:
      - What connected vSphere VM templates are in a given resource group?
      - How do I list vCenter templates scoped to one resource group?
      instructions:
      - text: List Arc vSphere VM templates in resource group {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
      - text: Show connected vCenter templates under {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an SCVMM VM template
      effect: read
      questions:
      - How do I look up a System Center VMM template that's onboarded to Azure?
      - What does an SCVMM virtual machine template resource contain?
      instructions:
      - text: Show SCVMM VM template {template} in resource group {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
      - text: Get the SCVMM template {template}.
        slots:
          template: path.virtualMachineTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Onboard an SCVMM VM template to Azure
      effect: write
      questions:
      - How do I bring an SCVMM VM template into Azure as a resource?
      - What extended location is needed to onboard a System Center VMM template?
      instructions:
      - text: Onboard SCVMM template {template} into subscription {subscription}, group {resource_group}, at {location}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
          location: requestBody.location
      - text: Register SCVMM template {template} using extended location {extended_location}.
        slots:
          template: path.virtualMachineTemplateName
          extended_location: requestBody.extendedLocation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Deregister an SCVMM VM template from Azure
      effect: destructive
      questions:
      - How do I deregister a System Center VMM template from Azure?
      - Can I force the removal of an SCVMM template resource?
      instructions:
      - text: Deregister SCVMM template {template} in {resource_group} under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
      - text: Force remove SCVMM template {template} from Azure.
        slots:
          template: path.virtualMachineTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates/{virtualMachineTemplateName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an SCVMM VM template
      effect: write
      questions:
      - Can I retag an SCVMM virtual machine template resource?
      - What can I patch on a System Center VMM template in Azure?
      instructions:
      - text: Set tags {tags} on SCVMM template {template}.
        slots:
          tags: requestBody.tags
          template: path.virtualMachineTemplateName
      - text: Update SCVMM template {template} in {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/virtualMachineTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCVMM VM templates in a resource group
      effect: read
      questions:
      - Which SCVMM VM templates are in a particular resource group?
      - How do I list System Center VMM templates for one resource group?
      instructions:
      - text: List SCVMM VM templates in resource group {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
      - text: Show SCVMM templates under {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ScVmm/virtualMachineTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCVMM VM templates in a subscription
      effect: read
      questions:
      - What SCVMM VM templates are onboarded across my subscription?
      - How can I see all System Center VMM templates in Azure?
      instructions:
      - text: List all SCVMM VM templates in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every onboarded SCVMM template subscription-wide.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds/{pcName}/virtualMachineTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List VM templates in a CloudSimple private cloud
      effect: read
      questions:
      - Which VM templates are available in my CloudSimple private cloud?
      - Do I need a resource pool to list private cloud VM templates?
      instructions:
      - text: List VM templates in private cloud {private_cloud} in {region} of subscription {subscription} for resource pool {resource_pool}.
        slots:
          subscription: path.subscriptionId
          private_cloud: path.pcName
          region: path.regionId
          resource_pool: query.resourcePoolName
      - text: Show available templates for private cloud {private_cloud} in {region}.
        slots:
          private_cloud: path.pcName
          region: path.regionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds/{pcName}/virtualMachineTemplates/{virtualMachineTemplateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a VM template in a CloudSimple private cloud
      effect: read
      questions:
      - How do I look up one VM template by name in my VMware private cloud?
      - What details come back for a single CloudSimple template?
      instructions:
      - text: Get template {template} in private cloud {private_cloud} in {region} under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          template: path.virtualMachineTemplateName
          private_cloud: path.pcName
          region: path.regionId
      - text: Show CloudSimple VM template {template} from private cloud {private_cloud} in region {region}.
        slots:
          template: path.virtualMachineTemplateName
          private_cloud: path.pcName
          region: path.regionId
      method: generated
      generated: '2026-09-26'