# 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 Dpp Job API
  version: 1.0.0
extends: openapi/microsoft-azure-dppjob-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: 2
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/locations/{location}/fetchCrossRegionRestoreJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch one cross-region restore job
      effect: read
      questions:
      - What's the status of a cross-region restore job from my backup vault?
      - Can I look up a single restore job that ran in the secondary region?
      instructions:
      - text: Fetch cross-region restore job {jobId} in {location} for vault {sourceBackupVaultId} from {sourceRegion}.
        slots:
          jobId: requestBody.jobId
          location: path.location
          sourceBackupVaultId: requestBody.sourceBackupVaultId
          sourceRegion: requestBody.sourceRegion
      - text: Get restore job {jobId} for backup vault {sourceBackupVaultId}, source region {sourceRegion}.
        slots:
          jobId: requestBody.jobId
          sourceBackupVaultId: requestBody.sourceBackupVaultId
          sourceRegion: requestBody.sourceRegion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/locations/{location}/fetchCrossRegionRestoreJobs'].post
  update:
    x-apievangelist-phrasing:
      intent: List cross-region restore jobs for a vault
      effect: read
      questions:
      - Which cross-region restore jobs belong to my backup vault?
      - Can I filter the list of cross-region restore jobs?
      instructions:
      - text: List cross-region restore jobs in {location} for vault {sourceBackupVaultId} from {sourceRegion}.
        slots:
          location: path.location
          sourceBackupVaultId: requestBody.sourceBackupVaultId
          sourceRegion: requestBody.sourceRegion
      - text: Show all secondary-region restore jobs of vault {sourceBackupVaultId} from {sourceRegion} matching {filter}.
        slots:
          sourceBackupVaultId: requestBody.sourceBackupVaultId
          sourceRegion: requestBody.sourceRegion
          filter: query.$filter
      method: generated
      generated: '2026-10-01'