# 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 Disks API
  version: 1.0.0
extends: openapi/microsoft-azure-disks-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Compute.Admin/locations/{location}/disks'].get
  update:
    x-apievangelist-phrasing:
      intent: List disks in an Azure Stack Hub location (admin)
      effect: read
      questions:
      - As an Azure Stack Hub operator, how do I list the disks in a location?
      - Which managed disks exist on my Azure Stack Hub region from the admin API?
      instructions:
      - text: List all disks in Azure Stack Hub admin location {location}.
        slots:
          location: path.location
      - text: Show disks known to the Compute admin provider.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Compute.Admin/locations/{location}/disks/{DiskId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a disk in an Azure Stack Hub location (admin)
      effect: read
      questions:
      - Can an Azure Stack Hub operator read one disk's details from the admin API?
      - What does the Compute admin endpoint return for a single disk?
      instructions:
      - text: Get disk {DiskId} from the Azure Stack Hub Compute admin API in {location}.
        slots:
          DiskId: path.DiskId
          location: path.location
      - text: Show admin-level details for Azure Stack Hub disk {DiskId}.
        slots:
          DiskId: path.DiskId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/disks'].get
  update:
    x-apievangelist-phrasing:
      intent: List a DevTest Labs user's disks
      effect: read
      questions:
      - Which disks belong to my user profile in a DevTest Lab?
      - Can I filter or sort the lab disks in my profile?
      instructions:
      - text: List disks for user {userName} in lab {labName} (resource group {resourceGroupName}, subscription {subscriptionId}).
        slots:
          userName: path.userName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show lab disks for user {userName} in {labName} filtered by {filter}.
        slots:
          userName: path.userName
          labName: path.labName
          filter: query.$filter
      - text: List the first {top} disks of user {userName} in lab {labName}.
        slots:
          top: query.$top
          userName: path.userName
          labName: path.labName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/disks/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DevTest Labs disk
      effect: read
      questions:
      - How can I see the details of one disk in my DevTest Lab?
      - What size and type is a given lab disk?
      instructions:
      - text: Get disk {name} for user {userName} in lab {labName} (resource group {resourceGroupName}, subscription {subscriptionId}).
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show lab disk {name} owned by {userName} in {labName}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/disks/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a DevTest Labs disk
      effect: write
      questions:
      - How do I create a data disk in my DevTest Lab profile?
      - Can I replace an existing lab disk definition, and does it take a while?
      instructions:
      - text: Create disk {name} for user {userName} in lab {labName} (resource group {resourceGroupName}, subscription {subscriptionId}).
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Create lab disk {name} for {userName} in {labName} with properties {properties}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/disks/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DevTest Labs disk
      effect: destructive
      questions:
      - Can I delete a disk from my DevTest Lab profile?
      - What removes a lab disk I no longer need?
      instructions:
      - text: Delete disk {name} for user {userName} in lab {labName} (resource group {resourceGroupName}, subscription {subscriptionId}).
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove lab disk {name} owned by {userName} in {labName}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/disks/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a DevTest Labs disk
      effect: write
      questions:
      - How do I change the tags on a lab disk?
      - Which disk properties can I modify after creation in DevTest Labs?
      instructions:
      - text: Set tags {tags} on disk {name} for user {userName} in lab {labName} (resource group {resourceGroupName}, subscription {subscriptionId}).
        slots:
          tags: requestBody.tags
          name: path.name
          userName: path.userName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Retag lab disk {name} of user {userName} in {labName}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/disks/{name}/attach'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a DevTest Labs disk to a lab VM
      effect: write
      questions:
      - How do I attach a lab disk to one of my lab virtual machines?
      - Does attaching a DevTest Labs disk create a lease on the VM?
      instructions:
      - text: Attach disk {name} for user {userName} in lab {labName} (resource group {resourceGroupName}, subscription {subscriptionId}) to lab VM {vmId}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          vmId: requestBody.leasedByLabVmId
      - text: Lease lab disk {name} of {userName} in {labName} to VM {vmId}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
          vmId: requestBody.leasedByLabVmId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/disks/{name}/detach'].post
  update:
    x-apievangelist-phrasing:
      intent: Detach a DevTest Labs disk from a lab VM
      effect: write
      questions:
      - How do I detach a disk from my lab virtual machine?
      - Can I break a disk's lease on a DevTest Labs VM?
      instructions:
      - text: Detach disk {name} for user {userName} in lab {labName} (resource group {resourceGroupName}, subscription {subscriptionId}) from lab VM {vmId}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          vmId: requestBody.leasedByLabVmId
      - text: Break the lease of lab disk {name} owned by {userName} in {labName}.
        slots:
          name: path.name
          userName: path.userName
          labName: path.labName
      method: generated
      generated: '2026-09-26'