API Evangelist conversational phrasing for Microsoft Azure Azure SQL Database Import/Export spec…

# 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 SQL Database Import/Export spec…
  version: 1.0.0
extends: openapi/microsoft-azure-import-export-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a bacpac into a new SQL database
      effect: write
      questions:
      - How do I create a new Azure SQL database from a bacpac file in storage?
      - Which edition and service objective must I choose when importing a bacpac?
      instructions:
      - text: Import bacpac {storageUri} into new database {databaseName} on server {serverName} as {edition} {serviceObjectiveName}, max {maxSizeBytes} bytes.
        slots:
          storageUri: requestBody.storageUri
          databaseName: requestBody.databaseName
          serverName: path.serverName
          edition: requestBody.edition
          serviceObjectiveName: requestBody.serviceObjectiveName
          maxSizeBytes: requestBody.maxSizeBytes
      - text: Restore {storageUri} as a brand-new database {databaseName} on SQL server {serverName} using admin {administratorLogin}.
        slots:
          storageUri: requestBody.storageUri
          databaseName: requestBody.databaseName
          serverName: path.serverName
          administratorLogin: requestBody.administratorLogin
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/extensions/{extensionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Import a bacpac into an existing empty database
      effect: write
      questions:
      - Can I load a bacpac into a SQL database that already exists?
      - Does the target database need to be empty before an import extension runs?
      instructions:
      - text: Import into existing empty database {databaseName} on server {serverName} via extension {extensionName}.
        slots:
          databaseName: path.databaseName
          serverName: path.serverName
          extensionName: path.extensionName
      - text: Load a bacpac into the empty SQL database {databaseName} on {serverName} with import extension {extensionName}.
        slots:
          databaseName: path.databaseName
          serverName: path.serverName
          extensionName: path.extensionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a SQL database to a bacpac
      effect: write
      questions:
      - How do I export an Azure SQL database to a bacpac file in blob storage?
      - What storage key and admin credentials does a database export need?
      instructions:
      - text: Export database {databaseName} on server {serverName} to {storageUri}.
        slots:
          databaseName: path.databaseName
          serverName: path.serverName
          storageUri: requestBody.storageUri
      - text: Back up SQL database {databaseName} from {serverName} as a bacpac at {storageUri} using admin {administratorLogin}.
        slots:
          databaseName: path.databaseName
          serverName: path.serverName
          storageUri: requestBody.storageUri
          administratorLogin: requestBody.administratorLogin
      method: generated
      generated: '2026-10-01'