Microsoft Azure Datasets API

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Datasets API
tags:
- name: Datasets
paths:
  /datasets:
    post:
      x-publish: true
      description: '**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).<br><br>Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.<br><br> This API allows the caller to create a dataset from data that was uploaded to the Azure Maps Data Service and converted using the Azure Maps Conversion Service.<br><br>You can use this API in a scenario like uploading a DWG zip package for a building, converting the zip package using the Azure Maps Conversion Service, and creating a dataset from the converted zip package. The created dataset can be used to create tilesets using the Azure Maps Tileset Service and can be queried via the Azure Maps WFS Service.<br><br>### Submit Create Request<br><br>To create your dataset, you will use a `POST` request where the `conversionId` query parameter is an ID that represents the converted DWG zip package, the `datasetId` parameter will be the ID of a previously created dataset to append with the current dataset and, optionally, the `description` query parameter will contain a description (if description is not provided a default description will be given).<br><br>The Create API is a [long-running operation](https://aka.ms/am-creator-lrt-v2).'
      operationId: microsoftAzureDatasetCreate
      x-ms-examples:
        Create dataset from a converted CAD file provided by conversionId:
          $ref: ./examples/Dataset_Create.json
      parameters:
      - $ref: '#/components/parameters/SubscriptionKey'
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/ConversionIdQuery'
      - $ref: '#/components/parameters/AppendDatasetId'
      - $ref: '#/components/parameters/DescriptionDataset'
      responses:
        '202':
          $ref: '#/components/responses/202Accepted'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
      summary: Microsoft Azure Post Datasets
      tags:
      - Datasets
    get:
      x-publish: true
      description: '**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).<br><br>Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.<br><br>This API allows the caller to fetch a list of all previously successfully created datasets.<br><br>### Submit List Request<br><br>To list all your datasets, you will issue a `GET` request with no additional parameters.<br><br><br>### List Data Response<br><br>The List API returns the complete list of all datasets in `json` format. The response contains the following fields (if they are not null or empty):<br>> created - The timestamp the dataset was created.<br>> datasetId - The id for the dataset.<br>> description - The description for the dataset.<br>> datasetSources - The source data that was used when the create request was issued.<br>> ontology - The source [ontology](https://docs.microsoft.com/en-us/azure/azure-maps/creator-facility-ontology) that was used in the conversion service for the input data.<br><br>The `datasetSources` describes the source data that was used when the create request was issued and contains the following elements (if they are not null or empty):<br><br>> conversionIds - The list of `conversionId` (null if none were provided).<br>> appendDatasetId - The `datasetId` that was used for an append operation (null if none was used).<br>>featureCounts - The counts for each feature type in the dataset.<br><br>Here''s a sample response returning the `timestamp`, `datasetId`, `description`, `datasetSources`, and `ontology` of 3 dataset resources:<br><br><br>```json<br>{<br>  "datasets": [<br>    {<br>      "timestamp": "2020-01-01T22:50:48.123Z",<br>      "datasetId": "f6495f62-94f8-0ec2-c252-45626f82fcb2",<br>      "description": "Some description or comment for the dataset.",<br>      "datasetSources": {<br>        "conversionIds": [<br>          "15d21452-c9bb-27b6-5e79-743ca5c3205d"<br>        ],      },<br>      "ontology": "facility-2.0",<br>      "featureCounts": {<br>        "directoryInfo": 2,<br>        "category": 10,<br>        "facility": 1,<br>        "level": 3,<br>        "unit": 183,<br>        "zone": 3,<br>        "verticalPenetration": 6,<br>        "opening": 48,<br>        "areaElement": 108<br>      }<br>    },<br>    {<br>      "timestamp": "2020-01-01T22:57:53.123Z",<br>      "datasetId": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",<br>      "description": "Create from upload ''0c1288fa-2058-4a1b-b68d-13a5f5af7d7c''.",<br>      "datasetSources": {<br>        "conversionIds": [<br>          "0c1288fa-2058-4a1b-b68d-13a5f5af7d7c"<br>        ],<br>        "appendDatasetId": "46d1edb6-d29e-4786-9589-dbd4efd7a977"<br>      },<br>      "ontology": "facility-2.0",<br>      "featureCounts": {<br>        "directoryInfo": 2,<br>        "category": 10,<br>        "facility": 1,<br>        "level": 3,<br>        "unit": 183,<br>        "zone": 3,<br>        "verticalPenetration": 6,<br>        "opening": 48,<br>        "areaElement": 108<br>      }<br>    }<br>  ]<br>}<br>```'
      operationId: microsoftAzureDatasetList
      x-ms-examples:
        List all the previously created datasets:
          $ref: ./examples/Dataset_List.json
      parameters:
      - $ref: '#/components/parameters/SubscriptionKey'
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: The dataset request completed successfully. The response body contains the previously created dataset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetListResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
      summary: Microsoft Azure Get Datasets
      tags:
      - Datasets
  /datasets/{datasetId}:
    get:
      x-publish: true
      description: '**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).<br><br>Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.<br><br>This API allows the caller to fetch a previously successfully created dataset.<br><br>### Submit Get Details Request<br><br>To get the details for a previously created dataset, you will issue a `GET` request with the `datasetId` in the path.<br><br>### Get Details Response<br><br>The Get Details API returns the details for a dataset in `json` format. The response contains the following fields (if they are not null or empty):<br>> created - The timestamp the dataset was created.<br>> datasetId - The id for the dataset.<br>> description - The description for the dataset.<br>> datasetSources - The source data that was used when the create request was issued.<br>> ontology - The source [ontology](https://docs.microsoft.com/en-us/azure/azure-maps/creator-facility-ontology) that was used in the conversion service for the input data.<br><br>The `datasetSources` describes the source data that was used when the create request was issued and contains the following elements (if they are not null or empty):<br>> conversionIds - The list of `conversionId` (null if none were provided).<br>> appendDatasetId - The `datasetId` that was used for an append operation (null if none was used).<br>>featureCounts - The counts for each feature type in the dataset.<br><br>Here''s a sample response returning the `timestamp`, `datasetId`, `description`, `datasetSources`, and `ontology` of a dataset resource:<br><br>```json<br>{<br>   "timestamp": "2020-01-01T22:50:48.123Z",<br>   "datasetId": "f6495f62-94f8-0ec2-c252-45626f82fcb2",<br>   "description": "Some description or comment for the dataset.",<br>   "datasetSources": {<br>     "conversionIds": [<br>       "15d21452-c9bb-27b6-5e79-743ca5c3205d"<br>     ],<br>   },<br>   "ontology": "facility-2.0",<br>   "featureCounts": {<br>     "directoryInfo": 2,<br>     "category": 10,<br>     "facility": 1,<br>     "level": 3,<br>     "unit": 183,<br>     "zone": 3,<br>     "verticalPenetration": 6,<br>     "opening": 48,<br>     "areaElement": 108<br>   }<br> }<br>```'
      operationId: microsoftAzureDatasetGet
      x-ms-examples:
        Get details for a previously created dataset:
          $ref: ./examples/Dataset_GetDetails.json
      parameters:
      - $ref: '#/components/parameters/DatasetId'
      - $ref: '#/components/parameters/SubscriptionKey'
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: The get dataset request completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetDetailInfo'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
      summary: Microsoft Azure Get Datasets Datasetid
      tags:
      - Datasets
    delete:
      x-publish: true
      description: '**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).<br><br>Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.<br><br>You can also use this API to delete old/unused datasets to create space for new Creator content.<br><br>### Submit Delete Request<br><br>To delete your content you will issue a `DELETE` request where the path will contain the `datasetId` of the dataset to delete.'
      operationId: microsoftAzureDatasetDelete
      x-ms-examples:
        Delete previously created dataset:
          $ref: ./examples/Dataset_Delete.json
      parameters:
      - $ref: '#/components/parameters/SubscriptionKey'
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/DatasetId'
      responses:
        '204':
          description: The dataset delete request completed successfully. The resource referenced by the `datasetId` was deleted from the server.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
      summary: Microsoft Azure Delete Datasets Datasetid
      tags:
      - Datasets
    patch:
      tags:
      - Datasets
      description: Creates or updates a dataset.
      operationId: microsoftAzureDatasetsCreateorupdate
      parameters:
      - in: path
        name: datasetId
        description: Id of the dataset resource.
        required: true
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset_2'
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset_2'
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-examples:
        Datasets_CreateOrUpdate:
          $ref: ./examples/Datasets_CreateOrUpdate.json
      summary: Microsoft Azure Patch Datasets Datasetid
      requestBody:
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/Dataset_2'
        description: Dataset resource payload to create or update.
        required: true
  /datasets/operations/{operationId}:
    get:
      description: This API allows the caller to view the current progress of a dataset operation and the path is obtained from a call to the Create API.<br><br>### Submit Operations Request<br><br>To view the current progress of a dataset operation, you will use a `GET` request where the `operationId` given the path is the ID that represents the operation.<br><br>### Operation Response<br><br>While in progress, a `200-OK` http status code will be returned with no extra headers. If the operation succeeds, a `200-OK` http status code with Resource-Location header will be returned.
      operationId: microsoftAzureDatasetGetoperation
      x-ms-examples:
        Get the status of an operation which is still running:
          $ref: ./examples/GetOperationStillRunning.json
        Get the status of an operation which has finished successfully:
          $ref: ./examples/GetOperation.json
      parameters:
      - $ref: '#/components/parameters/SubscriptionKey'
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/DatasetOperationId'
      responses:
        '200':
          $ref: '#/components/responses/200Async'
        '400':
          $ref: '#/components/responses/400'
      summary: Microsoft Azure Get Datasets Operations Operationid
      tags:
      - Datasets
  /datasets/{name}:
    put:
      tags:
      - Datasets
      summary: "Microsoft Azure Register A New Dataset \n      \nstatus Codes Returned:\n 201: Operation Completed Successfully \n 400: The Request Was Malformed \n 409: A Dataset With The Specified Name Already Exists"
      operationId: microsoftAzureDatasetsRegister
      parameters:
      - in: path
        name: name
        description: A name that can be used to uniquely identify the dataset after it has been registered.
        required: true
        schema:
          type: string
          maxLength: 255
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
      - $ref: '#/components/parameters/ApiVersion_2'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset'
        default:
          description: Error
          headers:
            x-ms-error-code:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        RegisterDataset_ImageClassification:
          $ref: ./examples/RegisterDataset_ImageClassification.json
      description: Needs a more full description created.
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/Dataset'
        description: Properties for the dataset, such as the list of URIs to the annotation files.
        required: true
    get:
      tags:
      - Datasets
      summary: "Microsoft Azure Get Information About A Specific Dataset \n      \nstatus Codes Returned:\n 200: Operation Completed Successfully \n 400: The Request Was Malformed \n 404: A Dataset With The Specified Name Was Not Found"
      operationId: microsoftAzureDatasetsGet
      parameters:
      - in: path
        name: name
        description: The name of the dataset to get.
        required: true
        schema:
          type: string
          maxLength: 255
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
      - $ref: '#/components/parameters/ApiVersion_2'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset'
        default:
          description: Error
          headers:
            x-ms-error-code:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Datasets_Get:
          $ref: ./examples/Datasets_Get.json
      description: Needs a more full description created.
    patch:
      tags:
      - Datasets
      summary: "Microsoft Azure Update The Properties Of An Existing Dataset \n      \nstatus Codes Returned:\n 200: Operation Completed Successfully \n 400: The Request Was Malformed \n 404: A Dataset With The Specified Name Was Not Found \n 412: An If Match Header Was Provided, But The Given Etag Did Not Match The Current Etag Value"
      operationId: microsoftAzureDatasetsUpdate
      parameters:
      - in: path
        name: name
        description: The name of the dataset to update.
        required: true
        schema:
          type: string
          maxLength: 255
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
      - in: header
        name: If-Match
        description: 'Optional ETag for the dataset to update.<br />

          If an ETag is provided, then the dataset will be updated only if its current ETag value matches the given ETag.

          If the ETag values don''t match, then the update operation will fail with status code 412 (Precondition Failed).

          This indicates that the dataset has been updated since the last time information for the dataset was obtained.<br />

          If an ETag is not provided or its value is ''*'', then the dataset will always be updated regardless of the current ETag value.'
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersion_2'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset'
        default:
          description: Error
          headers:
            x-ms-error-code:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Datasets_Update:
          $ref: ./examples/Datasets_Update.json
      description: Needs a more full description created.
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/Dataset'
        description: Properties to update on the existing dataset.
        required: true
    delete:
      tags:
      - Datasets
      summary: "Microsoft Azure Unregister A Dataset \n      \nstatus Codes Returned:\n 204: Operation Completed Successfully \n 400: The Request Was Malformed \n 404: A Dataset With The Specified Name Was Not Found \n 412: An If Match Header Was Provided, But The Given Etag Did Not Match The Current Etag Value"
      operationId: microsoftAzureDatasetsUnregister
      parameters:
      - in: path
        name: name
        description: The name of the dataset to unregister.
        required: true
        schema:
          type: string
          maxLength: 255
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
      - in: header
        name: If-Match
        description: 'Optional ETag for the dataset to unregister.<br />

          If an ETag is provided, then the dataset will be unregistered only if its current ETag value matches the given ETag.

          If the ETag values don''t match, then the unregister operation will fail with status code 412 (Precondition Failed).

          This indicates that the dataset has been updated since the last time information for the dataset was obtained.<br />

          If an ETag is not provided or its value is ''*'', then the dataset will always be unregistered regardless of the current ETag value.'
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersion_2'
      responses:
        '204':
          description: No Content
        default:
          description: Error
          headers:
            x-ms-error-code:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Datasets_Unregister:
          $ref: ./examples/Datasets_Unregister.json
      description: Needs a more full description created.
  /datasets/{datasetId}/access:
    get:
      tags:
      - Datasets
      description: Dataset access list.
      operationId: microsoftAzureDatasetsListauthorizedaccess
      parameters:
      - in: path
        name: datasetId
        description: Id of dataset to be accessed.
        required: true
        schema:
          type: string
      - in: query
        name: subscriptionIds
        description: Subscription Ids.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - in: query
        name: resourceIds
        description: Resource Ids.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - in: query
        name: maxPageSize
        description: 'Maximum number of items needed (inclusive).

          Minimum = 10, Maximum = 1000, Default value = 50.'
        schema:
          type: integer
          format: int32
          default: 50
          maximum: 1000
          minimum: 10
      - in: query
        name: skipToken
        description: Skip token for getting next set of results.
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetAccessListResponse'
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Datasets_ListAuthorizedAccess:
          $ref: ./examples/Datasets_ListAuthorizedAccess.json
      summary: Microsoft Azure Get Datasets Datasetid Access
  /datasets/{datasetId}/access:grant:
    post:
      tags:
      - Datasets
      description: Dataset access grant.
      operationId: microsoftAzureDatasetsAuthorizeaccess
      parameters:
      - in: path
        name: datasetId
        description: Id of dataset to be accessed.
        required: true
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetAccess'
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-examples:
        Datasets_AuthorizeAccess:
          $ref: ./examples/Datasets_AuthorizeAccess.json
      summary: Microsoft Azure Post Datasets Datasetid Access:grant
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DatasetAccess'
        description: Dataset access details.
        required: true
  /datasets/{datasetId}/access:remove:
    post:
      tags:
      - Datasets
      description: Dataset access remove.
      operationId: microsoftAzureDatasetsRemoveaccess
      parameters:
      - in: path
        name: datasetId
        description: Id of dataset to be accessed.
        required: true
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-examples:
        Datasets_RemoveAccess:
          $ref: ./examples/Datasets_RemoveAccess.json
      summary: Microsoft Azure Post Datasets Datasetid Access:remove
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DatasetAccess'
        description: Dataset access details.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsDataProcessor/instances/{instanceName}/datasets
  : get:
      operationId: microsoftAzureDatasetsListbyinstance
      tags:
      - Datasets
      description: List Dataset resources by Instance
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - name: instanceName
        in: path
        description: Name of instance.
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,60}[a-z0-9]$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Datasets_ListByInstance - generated by [MaximumSet] rule:
          $ref: ./examples/Datasets_ListByInstance_MaximumSet_Gen.json
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsdataprocessor Instances Instancename Datasets
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperationsDataProcessor/instances/{instanceName}/datasets/{datasetName}
  : get:
      operationId: microsoftAzureDatasetsGet
      tags:
      - Datasets
      description: Get a Dataset
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - name: instanceName
        in: path
        description: Name of instance.
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,60}[a-z0-9]$
      - name: datasetName
        in: path
        description: Name of dataset.
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,60}[a-z0-9]$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset_3'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Datasets_Get - generated by [MaximumSet] rule:
          $ref: ./examples/Datasets_Get_MaximumSet_Gen.json
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsdataprocessor Instances Instancename Datasets Datasetname
    put:
      operationId: microsoftAzureDatasetsCreateorupdate
      tags:
      - Datasets
      description: Create a Dataset
      parameters:
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter
      - name: instanceName
        in: path
        description: Name of instance.
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,60}[a-z0-9]$
      - name: datasetName
        in: path
        description: Name of dataset.
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,60}[a-z0-9]$
      responses:
        '200':
          description: Resource 'Dataset' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset_3'
        '201':
          description: Resource 'Dataset' create operation succeeded
          headers:
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset_3'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Datasets create or update - generated by [MaximumSet] rule:
          $ref: ./examples/Datasets_CreateOrUpdate_MaximumSet_Gen.json
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      x-ms-long-running-operation: true
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Iotoperationsdataprocessor Instances Instancename Datasets Datasetname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Dataset_3'
        description: Resource create parameters.
        required: true
    patch:
      operationId: microsoftAzureDatasetsUpdate
      tags:
      - Datasets
      description: Update a Dataset
      parameters:
      - $ref

# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/microsoft-azure-datasets-api-openapi.yml