# 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 Job Definitions API
  version: 1.0.0
extends: openapi/microsoft-azure-job-definitions-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: 13
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}/dataServices/{dataServiceName}/jobDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List job definitions for a hybrid data service
      effect: read
      questions:
      - Which job definitions belong to one data service in my hybrid data manager?
      - Can I filter a data service's job definitions?
      instructions:
      - text: List job definitions of data service {dataServiceName} in data manager {dataManagerName}.
        slots:
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
      - text: Show job definitions for data service {dataServiceName}, data manager {dataManagerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}/dataServices/{dataServiceName}/jobDefinitions/{jobDefinitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a hybrid data job definition
      effect: read
      questions:
      - Can I look up one job definition on a hybrid data service by name?
      - What's configured in a specific data manager job definition?
      instructions:
      - text: Get job definition {jobDefinitionName} of data service {dataServiceName} in data manager {dataManagerName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
      - text: Show hybrid job {jobDefinitionName} on service {dataServiceName}, manager {dataManagerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}/dataServices/{dataServiceName}/jobDefinitions/{jobDefinitionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a hybrid data job definition
      effect: write
      questions:
      - How do I define a new data transfer job on a hybrid data service?
      - Can I change an existing data manager job definition's settings?
      instructions:
      - text: Create or update job definition {jobDefinitionName} on data service {dataServiceName} of data manager {dataManagerName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
      - text: Save hybrid job {jobDefinitionName} for service {dataServiceName}, manager {dataManagerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}/dataServices/{dataServiceName}/jobDefinitions/{jobDefinitionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hybrid data job definition
      effect: destructive
      questions:
      - Can I delete a job definition from a hybrid data service?
      - Is it possible to remove a data manager job definition I no longer run?
      instructions:
      - text: Delete job definition {jobDefinitionName} from data service {dataServiceName} in data manager {dataManagerName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
      - text: Remove hybrid job {jobDefinitionName} on service {dataServiceName}, manager {dataManagerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}/dataServices/{dataServiceName}/jobDefinitions/{jobDefinitionName}/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a hybrid data job definition
      effect: write
      questions:
      - How do I start a job run from a hybrid data job definition?
      - Can I pass customer secrets when running a data manager job?
      instructions:
      - text: Run job definition {jobDefinitionName} on data service {dataServiceName} in data manager {dataManagerName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
      - text: Launch a run of hybrid job {jobDefinitionName}, service {dataServiceName}, manager {dataManagerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          dataServiceName: path.dataServiceName
          dataManagerName: path.dataManagerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}/jobDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List all job definitions in a data manager
      effect: read
      questions:
      - What job definitions exist across my whole hybrid data manager resource?
      - Can I filter job definitions at the data manager level rather than per service?
      instructions:
      - text: List every job definition in data manager {dataManagerName}.
        slots:
          dataManagerName: path.dataManagerName
      - text: Show all job definitions across data manager {dataManagerName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          dataManagerName: path.dataManagerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}/jobDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List job definitions in a Storage Mover project
      effect: read
      questions:
      - Which job definitions are in my Storage Mover project?
      - Can I see all migration job definitions for one Storage Mover project?
      instructions:
      - text: List job definitions in Storage Mover {storageMoverName} project {projectName}.
        slots:
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      - text: Show every migration job definition of project {projectName} on Storage Mover {storageMoverName}.
        slots:
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}/jobDefinitions/{jobDefinitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Storage Mover job definition
      effect: read
      questions:
      - Can I view one Storage Mover job definition's source and target settings?
      - What's configured on a specific Storage Mover job definition?
      instructions:
      - text: Get job definition {jobDefinitionName} in Storage Mover {storageMoverName} project {projectName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      - text: Show Storage Mover job {jobDefinitionName} from project {projectName} on {storageMoverName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}/jobDefinitions/{jobDefinitionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Storage Mover job definition
      effect: write
      questions:
      - How do I define a data migration job in Storage Mover?
      - Can I set up a single unit of managed data transfer in a Storage Mover project?
      instructions:
      - text: Create job definition {jobDefinitionName} in Storage Mover {storageMoverName} project {projectName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      - text: Create or replace Storage Mover job {jobDefinitionName} for project {projectName} on {storageMoverName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}/jobDefinitions/{jobDefinitionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Storage Mover job definition
      effect: destructive
      questions:
      - Can I delete a job definition from a Storage Mover project?
      - Is there a way to remove a Storage Mover migration job I don't need?
      instructions:
      - text: Delete job definition {jobDefinitionName} from Storage Mover {storageMoverName} project {projectName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      - text: Remove Storage Mover job {jobDefinitionName} in project {projectName} on {storageMoverName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}/jobDefinitions/{jobDefinitionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update properties of a Storage Mover job definition
      effect: write
      questions:
      - Can I change just a few properties of a Storage Mover job definition and leave the rest?
      - How do I edit an existing Storage Mover job's description?
      instructions:
      - text: Update job definition {jobDefinitionName} in Storage Mover {storageMoverName} project {projectName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      - text: Patch the properties of Storage Mover job {jobDefinitionName}, project {projectName}, mover {storageMoverName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}/jobDefinitions/{jobDefinitionName}/startJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a Storage Mover job run
      effect: write
      questions:
      - How do I start a migration run from a Storage Mover job definition?
      - Can I ask the agent to run a Storage Mover job now?
      instructions:
      - text: Start a job run for {jobDefinitionName} in Storage Mover {storageMoverName} project {projectName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      - text: Kick off Storage Mover job {jobDefinitionName} from project {projectName} on {storageMoverName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageMover/storageMovers/{storageMoverName}/projects/{projectName}/jobDefinitions/{jobDefinitionName}/stopJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an active Storage Mover job run
      effect: destructive
      questions:
      - Can I stop a Storage Mover migration job that's currently running?
      - How do I halt an active job run for a Storage Mover job definition?
      instructions:
      - text: Stop the running job for {jobDefinitionName} in Storage Mover {storageMoverName} project {projectName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      - text: Halt any active run of Storage Mover job {jobDefinitionName}, project {projectName}, mover {storageMoverName}.
        slots:
          jobDefinitionName: path.jobDefinitionName
          storageMoverName: path.storageMoverName
          projectName: path.projectName
      method: generated
      generated: '2026-10-01'