# 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 DevTestLabsClient Policies API
  version: 1.0.0
extends: openapi/microsoft-azure-policies-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/policysets/{policySetName}/policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List policies in a DevTest Labs policy set
      effect: read
      questions:
      - What policies are applied to my DevTest Labs lab?
      - Can I filter or sort the policies in a lab's policy set?
      instructions:
      - text: List policies in policy set {policySetName} of lab {labName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          policySetName: path.policySetName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the first {top} lab {labName} policies in set {policySetName} ordered by {orderby}.
        slots:
          top: query.$top
          labName: path.labName
          policySetName: path.policySetName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/policysets/{policySetName}/policies/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DevTest Labs policy
      effect: read
      questions:
      - How do I check the threshold of a specific lab policy, like max VMs per user?
      - Is a particular DevTest Labs policy enabled?
      instructions:
      - text: Get policy {name} in set {policySetName} of lab {labName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          policySetName: path.policySetName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show whether lab {labName} policy {name} is enabled and its threshold.
        slots:
          labName: path.labName
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/policysets/{policySetName}/policies/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a DevTest Labs policy
      effect: write
      questions:
      - How do I cap the number of VMs each user can create in a lab?
      - Can I replace an existing lab policy with a new definition?
      instructions:
      - text: Create policy {name} in set {policySetName} of lab {labName} in {resourceGroupName}, subscription {subscriptionId}, with {properties}.
        slots:
          name: path.name
          policySetName: path.policySetName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Replace lab {labName} policy {name} with a new threshold definition.
        slots:
          labName: path.labName
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/policysets/{policySetName}/policies/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DevTest Labs policy
      effect: destructive
      questions:
      - How do I remove a restriction policy from my lab?
      - Can I delete one policy from a lab's policy set?
      instructions:
      - text: Delete policy {name} from set {policySetName} of lab {labName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          policySetName: path.policySetName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the {name} policy from lab {labName}.
        slots:
          name: path.name
          labName: path.labName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/policysets/{policySetName}/policies/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a DevTest Labs policy
      effect: write
      questions:
      - Can I change anything besides tags when patching a lab policy?
      - How do I tag a DevTest Labs policy for cost tracking?
      instructions:
      - text: Set tags {tags} on policy {name} in set {policySetName} of lab {labName}, {resourceGroupName}, subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          name: path.name
          policySetName: path.policySetName
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Retag lab {labName} policy {name} with {tags}.
        slots:
          labName: path.labName
          name: path.name
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'