# 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 Image Template API
  version: 1.0.0
extends: openapi/microsoft-azure-virtualmachineimagetemplate-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VirtualMachineImages/imageTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List VM image templates in a subscription
      effect: read
      questions:
      - Which Image Builder templates exist across my Azure subscription?
      - Can I see every VM image template I own without picking a resource group?
      instructions:
      - text: List all VM image templates in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Image Builder template across my subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List VM image templates in a resource group
      effect: read
      questions:
      - What image templates are defined in one resource group?
      - Can I restrict the Image Builder template list to a single resource group?
      instructions:
      - text: List VM image templates in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show Image Builder templates in group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a VM image template
      effect: read
      questions:
      - What source, customizations and distribution does my image template define?
      - Can I check the last build status of a particular image template?
      instructions:
      - text: Get image template {imageTemplateName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          imageTemplateName: path.imageTemplateName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the configuration of Image Builder template {imageTemplateName}.
        slots:
          imageTemplateName: path.imageTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a VM image template
      effect: write
      questions:
      - How do I define a new Image Builder template for building custom VM images?
      - Does an image template need a location when I create it?
      instructions:
      - text: Create image template {imageTemplateName} in {location}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          imageTemplateName: path.imageTemplateName
          location: requestBody.location
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Create or replace template {imageTemplateName} with properties {properties} in {location}.
        slots:
          imageTemplateName: path.imageTemplateName
          properties: requestBody.properties
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a VM image template
      effect: destructive
      questions:
      - How can I remove an Image Builder template I no longer build from?
      - Is deleting an image template permanent?
      instructions:
      - text: Delete image template {imageTemplateName} from resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          imageTemplateName: path.imageTemplateName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove Image Builder template {imageTemplateName}.
        slots:
          imageTemplateName: path.imageTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a VM image template
      effect: write
      questions:
      - Can I retag an image template without redefining it?
      - Which fields of an Image Builder template can be patched, just the tags?
      instructions:
      - text: Set tags {tags} on image template {imageTemplateName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          imageTemplateName: path.imageTemplateName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Update the tags of Image Builder template {imageTemplateName}.
        slots:
          imageTemplateName: path.imageTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an image build from a template
      effect: write
      questions:
      - How do I kick off an image build from an existing Image Builder template?
      - Can I produce new image artifacts from a template on demand?
      instructions:
      - text: Run a build of image template {imageTemplateName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          imageTemplateName: path.imageTemplateName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Start building artifacts from Image Builder template {imageTemplateName}.
        slots:
          imageTemplateName: path.imageTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/runOutputs'].get
  update:
    x-apievangelist-phrasing:
      intent: List run outputs of an image template
      effect: read
      questions:
      - What artifacts did my image template builds produce?
      - Can I see all run outputs recorded for one Image Builder template?
      instructions:
      - text: List run outputs of image template {imageTemplateName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          imageTemplateName: path.imageTemplateName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every build output of Image Builder template {imageTemplateName}.
        slots:
          imageTemplateName: path.imageTemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/runOutputs/{runOutputName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one run output of an image template
      effect: read
      questions:
      - Where is the managed image or gallery version produced by a particular run output?
      - Can I fetch a single named run output from an image template?
      instructions:
      - text: Get run output {runOutputName} of image template {imageTemplateName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          runOutputName: path.runOutputName
          imageTemplateName: path.imageTemplateName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the artifact from run output {runOutputName} of template {imageTemplateName}.
        slots:
          runOutputName: path.runOutputName
          imageTemplateName: path.imageTemplateName
      method: generated
      generated: '2026-09-26'