# 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 Datasets API
  version: 1.0.0
extends: openapi/microsoft-azure-datasets-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: 18
- target: $.paths['/datasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Maps Creator datasets
      effect: read
      questions:
      - Which indoor map datasets have I already created in Azure Maps Creator?
      - Can I see all my successfully created Creator datasets in one call?
      instructions:
      - text: List all my Azure Maps Creator datasets.
      - text: Show every indoor map dataset in my Maps account using key {key}.
        slots:
          key: query.subscription-key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Azure Maps Creator dataset from a conversion
      effect: write
      questions:
      - How do I turn a converted indoor map package into a Creator dataset?
      - Can I append a new conversion to an existing Azure Maps dataset?
      instructions:
      - text: Create an Azure Maps dataset from conversion {conversionId}.
        slots:
          conversionId: query.conversionId
      - text: Append conversion {conversionId} to existing Creator dataset {datasetId} with description {description}.
        slots:
          conversionId: query.conversionId
          datasetId: query.datasetId
          description: query.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/datasets/{datasetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Maps Creator dataset
      effect: read
      questions:
      - What are the details of one indoor map dataset I created in Creator?
      - Can I check which conversion an Azure Maps dataset came from?
      instructions:
      - text: Show Azure Maps dataset {dataset}.
        slots:
          dataset: path.datasetId
      - text: Get the details of Creator dataset {dataset}.
        slots:
          dataset: path.datasetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{datasetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure Maps Creator dataset
      effect: destructive
      questions:
      - How do I free up Creator storage by removing an old indoor map dataset?
      - Can I permanently delete an unused Azure Maps dataset?
      instructions:
      - text: Delete Azure Maps dataset {dataset}.
        slots:
          dataset: path.datasetId
      - text: Remove unused Creator dataset {dataset} to make room for new content.
        slots:
          dataset: path.datasetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{datasetId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a solution dataset with a schema
      effect: write
      questions:
      - Can I define a dataset with its own records schema for a solution?
      - How do I change the status or description of a solution dataset by its ID?
      instructions:
      - text: Create or update solution dataset {dataset} of type {type}.
        slots:
          dataset: path.datasetId
          type: requestBody.type
      - text: Set the records schema of solution dataset {dataset} to {schema}.
        slots:
          dataset: path.datasetId
          schema: requestBody.recordsSchema
      - text: Attach dataset {dataset} to solution {solution}.
        slots:
          dataset: path.datasetId
          solution: requestBody.solutionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check progress of an Azure Maps dataset creation
      effect: read
      questions:
      - Has my Azure Maps dataset creation finished yet?
      - Where do I find the new dataset ID once a Creator dataset operation succeeds?
      instructions:
      - text: Check the status of dataset operation {operation}.
        slots:
          operation: path.operationId
      - text: Poll Creator dataset creation job {operation} until it completes.
        slots:
          operation: path.operationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an annotated training dataset by name
      effect: read
      questions:
      - What annotation files and kind are registered for a named training dataset?
      - Can I look up a registered dataset by its name to see its annotation settings?
      instructions:
      - text: Show registered dataset {name}.
        slots:
          name: path.name
      - text: Get the annotation kind and file URIs of dataset {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register a new annotated training dataset
      effect: write
      questions:
      - How do I register a new dataset with annotation files for model training?
      - What happens if I register a dataset under a name that already exists?
      instructions:
      - text: Register dataset {name} with annotation files {files}.
        slots:
          name: path.name
          files: requestBody.annotationFileUris
      - text: Register dataset {name} using annotation kind {kind}.
        slots:
          name: path.name
          kind: requestBody.annotationKind
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unregister an annotated training dataset
      effect: destructive
      questions:
      - Can I unregister a named dataset I no longer train with?
      - Is it possible to only unregister a dataset if its ETag still matches?
      instructions:
      - text: Unregister dataset {name}.
        slots:
          name: path.name
      - text: Unregister dataset {name} only if its ETag is {etag}.
        slots:
          name: path.name
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a registered annotated dataset
      effect: write
      questions:
      - How do I change the annotation file URIs of a dataset I already registered?
      - Can I update custom properties on a registered dataset with an ETag check?
      instructions:
      - text: Update the annotation files of registered dataset {name} to {files}.
        slots:
          name: path.name
          files: requestBody.annotationFileUris
      - text: Update the custom properties of dataset {name} if ETag {etag} still matches.
        slots:
          name: path.name
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{datasetId}/access'].get
  update:
    x-apievangelist-phrasing:
      intent: List who has access to a dataset
      effect: read
      questions:
      - Which subscriptions or resources have been granted access to my dataset?
      - Can I filter a dataset's access list by resource ID?
      instructions:
      - text: List the resources authorized to access dataset {dataset}.
        slots:
          dataset: path.datasetId
      - text: Show access grants on dataset {dataset} for subscriptions {subs}.
        slots:
          dataset: path.datasetId
          subs: query.subscriptionIds
      - text: Check whether resources {resources} can access dataset {dataset}.
        slots:
          resources: query.resourceIds
          dataset: path.datasetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{datasetId}/access:grant'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant a resource access to a dataset
      effect: write
      questions:
      - How do I give another Azure resource access to my dataset?
      - Can I authorize a specific resource ID to read a dataset?
      instructions:
      - text: Grant resource {resource} access to dataset {dataset}.
        slots:
          resource: requestBody.resourceId
          dataset: path.datasetId
      - text: Authorize {resource} on dataset {dataset}.
        slots:
          resource: requestBody.resourceId
          dataset: path.datasetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datasets/{datasetId}/access:remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a resource's access to a dataset
      effect: destructive
      questions:
      - How do I take away a resource's access to my dataset?
      - Can I revoke a previously granted dataset access for one resource ID?
      instructions:
      - text: Revoke resource {resource}'s access to dataset {dataset}.
        slots:
          resource: requestBody.resourceId
          dataset: path.datasetId
      - text: Remove the access grant for {resource} from dataset {dataset}.
        slots:
          resource: requestBody.resourceId
          dataset: path.datasetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsDataProcessor/instances/{instanceName}/datasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List datasets in an IoT Operations data processor
      effect: read
      questions:
      - Which datasets are defined in my Azure IoT Operations data processor instance?
      - Can I enumerate all data processor datasets for one instance?
      instructions:
      - text: List datasets in data processor instance {instance}.
        slots:
          instance: path.instanceName
      - text: Show every dataset on IoT data processor {instance}.
        slots:
          instance: path.instanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsDataProcessor/instances/{instanceName}/datasets/{datasetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dataset in an IoT Operations data processor
      effect: read
      questions:
      - How can I see the settings of one dataset in my IoT Operations data processor?
      - Can I fetch a single data processor dataset by name?
      instructions:
      - text: Get dataset {datasetName} in IoT Operations data processor instance {instanceName}.
        slots:
          datasetName: path.datasetName
          instanceName: path.instanceName
      - text: Show the configuration of data processor dataset {datasetName} on {instanceName}.
        slots:
          datasetName: path.datasetName
          instanceName: path.instanceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsDataProcessor/instances/{instanceName}/datasets/{datasetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a dataset in an IoT Operations data processor
      effect: write
      questions:
      - How do I add a new dataset to an Azure IoT Operations data processor instance?
      - Does creating a data processor dataset require an extended location?
      instructions:
      - text: Create dataset {dataset} on data processor instance {instance}.
        slots:
          dataset: path.datasetName
          instance: path.instanceName
      - text: Create data processor dataset {dataset} on {instance} at extended location {location}.
        slots:
          dataset: path.datasetName
          instance: path.instanceName
          location: requestBody.extendedLocation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsDataProcessor/instances/{instanceName}/datasets/{datasetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dataset from an IoT Operations data processor
      effect: destructive
      questions:
      - Can I remove one dataset from my IoT Operations data processor instance?
      - How do I delete a data processor dataset I no longer use?
      instructions:
      - text: Delete dataset {datasetName} from IoT Operations data processor instance {instanceName}.
        slots:
          datasetName: path.datasetName
          instanceName: path.instanceName
      - text: Remove data processor dataset {datasetName} in group {resourceGroupName}.
        slots:
          datasetName: path.datasetName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsDataProcessor/instances/{instanceName}/datasets/{datasetName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an IoT Operations data processor dataset
      effect: write
      questions:
      - Can I retag an existing dataset in my IoT data processor?
      - What can I change on a data processor dataset after it is created?
      instructions:
      - text: Update tags on dataset {dataset} in data processor instance {instance}.
        slots:
          dataset: path.datasetName
          instance: path.instanceName
      - text: Set tags {tags} on data processor dataset {dataset} of instance {instance}.
        slots:
          tags: requestBody.tags
          dataset: path.datasetName
          instance: path.instanceName
      method: generated
      generated: '2026-09-26'