# 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 Jobs…
  version: 1.0.0
extends: openapi/microsoft-azure-importjobscontroller-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/deleteJobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List delete jobs for imported machines
      effect: read
      questions:
      - Which jobs have deleted imported machines from an Azure Migrate import site?
      - Can I see the history of machine deletions on an import site?
      instructions:
      - text: List the delete-imported-machines jobs for import site {site}.
        slots:
          site: path.siteName
      - text: Show every machine deletion job on import site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/deleteJobs/{jobName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a delete job for imported machines
      effect: read
      questions:
      - Did my job to delete imported machines finish successfully?
      - What is the status of one machine deletion job?
      instructions:
      - text: Get delete job {job} on import site {site}.
        slots:
          site: path.siteName
          job: path.jobName
      - text: Check the status of imported-machine delete job {job} for site {site}.
        slots:
          site: path.siteName
          job: path.jobName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/exportJobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List export jobs for imported machines
      effect: read
      questions:
      - Which export jobs have run for imported machines on my site?
      - Can I list all exports of imported machine data?
      instructions:
      - text: List the export jobs for import site {site}.
        slots:
          site: path.siteName
      - text: Show every imported-machines export job on site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/exportJobs/{jobName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an export job for imported machines
      effect: read
      questions:
      - Is my export of imported machines ready to download?
      - What is the result of one export job on an import site?
      instructions:
      - text: Get export job {job} on import site {site}.
        slots:
          site: path.siteName
          job: path.jobName
      - text: Check whether imported-machine export job {job} on site {site} completed.
        slots:
          site: path.siteName
          job: path.jobName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/importJobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List machine import jobs for a site
      effect: read
      questions:
      - What machine import jobs have run on an Azure Migrate import site?
      - Can I review all the CSV machine imports for one site?
      instructions:
      - text: List the machine import jobs on import site {site}.
        slots:
          site: path.siteName
      - text: Show all import-machines jobs uploaded to site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/importJobs/{jobName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a machine import job
      effect: read
      questions:
      - Did my machine import upload succeed or report errors?
      - What is the progress of one import-machines job?
      instructions:
      - text: Get machine import job {job} on site {site}.
        slots:
          site: path.siteName
          job: path.jobName
      - text: Check errors and progress for import-machines job {job} on site {site}.
        slots:
          site: path.siteName
          job: path.jobName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List all jobs of any type on an import site
      effect: read
      questions:
      - Can I see every job, regardless of type, on an import site?
      - Which ImportJob resources exist under one Azure Migrate import site?
      instructions:
      - text: List all ImportJob resources for site {site}.
        slots:
          site: path.siteName
      - text: Show every job of any kind on import site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/jobs/{jobName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ImportJob resource
      effect: read
      questions:
      - What are the details of a generic ImportJob resource on my site?
      - Where can I look up one ImportJob by name, whatever its type?
      instructions:
      - text: Get ImportJob resource {job} on site {site}.
        slots:
          site: path.siteName
          job: path.jobName
      - text: Show the ImportJob {job} on import site {site}, whatever kind it is.
        slots:
          site: path.siteName
          job: path.jobName
      method: generated
      generated: '2026-09-26'