# 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 Schedules API
  version: 1.0.0
extends: openapi/microsoft-azure-schedules-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: 12
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List schedules on a Dev Box pool
      effect: read
      questions:
      - Which auto-stop schedules are set on a Dev Box pool?
      - Can I see every schedule attached to one DevCenter pool?
      instructions:
      - text: List the schedules for Dev Box pool {pool} in project {project}.
        slots:
          pool: path.poolName
          project: path.projectName
      - text: Show all DevCenter schedules configured on pool {pool}.
        slots:
          pool: path.poolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Dev Box pool schedule
      effect: read
      questions:
      - What time and time zone does a Dev Box pool schedule use?
      - Where can I inspect one schedule on a DevCenter pool?
      instructions:
      - text: Get schedule {schedule} on Dev Box pool {pool} in project {project}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
          project: path.projectName
      - text: Show DevCenter pool {pool} schedule {schedule}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Dev Box pool schedule
      effect: write
      questions:
      - How do I add a nightly shutdown schedule to a Dev Box pool?
      - Can I overwrite an existing DevCenter pool schedule in one PUT?
      instructions:
      - text: Create schedule {schedule} on Dev Box pool {pool} in project {project}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
          project: path.projectName
      - text: Put a DevCenter shutdown schedule named {schedule} on pool {pool}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Dev Box pool schedule
      effect: destructive
      questions:
      - Can I stop dev boxes in a pool from shutting down on a schedule?
      - What happens when I remove a schedule from a DevCenter pool?
      instructions:
      - text: Delete schedule {schedule} from Dev Box pool {pool} in project {project}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
          project: path.projectName
      - text: Remove the DevCenter pool {pool} schedule {schedule}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}/pools/{poolName}/schedules/{scheduleName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a Dev Box pool schedule
      effect: write
      questions:
      - Can I change just the time on an existing Dev Box pool schedule?
      - Is there a partial update for a DevCenter pool schedule?
      instructions:
      - text: Patch schedule {schedule} on Dev Box pool {pool} in project {project}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
          project: path.projectName
      - text: Change the shutdown time of DevCenter pool {pool} schedule {schedule}.
        slots:
          pool: path.poolName
          schedule: path.scheduleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List schedules in a DevTest lab
      effect: read
      questions:
      - What schedules are defined in my DevTest Labs lab?
      - Can I sort or filter the schedules in a lab?
      instructions:
      - text: List schedules in DevTest lab {lab} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          lab: path.labName
      - text: Show the first {top} schedules in lab {lab} ordered by {orderby}.
        slots:
          top: query.$top
          lab: path.labName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DevTest lab schedule
      effect: read
      questions:
      - What are the settings of one schedule in my DevTest lab?
      - Can I expand extra properties when looking up a lab schedule?
      instructions:
      - text: Get schedule {schedule} in DevTest lab {lab}, subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          lab: path.labName
          schedule: path.name
      - text: Show lab {lab} schedule {schedule} expanded with {expand}.
        slots:
          lab: path.labName
          schedule: path.name
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a DevTest lab schedule
      effect: write
      questions:
      - How do I set up an auto-shutdown schedule for a DevTest lab?
      - Can I replace an existing lab schedule with new properties?
      instructions:
      - text: Create schedule {schedule} in DevTest lab {lab}, subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          lab: path.labName
          schedule: path.name
      - text: Replace lab {lab} schedule {schedule} with these properties.
        slots:
          lab: path.labName
          schedule: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DevTest lab schedule
      effect: destructive
      questions:
      - Can I remove an auto-start schedule from my DevTest lab?
      - What happens to lab VMs when I delete their schedule?
      instructions:
      - text: Delete schedule {schedule} from DevTest lab {lab}, subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          lab: path.labName
          schedule: path.name
      - text: Remove lab {lab} schedule {schedule}.
        slots:
          lab: path.labName
          schedule: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change tags on a DevTest lab schedule
      effect: write
      questions:
      - Can I update the tags on a lab schedule?
      - Which fields of a DevTest lab schedule can be patched?
      instructions:
      - text: Set tags {tags} on schedule {schedule} in DevTest lab {lab}, subscription {subscription}, group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          lab: path.labName
          schedule: path.name
          tags: requestBody.tags
      - text: Retag lab {lab} schedule {schedule}.
        slots:
          lab: path.labName
          schedule: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules/{name}/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a DevTest lab schedule now
      effect: write
      questions:
      - Can I trigger a lab schedule immediately instead of waiting?
      - How do I manually execute a DevTest lab shutdown schedule?
      instructions:
      - text: Execute schedule {schedule} in DevTest lab {lab}, subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          lab: path.labName
          schedule: path.name
      - text: Run lab {lab} schedule {schedule} right now.
        slots:
          lab: path.labName
          schedule: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/schedules/{name}/listApplicable'].post
  update:
    x-apievangelist-phrasing:
      intent: List schedules that apply to a lab schedule
      effect: read
      questions:
      - Which schedules actually apply to a given lab schedule?
      - Can I see all applicable schedules for a DevTest lab resource?
      instructions:
      - text: List the applicable schedules for {schedule} in lab {lab}, subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          lab: path.labName
          schedule: path.name
      - text: Show which schedules apply to lab {lab} schedule {schedule}.
        slots:
          lab: path.labName
          schedule: path.name
      method: generated
      generated: '2026-09-26'