# 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 Compute Admin Client VM Extensions API
  version: 1.0.0
extends: openapi/microsoft-azure-vmextensions-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Compute.Admin/locations/{location}/artifactTypes/VMExtension/publishers/{publisher}/types/{type}/versions/{version}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a VM extension image on Azure Stack Hub
      effect: read
      questions:
      - Is a specific VM extension image version available on my Azure Stack Hub?
      - Where can I see one VM extension image by publisher, type and version?
      instructions:
      - text: Get the VM extension image from {publisher} of type {type}, version {version}, in location {location}.
        slots:
          location: path.location
          publisher: path.publisher
          type: path.type
          version: path.version
      - text: Show VM extension image {type} for this publisher and version.
        slots:
          type: path.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Compute.Admin/locations/{location}/artifactTypes/VMExtension/publishers/{publisher}/types/{type}/versions/{version}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a VM extension image to Azure Stack Hub
      effect: write
      questions:
      - How do I upload a new VM extension image for tenants on Azure Stack Hub?
      - Can I publish a specific version of a VM extension as an operator?
      instructions:
      - text: Create VM extension image of type {type} with extension payload {extension}.
        slots:
          type: path.type
          extension: body.extension
      - text: Add version {version} of {publisher} extension type {type} to the stamp at {location}.
        slots:
          location: path.location
          publisher: path.publisher
          type: path.type
          version: path.version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Compute.Admin/locations/{location}/artifactTypes/VMExtension/publishers/{publisher}/types/{type}/versions/{version}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a VM extension image from Azure Stack Hub
      effect: destructive
      questions:
      - Can I remove an outdated VM extension image version?
      - What happens to tenants when I delete a VM extension image?
      instructions:
      - text: Delete VM extension image of type {type}.
        slots:
          type: path.type
      - text: Remove {publisher} extension image {type} version {version} from Azure Stack Hub location {location}.
        slots:
          location: path.location
          publisher: path.publisher
          type: path.type
          version: path.version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Compute.Admin/locations/{location}/artifactTypes/VMExtension'].get
  update:
    x-apievangelist-phrasing:
      intent: List VM extension images on Azure Stack Hub
      effect: read
      questions:
      - Which VM extension images are available at my Azure Stack Hub location?
      - Can I see every extension image operators have added?
      instructions:
      - text: List all VM extension images for location {location}.
        slots:
          location: path.location
      - text: Show every VM extension image on the Azure Stack Hub stamp.
      method: generated
      generated: '2026-10-01'