# 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 ManagedLabsClient Lab Accounts API
  version: 1.0.0
extends: openapi/microsoft-azure-labaccounts-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.LabServices/labaccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List lab accounts in a subscription
      effect: read
      questions:
      - Which Lab Services lab accounts exist across my subscription?
      - Can I filter, sort or cap the list of lab accounts?
      instructions:
      - text: List lab accounts in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show the top {top} lab accounts matching {filter}.
        slots:
          top: query.$top
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List lab accounts in a resource group
      effect: read
      questions:
      - Which lab accounts are in one resource group?
      - What Lab Services accounts does a given resource group hold?
      instructions:
      - text: List lab accounts in resource group {rg} of subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show lab accounts in resource group {rg} ordered by {orderby}.
        slots:
          rg: path.resourceGroupName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a lab account
      effect: read
      questions:
      - What are the settings of a specific Lab Services lab account?
      - Can I expand nested properties when reading one lab account?
      instructions:
      - text: Get lab account {account} in resource group {rg} of subscription {sub}.
        slots:
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show lab account {account} with {expand} expanded.
        slots:
          account: path.labAccountName
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a lab account
      effect: write
      questions:
      - How do I create a new Lab Services lab account?
      - Can I replace an existing lab account's full definition?
      instructions:
      - text: Create lab account {account} in resource group {rg} of subscription {sub} in {location}.
        slots:
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Replace lab account {account} with properties {properties}.
        slots:
          account: path.labAccountName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a lab account
      effect: destructive
      questions:
      - How do I delete a Lab Services lab account?
      - Does removing a lab account take a while to finish?
      instructions:
      - text: Delete lab account {account} in resource group {rg} of subscription {sub}.
        slots:
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove lab account {account}.
        slots:
          account: path.labAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify a lab account
      effect: write
      questions:
      - Can I change some properties of a lab account without recreating it?
      - How do I update the tags on a Lab Services account?
      instructions:
      - text: Modify lab account {account} in resource group {rg} of subscription {sub} with properties {properties}.
        slots:
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Set tags {tags} on lab account {account}.
        slots:
          tags: requestBody.tags
          account: path.labAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/createLab'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a lab in a lab account
      effect: write
      questions:
      - How do I create a classroom lab inside a lab account?
      - What do I need to supply to add a new lab under a Lab Services account?
      instructions:
      - text: Add a new classroom lab named {lab} under lab account {account} (resource group {rg}, subscription {sub}).
        slots:
          lab: requestBody.name
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Add lab {lab} to lab account {account} with lab settings {settings}.
        slots:
          lab: requestBody.name
          account: path.labAccountName
          settings: requestBody.labCreationParameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/getRegionalAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Get VM size availability by region for a lab account
      effect: read
      questions:
      - Which regions offer each VM size category configured in my lab account?
      - Where can labs in my lab account be created for a given size?
      instructions:
      - text: Get regional availability for lab account {account} in resource group {rg} of subscription {sub}.
        slots:
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which regions support the size categories in lab account {account}.
        slots:
          account: path.labAccountName
      method: generated
      generated: '2026-09-26'