# 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 StorageMoverClient Agents API
  version: 1.0.0
extends: openapi/microsoft-azure-agents-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/agents'].get
  update:
    x-apievangelist-phrasing:
      intent: List agents in a Storage Mover
      effect: read
      questions:
      - Which migration agents are registered to my Azure Storage Mover?
      - Can I see every agent machine attached to a Storage Mover?
      instructions:
      - text: List the agents in Storage Mover {storageMoverName}.
        slots:
          storageMoverName: path.storageMoverName
      - text: Show all registered agents for mover {storageMoverName}.
        slots:
          storageMoverName: path.storageMoverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/agents/{agentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Storage Mover agent
      effect: read
      questions:
      - Is my Storage Mover agent online and what machine does it reference?
      - Can I look up one Storage Mover agent by name?
      instructions:
      - text: Get agent {agentName} in Storage Mover {storageMoverName}.
        slots:
          agentName: path.agentName
          storageMoverName: path.storageMoverName
      - text: Show the status of Storage Mover agent {agentName}.
        slots:
          agentName: path.agentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/agents/{agentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register a Storage Mover agent
      effect: write
      questions:
      - How do I register a hybrid machine as an agent that can run migration jobs?
      - Can I create an agent resource pointing at an Arc-enabled hybrid compute machine?
      instructions:
      - text: Register agent {agentName} in Storage Mover {storageMoverName} with properties {properties}.
        slots:
          agentName: path.agentName
          storageMoverName: path.storageMoverName
          properties: requestBody.properties
      - text: Create or replace the agent resource {agentName} for mover {storageMoverName}.
        slots:
          agentName: path.agentName
          storageMoverName: path.storageMoverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/agents/{agentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Storage Mover agent
      effect: destructive
      questions:
      - How do I unregister an agent from my Storage Mover?
      - Can I remove an agent resource I'm decommissioning?
      instructions:
      - text: Delete agent {agentName} from Storage Mover {storageMoverName}.
        slots:
          agentName: path.agentName
          storageMoverName: path.storageMoverName
      - text: Unregister Storage Mover agent {agentName}.
        slots:
          agentName: path.agentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/agents/{agentName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Storage Mover agent
      effect: write
      questions:
      - Can I change the description of an existing Storage Mover agent?
      - Which agent properties can I patch without re-registering it?
      instructions:
      - text: Patch agent {agentName} in Storage Mover {storageMoverName} with {properties}.
        slots:
          agentName: path.agentName
          storageMoverName: path.storageMoverName
          properties: requestBody.properties
      - text: Update the existing Storage Mover agent {agentName}'s properties.
        slots:
          agentName: path.agentName
      method: generated
      generated: '2026-09-26'