# 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 DataProtectionBackupClient Azure Backup Job…
  version: 1.0.0
extends: openapi/microsoft-azure-azurebackupjob-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.DataProtection/backupVaults/{vaultName}/backupJobs/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backup job in a Backup vault
      effect: read
      questions:
      - How do I check the status of a backup job in my Backup vault?
      - Can I look up one Data Protection backup job by its ID?
      instructions:
      - text: Get backup job {job} in vault {vault}.
        slots:
          job: path.jobId
          vault: path.vaultName
      - text: Show the status of job {job} in Backup vault {vault}.
        slots:
          job: path.jobId
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupJobs/{jobId}/triggerCancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a running backup job
      effect: destructive
      questions:
      - How do I cancel a backup job that's still running?
      - Does cancelling a backup job return an operation I can track?
      instructions:
      - text: Cancel backup job {job} in vault {vault}.
        slots:
          job: path.jobId
          vault: path.vaultName
      - text: Trigger cancellation of job {job} in Backup vault {vault}.
        slots:
          job: path.jobId
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupJobs/{jobId}/generateProgressUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a progress URL for a backup job
      effect: read
      questions:
      - Where can I read the live progress of a backup job?
      - Can I get a SAS URL to a blob showing a job's current progress?
      instructions:
      - text: Generate a progress URL for job {job} in vault {vault}.
        slots:
          job: path.jobId
          vault: path.vaultName
      - text: Give me the SAS link to track progress of backup job {job} in {vault}.
        slots:
          job: path.jobId
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/exportBackupJobs'].post
  update:
    x-apievangelist-phrasing:
      intent: Export all backup jobs from a vault
      effect: write
      questions:
      - How do I export the list of backup jobs from a Backup vault?
      - Can I dump a vault's job history to a blob?
      instructions:
      - text: Export backup jobs from vault {vault}.
        slots:
          vault: path.vaultName
      - text: Start a job export for Backup vault {vault}.
        slots:
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupJobs/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the result of a backup job export
      effect: read
      questions:
      - Has my backup jobs export finished, and where is the file?
      - How do I get the blob URL and SAS key for exported jobs?
      instructions:
      - text: Get export operation {operation} result for vault {vault}.
        slots:
          operation: path.operationId
          vault: path.vaultName
      - text: Check whether job export {operation} in {vault} is done and return the blob link.
        slots:
          operation: path.operationId
          vault: path.vaultName
      method: generated
      generated: '2026-09-26'