# 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 Desktop Virtualization API Client Session…
  version: 1.0.0
extends: openapi/microsoft-azure-sessionhostmanagement-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Configure session host management for a host pool
      effect: write
      questions:
      - How do I set up session host management settings for an Azure Virtual Desktop host pool?
      - Can I replace a host pool's session host management configuration?
      instructions:
      - text: Create the session host management configuration for host pool {hostPoolName}.
        slots:
          hostPoolName: path.hostPoolName
      - text: Replace session host management settings on {hostPoolName} with {properties}.
        slots:
          hostPoolName: path.hostPoolName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update session host management for a host pool
      effect: write
      questions:
      - Can I change only some session host management settings on a host pool?
      - Is partial update supported for a host pool's session host management?
      instructions:
      - text: Patch the session host management settings for host pool {hostPoolName}.
        slots:
          hostPoolName: path.hostPoolName
      - text: Tweak session host management properties on {hostPoolName}.
        slots:
          hostPoolName: path.hostPoolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default/initiateSessionHostUpdate'].post
  update:
    x-apievangelist-phrasing:
      intent: Start or schedule a host pool session host update
      effect: write
      questions:
      - Can I schedule an Azure Virtual Desktop host pool update for later?
      - Which time zone does a scheduled session host update use?
      instructions:
      - text: Start a session host update on host pool {hostPoolName} now.
        slots:
          hostPoolName: path.hostPoolName
      - text: Schedule a session host update for {hostPoolName} at {scheduledDateTime} in time zone {scheduledDateTimeZone}.
        slots:
          hostPoolName: path.hostPoolName
          scheduledDateTime: requestBody.scheduledDateTime
          scheduledDateTimeZone: requestBody.scheduledDateTimeZone
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default/controlSessionHostUpdate'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause, resume or cancel a host pool update
      effect: write
      questions:
      - Can I pause or cancel a session host update that is in progress?
      - Is there a way to leave a message for users when I cancel a host pool update?
      instructions:
      - text: Apply action {action} to the running update on host pool {hostPoolName}.
        slots:
          action: requestBody.action
          hostPoolName: path.hostPoolName
      - text: Cancel the host pool update on {hostPoolName} with message {cancelMessage}.
        slots:
          hostPoolName: path.hostPoolName
          cancelMessage: requestBody.cancelMessage
      method: generated
      generated: '2026-09-26'