# 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 FabricAdminClient Scale Unit Nodes API
  version: 1.0.0
extends: openapi/microsoft-azure-scaleunitnodes-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/Shutdown'].post
  update:
    x-apievangelist-phrasing:
      intent: Shut down a scale unit node
      effect: write
      questions:
      - How do I gracefully shut down a scale unit node in Azure Stack Hub?
      - Can I shut down one physical node of my Azure Stack scale unit?
      instructions:
      - text: Shut down scale unit node {node}.
        slots:
          node: path.scaleUnitNode
      - text: Gracefully shut down Azure Stack node {node} in fabric location {location}.
        slots:
          node: path.scaleUnitNode
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/PowerOff'].post
  update:
    x-apievangelist-phrasing:
      intent: Power off a scale unit node
      effect: write
      questions:
      - How do I power off a scale unit node rather than shutting it down?
      - Can I cut power to an Azure Stack Hub node from the admin API?
      instructions:
      - text: Power off scale unit node {node}.
        slots:
          node: path.scaleUnitNode
      - text: Cut power to Azure Stack node {node} in fabric location {location}.
        slots:
          node: path.scaleUnitNode
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/PowerOn'].post
  update:
    x-apievangelist-phrasing:
      intent: Power on a scale unit node
      effect: write
      questions:
      - How do I bring a powered-off scale unit node back on?
      - Can I power on an Azure Stack Hub node remotely?
      instructions:
      - text: Power on scale unit node {node}.
        slots:
          node: path.scaleUnitNode
      - text: Turn Azure Stack node {node} in fabric location {location} back on.
        slots:
          node: path.scaleUnitNode
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/StartMaintenanceMode'].post
  update:
    x-apievangelist-phrasing:
      intent: Put a scale unit node into maintenance mode
      effect: write
      questions:
      - How do I drain a scale unit node for maintenance?
      - Can I put an Azure Stack node into maintenance mode before servicing hardware?
      instructions:
      - text: Start maintenance mode on scale unit node {node}.
        slots:
          node: path.scaleUnitNode
      - text: Put Azure Stack node {node} in fabric location {location} into maintenance.
        slots:
          node: path.scaleUnitNode
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/StopMaintenanceMode'].post
  update:
    x-apievangelist-phrasing:
      intent: Take a scale unit node out of maintenance mode
      effect: write
      questions:
      - How do I return a scale unit node to service after maintenance?
      - Can I end maintenance mode on an Azure Stack node?
      instructions:
      - text: Stop maintenance mode on scale unit node {node}.
        slots:
          node: path.scaleUnitNode
      - text: Bring Azure Stack node {node} in fabric location {location} out of maintenance.
        slots:
          node: path.scaleUnitNode
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/Repair'].post
  update:
    x-apievangelist-phrasing:
      intent: Repair a scale unit node
      effect: write
      questions:
      - How do I repair a failed node in my Azure Stack Hub cluster?
      - What bare metal details do I need to supply to repair a scale unit node?
      instructions:
      - text: Repair scale unit node {node} using bare metal node details {bareMetalNode}.
        slots:
          node: path.scaleUnitNode
          bareMetalNode: body.bareMetalNode
      - text: Run a repair on cluster node {node} in fabric location {location}.
        slots:
          node: path.scaleUnitNode
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a scale unit node
      effect: read
      questions:
      - How do I check the power state and status of one scale unit node?
      - What are the details of a specific Azure Stack node?
      instructions:
      - text: Get scale unit node {node}.
        slots:
          node: path.scaleUnitNode
      - text: Show the status of Azure Stack node {node} in fabric location {location}.
        slots:
          node: path.scaleUnitNode
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes'].get
  update:
    x-apievangelist-phrasing:
      intent: List scale unit nodes in a location
      effect: read
      questions:
      - Which scale unit nodes are in my Azure Stack Hub location?
      - How do I list every physical node in a fabric location?
      instructions:
      - text: List all scale unit nodes in fabric location {location}.
        slots:
          location: path.location
      - text: Show every Azure Stack node and its state using admin API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-10-01'