# 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 Maps Data Registry Service Data…
  version: 1.0.0
extends: openapi/microsoft-azure-dataregistries-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['/dataRegistries'].get
  update:
    x-apievangelist-phrasing:
      intent: List data registries in an Azure Maps account
      effect: read
      questions:
      - Which storage files have I registered with my Azure Maps account?
      - Can I see every data registry and its status in my Maps account?
      instructions:
      - text: List all data registries in my Azure Maps account with API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show every registered data file in my Maps account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataRegistries/{udid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data registry
      effect: read
      questions:
      - What blob and status does a specific Maps data registry point to?
      - Has my registered geofence file finished validating?
      instructions:
      - text: Show data registry {udid}.
        slots:
          udid: path.udid
      - text: Get the Azure blob details for Maps data registry {udid}.
        slots:
          udid: path.udid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataRegistries/{udid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register a storage file with Azure Maps
      effect: write
      questions:
      - How do I register a GeoJSON file from my storage account with Azure Maps?
      - What is the maximum file size I can register as a Maps data registry?
      instructions:
      - text: Register the blob {azure_blob} with my Maps account as data registry {udid}.
        slots:
          azure_blob: requestBody.azureBlob
          udid: path.udid
      - text: Replace data registry {udid} with a {kind} registration described as {description}.
        slots:
          udid: path.udid
          kind: requestBody.kind
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataRegistries/{udid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unregister a data registry
      effect: destructive
      questions:
      - How do I unregister a file from Azure Maps without deleting it from storage?
      - Can I remove a geofence data registry I no longer use?
      instructions:
      - text: Unregister data registry {udid}.
        slots:
          udid: path.udid
      - text: Remove Maps data registry {udid} but leave the blob in storage.
        slots:
          udid: path.udid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataRegistries/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a data registration
      effect: read
      questions:
      - Is my long-running data register request still running or did it fail?
      - Where do I check progress of a Maps register or replace operation?
      instructions:
      - text: Check the status of data registry operation {operation_id}.
        slots:
          operation_id: path.operationId
      - text: Poll registration operation {operation_id} until it finishes.
        slots:
          operation_id: path.operationId
      method: generated
      generated: '2026-09-26'