# 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 Global Schedules API
  version: 1.0.0
extends: openapi/microsoft-azure-globalschedules-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.DevTestLab/schedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List DevTest Labs schedules in a subscription
      effect: read
      questions:
      - Which auto-shutdown and start schedules exist across my whole subscription?
      - Can I sort and filter global schedules subscription-wide?
      instructions:
      - text: List every global schedule in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show the top {top} schedules in {subscription} matching {filter}, ordered by {orderby}.
        slots:
          top: query.$top
          subscription: path.subscriptionId
          filter: query.$filter
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/schedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List DevTest Labs schedules in a resource group
      effect: read
      questions:
      - What schedules are defined in one resource group?
      - Can I filter the schedules in a single resource group?
      instructions:
      - text: List the schedules in resource group {group}, subscription {subscription}.
        slots:
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show schedules in group {group} of {subscription} filtered by {filter}.
        slots:
          group: path.resourceGroupName
          subscription: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/schedules/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a global schedule
      effect: read
      questions:
      - When does a particular VM shutdown schedule run?
      - Can I see one schedule's full configuration by name?
      instructions:
      - text: Get schedule {name} in group {group}, subscription {subscription}.
        slots:
          name: path.name
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show schedule {name} from {group} expanding {expand}.
        slots:
          name: path.name
          group: path.resourceGroupName
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/schedules/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a global schedule
      effect: write
      questions:
      - How do I set up an auto-shutdown schedule for a VM?
      - Can I overwrite an existing schedule with new properties?
      instructions:
      - text: Create schedule {name} in group {group} ({subscription}) with properties {properties}.
        slots:
          name: path.name
          group: path.resourceGroupName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Replace schedule {name} in {group} using properties {properties} in {location}.
        slots:
          name: path.name
          group: path.resourceGroupName
          properties: requestBody.properties
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/schedules/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a global schedule
      effect: destructive
      questions:
      - How can I remove an auto-shutdown schedule?
      - Can I delete a schedule by name from a resource group?
      instructions:
      - text: Delete schedule {name} in group {group}, subscription {subscription}.
        slots:
          name: path.name
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the {name} schedule from {group}.
        slots:
          name: path.name
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/schedules/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the tags on a global schedule
      effect: write
      questions:
      - Can I change the tags on a schedule without touching its timing?
      - Why are my other properties ignored when I patch a schedule?
      instructions:
      - text: Set tags {tags} on schedule {name} in group {group}, subscription {subscription}.
        slots:
          tags: requestBody.tags
          name: path.name
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Retag the {name} schedule in {group} with {tags}.
        slots:
          name: path.name
          group: path.resourceGroupName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/schedules/{name}/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a global schedule now
      effect: write
      questions:
      - Can I trigger a shutdown schedule immediately instead of waiting?
      - How long does manually executing a schedule take?
      instructions:
      - text: Execute schedule {name} in group {group}, subscription {subscription} now.
        slots:
          name: path.name
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Run the {name} schedule in {group} right away.
        slots:
          name: path.name
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/schedules/{name}/retarget'].post
  update:
    x-apievangelist-phrasing:
      intent: Point a global schedule at a different resource
      effect: write
      questions:
      - How do I move a schedule to a different VM?
      - Can I change which resource a schedule targets?
      instructions:
      - text: Retarget schedule {name} in group {group} ({subscription}) from {current} to {target}.
        slots:
          name: path.name
          group: path.resourceGroupName
          subscription: path.subscriptionId
          current: requestBody.currentResourceId
          target: requestBody.targetResourceId
      - text: Point the {name} schedule in {group} at resource {target}.
        slots:
          name: path.name
          group: path.resourceGroupName
          target: requestBody.targetResourceId
      method: generated
      generated: '2026-09-26'