Microsoft Azure Desktop Virtualization API Client — SessionHostManagements

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Desktop Virtualization API Client — SessionHostManagements
  description: 'Microsoft Azure Desktop Virtualization API Client — SessionHostManagements. 4 operations. Lead operation:
    Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Desktopvirtualization
    Hostpools Hostpoolname Sessionhostmanagements. Self-contained Naftiko capability covering one Microsoft Azure business
    surface.'
  tags:
  - Microsoft Azure
  - SessionHostManagements
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: desktop-virtualization-api-client-sessionhostmanagements
    baseUri: https://management.azure.com
    description: Microsoft Azure Desktop Virtualization API Client — SessionHostManagements business capability. Self-contained,
      no shared references.
    resources:
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements
      operations:
      - name: microsoftazuresessionhostmanagementslistbyhostpool
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default
      operations:
      - name: microsoftazuresessionhostmanagementsget
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements Default
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default/operationStatuses
      operations:
      - name: microsoftazuresessionhostmanagementsoperationstatuslist
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements Default Operationstatuses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: isLatest
          in: query
          type: boolean
          description: Returns the most recent sessionHostManagement operation.
        - name: type
          in: query
          type: string
          description: Filter based on the type of sessionHostManagement operation. Valid values are 'InitiateSessionHostUpdate'
            and 'ValidateSessionHostUpdate'
        - name: isNonTerminal
          in: query
          type: boolean
          description: Returns currently running operations. Ignored if 'isLatest' is true
        - name: correlationId
          in: query
          type: string
          description: CorrelationId of the sessionHostManagement operations to be returned.
        - name: action
          in: query
          type: string
          description: 'Action type for the Operation Status list to be filtered on. Valid actions are: start | retry | pause
            | resume | cancel).'
        - name: isInitiatingOperation
          in: query
          type: boolean
          description: Filter option to only return operations that initiated a sessionHostManagement operation.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHostManagements/default/operationStatuses/{operationId}
      operations:
      - name: microsoftazuresessionhostmanagementsoperationstatusget
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements Default Operationstatuses Operationid
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: desktop-virtualization-api-client-sessionhostmanagements-rest
    port: 8080
    description: REST adapter for Microsoft Azure Desktop Virtualization API Client — SessionHostManagements. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-desktopvirtualization/hostpools/{hostpoolname}/sessionhostmanagements
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazuresessionhostmanagementslistbyhostpool
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements
        call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementslistbyhostpool
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-desktopvirtualization/hostpools/{hostpoolname}/sessionhostmanagements/default
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazuresessionhostmanagementsget
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements Default
        call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementsget
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-desktopvirtualization/hostpools/{hostpoolname}/sessionhostmanagements/default/operationstatuses
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazuresessionhostmanagementsoperationstatuslist
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements Default Operationstatuses
        call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementsoperationstatuslist
        with:
          isLatest: rest.isLatest
          type: rest.type
          isNonTerminal: rest.isNonTerminal
          correlationId: rest.correlationId
          action: rest.action
          isInitiatingOperation: rest.isInitiatingOperation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-desktopvirtualization/hostpools/{hostpoolname}/sessionhostmanagements/default/operationstatuses/{operationid}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazuresessionhostmanagementsoperationstatusget
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Desktopvirtualization Hostpools Hostpoolname Sessionhostmanagements Default Operationstatuses Operationid
        call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementsoperationstatusget
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: desktop-virtualization-api-client-sessionhostmanagements-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Desktop Virtualization API Client — SessionHostManagements. One tool per
      consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-subscriptions-subscriptionid
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Desktopvirtualization
        Hostpools Hostpoolname Sessionhostmanagements
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementslistbyhostpool
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-2
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Desktopvirtualization
        Hostpools Hostpoolname Sessionhostmanagements Default
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementsget
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-3
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Desktopvirtualization
        Hostpools Hostpoolname Sessionhostmanagements Default Operationstatuses
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementsoperationstatuslist
      with:
        isLatest: tools.isLatest
        type: tools.type
        isNonTerminal: tools.isNonTerminal
        correlationId: tools.correlationId
        action: tools.action
        isInitiatingOperation: tools.isInitiatingOperation
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-4
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Desktopvirtualization
        Hostpools Hostpoolname Sessionhostmanagements Default Operationstatuses Operationid
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: desktop-virtualization-api-client-sessionhostmanagements.microsoftazuresessionhostmanagementsoperationstatusget
      outputParameters:
      - type: object
        mapping: $.