# 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 Storage Import Export API
  version: 1.0.0
extends: openapi/microsoft-azure-storageimportexport-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: 10
- target: $.paths['/providers/Microsoft.ImportExport/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List data centers that accept Import/Export disks
      effect: read
      questions:
      - Which data center regions can I ship my import or export drives to?
      - Where can I send hard drives for an Azure Import/Export job?
      instructions:
      - text: List the shipping locations for Import/Export drives.
      - text: Show Import/Export shipping regions with names in {language}.
        slots:
          language: header.Accept-Language
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ImportExport/locations/{locationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get shipping details for one Import/Export location
      effect: read
      questions:
      - What is the shipping address for a specific Import/Export data center?
      - Can I see the details of one region I plan to ship disks to?
      instructions:
      - text: Get the shipping details for Import/Export location {locationName}.
        slots:
          locationName: path.locationName
      - text: Show where to send drives for location {locationName}.
        slots:
          locationName: path.locationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ImportExport/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List Import/Export jobs in a subscription
      effect: read
      questions:
      - What active and completed import/export jobs do I have across my subscription?
      - Can I filter my subscription's disk shipping jobs?
      instructions:
      - text: List all Import/Export jobs in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show up to {top} jobs in subscription {subscriptionId} matching {filter}.
        slots:
          top: query.$top
          subscriptionId: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ImportExport/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List Import/Export jobs in a resource group
      effect: read
      questions:
      - Which import/export jobs belong to one resource group?
      - Can I narrow my drive shipping jobs to a single resource group?
      instructions:
      - text: List Import/Export jobs in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show jobs in group {resourceGroupName} that match {filter}.
        slots:
          resourceGroupName: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ImportExport/jobs/{jobName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Import/Export job's details
      effect: read
      questions:
      - What state is my import/export job in right now?
      - How do I check the details of a single disk shipping job?
      instructions:
      - text: Get Import/Export job {jobName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          jobName: path.jobName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the status of job {jobName}.
        slots:
          jobName: path.jobName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ImportExport/jobs/{jobName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Import/Export job
      effect: write
      questions:
      - How do I start a new job to ship disks into Azure storage?
      - Can I create an export job that copies blobs onto drives I send in?
      instructions:
      - text: Create Import/Export job {jobName} in group {resourceGroupName}, subscription {subscriptionId}, location {location}.
        slots:
          jobName: path.jobName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Set up disk shipping job {jobName} with properties {properties}.
        slots:
          jobName: path.jobName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ImportExport/jobs/{jobName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Import/Export job
      effect: destructive
      questions:
      - Can I delete an import/export job that's already in progress?
      - Which job states allow me to remove a drive shipping job?
      instructions:
      - text: Delete Import/Export job {jobName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          jobName: path.jobName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the completed disk job {jobName}.
        slots:
          jobName: path.jobName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ImportExport/jobs/{jobName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Import/Export job or mark drives shipped
      effect: write
      questions:
      - How do I tell the Import/Export service that my drives have been shipped?
      - Can I change the tags or properties of an existing disk job?
      instructions:
      - text: Update job {jobName} in group {resourceGroupName}, subscription {subscriptionId} with {properties}.
        slots:
          jobName: path.jobName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Mark the drives for job {jobName} as shipped to the data center.
        slots:
          jobName: path.jobName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ImportExport/jobs/{jobName}/listBitLockerKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get BitLocker keys for a job's drives
      effect: read
      questions:
      - Where do I find the BitLocker keys for the drives in my export job?
      - Can I retrieve the unlock keys for every disk in an Import/Export job?
      instructions:
      - text: List BitLocker keys for job {jobName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          jobName: path.jobName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me the drive unlock keys for job {jobName}.
        slots:
          jobName: path.jobName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ImportExport/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Import/Export provider operations
      effect: read
      questions:
      - What operations does the Import/Export resource provider support?
      - Can I see the full action list for the Import/Export service?
      instructions:
      - text: List the operations the Import/Export resource provider exposes.
      - text: Show Import/Export provider operations described in {language}.
        slots:
          language: header.Accept-Language
      method: generated
      generated: '2026-09-26'