Microsoft Azure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure Azure Migrate Discovery Service Import Jobs…

9 actions 9 updates phrasing extends openapi/microsoft-azure-importjobscontroller-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 9

$.info
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/deleteJobs'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/deleteJobs/{jobName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/exportJobs'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/exportJobs/{jobName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/importJobs'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/importJobs/{jobName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/jobs'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/importSites/{siteName}/jobs/{jobName}'].get

OpenAPI Overlay

Raw ↑
# 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'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/microsoft-azure-importjobscontroller-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.