# 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 Azure Migrate Discovery Service Import…
  version: 1.0.0
extends: openapi/microsoft-azure-importsitescontroller-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.OffAzure/importSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List import sites in a subscription
      effect: read
      questions:
      - Which Azure Migrate import sites exist across my subscription?
      - Can I see all import sites without picking a resource group?
      instructions:
      - text: List all import sites in my subscription.
      - text: Show every Azure Migrate import site subscription-wide.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List import sites in a resource group
      effect: read
      questions:
      - What import sites are in my current resource group?
      - Can I list Azure Migrate import sites for just one resource group?
      instructions:
      - text: List the import sites in this resource group.
      - text: Show Azure Migrate import sites scoped to the resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an import site
      effect: read
      questions:
      - What are the details of one Azure Migrate import site?
      - Can I look up an import site by its name?
      instructions:
      - text: Get import site {site}.
        slots:
          site: path.siteName
      - text: Show the configuration of import site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an import site
      effect: write
      questions:
      - How do I create an import site for Azure Migrate?
      - Can I set up a new import site to bring in machine inventory from a file?
      instructions:
      - text: Create import site {site}.
        slots:
          site: path.siteName
      - text: Set up a new Azure Migrate import site named {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an import site
      effect: destructive
      questions:
      - Can I delete an Azure Migrate import site entirely?
      - What happens when I remove an import site resource?
      instructions:
      - text: Delete import site {site}.
        slots:
          site: path.siteName
      - text: Remove Azure Migrate import site {site} completely.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an import site
      effect: write
      questions:
      - Can I change tags or properties on an existing import site?
      - Is it possible to patch an import site in place?
      instructions:
      - text: Update tags on import site {site} to {tags}.
        slots:
          site: path.siteName
          tags: requestBody.tags
      - text: Patch the properties of import site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/deleteImportedMachines'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete imported machines from an import site
      effect: destructive
      questions:
      - Can I clear out the machines I imported into a site but keep the site?
      - Is there a way to wipe imported machine records from an import site?
      instructions:
      - text: Delete the imported machines in import site {site}.
        slots:
          site: path.siteName
      - text: Clear all imported machine records from site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/exportUri'].post
  update:
    x-apievangelist-phrasing:
      intent: Export an import site
      effect: write
      questions:
      - How do I export the contents of an Azure Migrate import site?
      - Can I get an export URI for an import site?
      instructions:
      - text: Export import site {site}.
        slots:
          site: path.siteName
      - text: Export import site {site} with import type {type}.
        slots:
          site: path.siteName
          type: requestBody.importType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/importUri'].post
  update:
    x-apievangelist-phrasing:
      intent: Import machines into an import site from a URI
      effect: write
      questions:
      - Can I import machine data into a site from a file URI?
      - What import types can I use when loading data into an import site?
      instructions:
      - text: Import data into import site {site} from {uri}.
        slots:
          site: path.siteName
          uri: requestBody.uri
      - text: Start an {type} import into site {site} using job {job}.
        slots:
          type: requestBody.importType
          site: path.siteName
          job: requestBody.jobArmId
      method: generated
      generated: '2026-09-26'