# 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 Gallery Images API
  version: 1.0.0
extends: openapi/microsoft-azure-galleryimages-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: 11
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/galleryimages'].get
  update:
    x-apievangelist-phrasing:
      intent: List gallery images in a DevTest lab
      effect: read
      questions:
      - Which marketplace gallery images can I use to build VMs in my DevTest Labs lab?
      - Can I filter or sort the gallery images offered in a DevTest lab?
      instructions:
      - text: List gallery images in DevTest lab {lab} in resource group {resource_group}, subscription {subscription}.
        slots:
          lab: path.labName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the top {top} DevTest lab {lab} gallery images matching {filter}.
        slots:
          top: query.$top
          lab: path.labName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/galleryimages'].get
  update:
    x-apievangelist-phrasing:
      intent: List gallery images in a Lab Services lab account
      effect: read
      questions:
      - What gallery images are available in my Azure Lab Services lab account?
      - Can I order the lab account's gallery images by a property?
      instructions:
      - text: List gallery images in lab account {lab_account} in resource group {resource_group}, subscription {subscription}.
        slots:
          lab_account: path.labAccountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show Lab Services lab account {lab_account} images ordered by {orderby}.
        slots:
          lab_account: path.labAccountName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/galleryimages/{galleryImageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a gallery image in a lab account
      effect: read
      questions:
      - How do I look up one gallery image in my Lab Services lab account?
      - Is a particular lab account gallery image enabled for lab creators?
      instructions:
      - text: Get gallery image {image} from lab account {lab_account} in resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          lab_account: path.labAccountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show Lab Services image {image} details in lab account {lab_account}.
        slots:
          image: path.galleryImageName
          lab_account: path.labAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/galleryimages/{galleryImageName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a gallery image in a lab account
      effect: write
      questions:
      - How do I add or replace a gallery image in a Lab Services lab account?
      - Can I overwrite an existing lab account gallery image with new properties?
      instructions:
      - text: Create or replace gallery image {image} in lab account {lab_account}, resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          lab_account: path.labAccountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Put Lab Services image {image} into lab account {lab_account} with properties {properties}.
        slots:
          image: path.galleryImageName
          lab_account: path.labAccountName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/galleryimages/{galleryImageName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a gallery image from a lab account
      effect: destructive
      questions:
      - How do I remove a gallery image from my Lab Services lab account?
      - Can I delete a lab account image that lab creators no longer need?
      instructions:
      - text: Delete gallery image {image} from lab account {lab_account} in resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          lab_account: path.labAccountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove Lab Services image {image} from lab account {lab_account}.
        slots:
          image: path.galleryImageName
          lab_account: path.labAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/galleryimages/{galleryImageName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify a gallery image in a lab account
      effect: write
      questions:
      - How do I change properties of an existing gallery image in a lab account?
      - Can I update tags on a Lab Services gallery image without replacing it?
      instructions:
      - text: Patch gallery image {image} in lab account {lab_account}, resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          lab_account: path.labAccountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Set tags {tags} on Lab Services image {image} in lab account {lab_account}.
        slots:
          tags: requestBody.tags
          image: path.galleryImageName
          lab_account: path.labAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Compute gallery image definition
      effect: read
      questions:
      - How do I read an image definition from my Azure Compute Gallery?
      - What OS type and publisher info does a shared gallery image definition hold?
      instructions:
      - text: Get image definition {image} from compute gallery {gallery} in resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the {image} definition in shared image gallery {gallery}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Compute gallery image definition
      effect: write
      questions:
      - How do I create a new image definition in an Azure Compute Gallery?
      - Which region do I have to set when defining a gallery image?
      instructions:
      - text: Create image definition {image} in compute gallery {gallery}, resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Define image {image} in shared gallery {gallery} located in {location}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Compute gallery image definition
      effect: destructive
      questions:
      - How do I delete an image definition from my Compute Gallery?
      - Can I remove a shared gallery image definition I no longer publish?
      instructions:
      - text: Delete image definition {image} from compute gallery {gallery} in resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the {image} definition from shared image gallery {gallery}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Compute gallery image definition
      effect: write
      questions:
      - How do I change an existing image definition in my Compute Gallery?
      - Can I patch just the tags on a shared gallery image definition?
      instructions:
      - text: Update image definition {image} in compute gallery {gallery}, resource group {resource_group}, subscription {subscription}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Tag the {image} definition in shared gallery {gallery} with {tags}.
        slots:
          image: path.galleryImageName
          gallery: path.galleryName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images'].get
  update:
    x-apievangelist-phrasing:
      intent: List image definitions in a Compute gallery
      effect: read
      questions:
      - What image definitions does my Azure Compute Gallery contain?
      - Can I list every image definition in one shared gallery?
      instructions:
      - text: List image definitions in compute gallery {gallery} in resource group {resource_group}, subscription {subscription}.
        slots:
          gallery: path.galleryName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show all definitions published in shared image gallery {gallery}.
        slots:
          gallery: path.galleryName
      method: generated
      generated: '2026-09-26'