Azure DevTest Labs

Azure DevTest Labs Labs API

The Labs API from Azure DevTest Labs — 9 operation(s) for labs.

GitHub OpenAPI

Operations 12

GET /subscriptions/{subscriptionId}/providers/Microsoft.DevTestLab/labs Azure DevTest Labs Labs_ List by Subscription #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs Azure DevTest Labs Labs_ List by Resource Group #
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name} Azure DevTest Labs Labs_ Delete #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name} Azure DevTest Labs Labs_ Get #
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name} Azure DevTest Labs Labs_ Update #
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name} Azure DevTest Labs Labs_ Create or Update #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/claimAnyVm Azure DevTest Labs Labs_ Claim Any Vm #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/createEnvironment Azure DevTest Labs Labs_ Create Environment #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/exportResourceUsage Azure DevTest Labs Labs_ Export Resource Usage #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/generateUploadUri Azure DevTest Labs Labs_ Generate Upload Uri #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/importVirtualMachine Azure DevTest Labs Labs_ Import Virtual Machine #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/listVhds Azure DevTest Labs Labs_ List Vhds #

Documentation

📖
Documentation
https://docs.microsoft.com/en-us/azure/devtest-labs/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-test-labs/refs/heads/main/openapi/azure-test-labs-labs-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/azure-test-labs-labs-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-test-labs-labs-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: The DevTest Labs Client.
  title: DevTestLabsClient ArmTemplates Labs API
  version: '2.0'
  x-apisguru-categories:
  - cloud
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_assets.onestore.ms_cdnfiles_onestorerolling-1606-01000_shell_v3_images_logo_microsoft.png
  x-origin:
  - format: swagger
    url: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/specification/devtestlabs/resource-manager/Microsoft.DevTestLab/stable/2018-09-15/DTL.json
  x-preferred: true
  x-providerName: azure.com
  x-serviceName: devtestlabs-DTL
  x-tags:
  - Azure
  - Microsoft
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Labs
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.DevTestLab/labs:
    get:
      description: List labs in a subscription.
      operationId: Labs_ListBySubscription
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - description: 'Specify the $expand query. Example: ''properties($select=defaultStorageAccount)'''
        in: query
        name: $expand
        example: example-value
        schema:
          type: string
      - description: 'The filter to apply to the operation. Example: ''$filter=contains(name,''myName'')'
        in: query
        name: $filter
        example: example-value
        schema:
          type: string
      - description: 'The maximum number of resources to return from the operation. Example: ''$top=10'''
        in: query
        name: $top
        example: example-value
        schema:
          type: integer
          format: int32
      - description: 'The ordering expression for the results, using OData notation. Example: ''$orderby=name desc'''
        in: query
        name: $orderby
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LabList'
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_ListBySubscription:
          parameters:
            api-version: '2018-09-15'
            subscriptionId: '{subscription-id}'
          responses:
            '200':
              body:
                value:
                - id: /subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name-1}/providers/microsoft.devtestlab/labs/{lab-name-1}
                  location: westcentralus
                  name: '{lab-name-1}'
                  properties:
                    announcement:
                      enabled: Disabled
                      expired: false
                      markdown: ''
                      title: ''
                    artifactsStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-1}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-1}
                    createdDate: '2018-09-30T08:38:13.1973609-07:00'
                    defaultPremiumStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-1}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-1}
                    defaultStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-1}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-1}
                    environmentPermission: Reader
                    labStorageType: Premium
                    mandatoryArtifactsResourceIdsLinux: []
                    mandatoryArtifactsResourceIdsWindows: []
                    premiumDataDiskStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-1}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-1}
                    premiumDataDisks: Disabled
                    provisioningState: Succeeded
                    support:
                      enabled: Disabled
                      markdown: ''
                    uniqueIdentifier: '{unique-identifier}'
                    vaultName: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-1}/providers/Microsoft.KeyVault/vaults/{keyvault-name-1}
                  tags: {}
                  type: Microsoft.DevTestLab/labs
                - id: /subscriptions/{subscription-id}/resourcegroups/{resourcegroup-name-2}/providers/microsoft.devtestlab/labs/{lab-name-2}
                  location: japaneast
                  name: '{lab-name-2}'
                  properties:
                    announcement:
                      enabled: Disabled
                      expired: false
                      markdown: ''
                      title: ''
                    artifactsStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-2}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-2}
                    createdDate: '2018-09-30T09:37:52.9675083-07:00'
                    defaultPremiumStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-2}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-2}
                    defaultStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-2}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-2}
                    environmentPermission: Reader
                    labStorageType: Premium
                    mandatoryArtifactsResourceIdsLinux: []
                    mandatoryArtifactsResourceIdsWindows: []
                    premiumDataDiskStorageAccount: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-2}/providers/Microsoft.Storage/storageAccounts/{storageaccount-name-2}
                    premiumDataDisks: Disabled
                    provisioningState: Succeeded
                    support:
                      enabled: Disabled
                      markdown: ''
                    uniqueIdentifier: '{unique-identifier}'
                    vaultName: /subscriptions/{subscription-id}/resourceGroups/{resourcegroup-name-2}/providers/Microsoft.KeyVault/vaults/{keyvault-name-2}
                  tags: {}
                  type: Microsoft.DevTestLab/labs
      x-ms-odata: '#/definitions/Lab'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Azure DevTest Labs Labs_ List by Subscription
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs:
    get:
      description: List labs in a resource group.
      operationId: Labs_ListByResourceGroup
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: 'Specify the $expand query. Example: ''properties($select=defaultStorageAccount)'''
        in: query
        name: $expand
        example: example-value
        schema:
          type: string
      - description: 'The filter to apply to the operation. Example: ''$filter=contains(name,''myName'')'
        in: query
        name: $filter
        example: example-value
        schema:
          type: string
      - description: 'The maximum number of resources to return from the operation. Example: ''$top=10'''
        in: query
        name: $top
        example: example-value
        schema:
          type: integer
          format: int32
      - description: 'The ordering expression for the results, using OData notation. Example: ''$orderby=name desc'''
        in: query
        name: $orderby
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LabList'
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_ListByResourceGroup:
          parameters:
            api-version: '2018-09-15'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200':
              body:
                value:
                - id: /subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/microsoft.devtestlab/labs/{devtestlab-name}
                  location: '{azure-location}'
                  name: '{devtestlab-name}'
                  properties:
                    announcement:
                      enabled: Disabled
                      expired: false
                      markdown: ''
                      title: ''
                    createdDate: '2018-10-02T10:23:20.9573599-07:00'
                    environmentPermission: Reader
                    labStorageType: Standard
                    mandatoryArtifactsResourceIdsLinux: []
                    mandatoryArtifactsResourceIdsWindows: []
                    premiumDataDisks: Disabled
                    provisioningState: Succeeded
                    support:
                      enabled: Disabled
                      markdown: ''
                    uniqueIdentifier: '{unique-identifier}'
                    vaultName: /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/{keyvault-name}
                  tags:
                    MyTag: MyValue
                  type: Microsoft.DevTestLab/labs
      x-ms-odata: '#/definitions/Lab'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Azure DevTest Labs Labs_ List by Resource Group
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}:
    delete:
      description: Delete lab. This operation can take a while to complete.
      operationId: Labs_Delete
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        '204':
          description: No Content
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_Delete:
          parameters:
            api-version: '2018-09-15'
            name: '{devtestlab-name}'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200': {}
            '202': {}
            '204': {}
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Delete
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    get:
      description: Get lab.
      operationId: Labs_Get
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - description: 'Specify the $expand query. Example: ''properties($select=defaultStorageAccount)'''
        in: query
        name: $expand
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Lab'
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_Get:
          parameters:
            api-version: '2018-09-15'
            name: '{devtestlab-name}'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200':
              body:
                id: /subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/microsoft.devtestlab/labs/{devtestlab-name}
                location: '{azure-location}'
                name: '{devtestlab-name}'
                properties:
                  announcement:
                    enabled: Disabled
                    expired: false
                    markdown: ''
                    title: ''
                  artifactsStorageAccount: /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/{storageaccount-name}
                  createdDate: '2018-10-01T18:40:48.1739018-07:00'
                  defaultPremiumStorageAccount: /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/{storageaccount-name}
                  defaultStorageAccount: /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/{storageaccount-name}
                  environmentPermission: Reader
                  labStorageType: Standard
                  mandatoryArtifactsResourceIdsLinux: []
                  mandatoryArtifactsResourceIdsWindows: []
                  premiumDataDiskStorageAccount: /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/{storageaccount-name}
                  premiumDataDisks: Disabled
                  provisioningState: Succeeded
                  support:
                    enabled: Disabled
                    markdown: ''
                  uniqueIdentifier: '{unique-identifier}'
                  vaultName: /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/{keyvault-name}
                tags:
                  MyTag: MyValue
                type: Microsoft.DevTestLab/labs
      summary: Azure DevTest Labs Labs_ Get
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    patch:
      description: Allows modifying tags of labs. All other properties will be ignored.
      operationId: Labs_Update
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Lab'
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_Update:
          parameters:
            api-version: '2018-09-15'
            lab:
              properties:
                labStorageType: Premium
            name: '{devtestlab-name}'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200':
              body:
                id: /subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/microsoft.devtestlab/labs/{devtestlab-name}
                location: '{azure-location}'
                name: '{devtestlab-name}'
                properties:
                  announcement:
                    enabled: Disabled
                    expired: false
                    markdown: ''
                    title: ''
                  createdDate: '2018-10-01T18:40:48.1739018-07:00'
                  environmentPermission: Reader
                  labStorageType: Standard
                  mandatoryArtifactsResourceIdsLinux: []
                  mandatoryArtifactsResourceIdsWindows: []
                  premiumDataDisks: Disabled
                  provisioningState: Succeeded
                  support:
                    enabled: Disabled
                    markdown: ''
                  uniqueIdentifier: '{unique-identifier}'
                  vaultName: /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/{keyvault-name}
                tags:
                  MyTag: MyValue
                type: Microsoft.DevTestLab/labs
      summary: Azure DevTest Labs Labs_ Update
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LabFragment'
        description: A lab.
        required: true
    put:
      description: Create or replace an existing lab. This operation can take a while to complete.
      operationId: Labs_CreateOrUpdate
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Lab'
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Lab'
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_CreateOrUpdate:
          parameters:
            api-version: '2018-09-15'
            lab:
              location: '{azure-location}'
              properties:
                labStorageType: '{Standard|Premium}'
              tags:
                MyTag: MyValue
            name: '{devtestlab-name}'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200':
              body:
                id: /subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/microsoft.devtestlab/labs/{devtestlab-name}
                location: '{azure-location}'
                name: '{devtestlab-name}'
                properties:
                  announcement:
                    enabled: Disabled
                    expired: false
                    markdown: ''
                    title: ''
                  createdDate: '2018-10-01T18:40:48.1739018-07:00'
                  environmentPermission: Reader
                  labStorageType: Standard
                  mandatoryArtifactsResourceIdsLinux: []
                  mandatoryArtifactsResourceIdsWindows: []
                  premiumDataDisks: Disabled
                  provisioningState: Creating
                  support:
                    enabled: Disabled
                    markdown: ''
                  uniqueIdentifier: '{unique-identifier}'
                tags:
                  MyTag: MyValue
                type: Microsoft.DevTestLab/labs
            '201':
              body:
                id: /subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/microsoft.devtestlab/labs/{devtestlab-name}
                location: '{azure-location}'
                name: '{devtestlab-name}'
                properties:
                  announcement:
                    enabled: Disabled
                    expired: false
                    markdown: ''
                    title: ''
                  createdDate: '2018-10-01T18:40:48.1739018-07:00'
                  environmentPermission: Reader
                  labStorageType: Standard
                  mandatoryArtifactsResourceIdsLinux: []
                  mandatoryArtifactsResourceIdsWindows: []
                  premiumDataDisks: Disabled
                  provisioningState: Creating
                  support:
                    enabled: Disabled
                    markdown: ''
                  uniqueIdentifier: '{unique-identifier}'
                tags:
                  MyTag: MyValue
                type: Microsoft.DevTestLab/labs
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Create or Update
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Lab'
        description: A lab.
        required: true
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/claimAnyVm:
    post:
      description: Claim a random claimable virtual machine in the lab. This operation can take a while to complete.
      operationId: Labs_ClaimAnyVm
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_ClaimAnyVm:
          parameters:
            api-version: '2018-09-15'
            monitor: 'true'
            name: '{devtestlab-name}'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200': {}
            '202': {}
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Claim Any Vm
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/createEnvironment
  : post:
      description: Create virtual machines in a lab. This operation can take a while to complete.
      operationId: Labs_CreateEnvironment
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_CreateEnvironment:
          parameters:
            api-version: '2018-09-15'
            labVirtualMachineCreationParameter:
              location: '{azure-location}'
              name: '{virtualmachine-name}'
              properties:
                allowClaim: true
                disallowPublicIpAddress: true
                galleryImageReference:
                  offer: UbuntuServer
                  osType: Linux
                  publisher: Canonical
                  sku: 16.04-LTS
                  version: Latest
                labSubnetName: '{virtualnetwork-subnet-name}'
                labVirtualNetworkId: /subscriptions/{subscription-id}/resourcegroups/myResourceGroup/providers/microsoft.devtestlab/labs/{devtestlab-name}/virtualnetworks/{virtualnetwork-name}
                osType: Linux
                password: '{user-password}'
                size: Standard_A2_v2
                storageType: Standard
                userName: '{user-name}'
              tags:
                MyTag: MyValue
            name: '{devtestlab-name}'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200': {}
            '202': {}
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Create Environment
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LabVirtualMachineCreationParameter'
        description: Properties for creating a virtual machine.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/exportResourceUsage
  : post:
      description: Exports the lab resource usage into a storage account This operation can take a while to complete.
      operationId: Labs_ExportResourceUsage
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Export Resource Usage
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportResourceUsageParameters'
        description: The parameters of the export operation.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/generateUploadUri
  : post:
      description: Generate a URI for uploading custom disk images to a Lab.
      operationId: Labs_GenerateUploadUri
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerateUploadUriResponse'
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-examples:
        Labs_GenerateUploadUri:
          parameters:
            api-version: '2018-09-15'
            generateUploadUriParameter:
              blobName: '{blob-name}'
            name: '{devtestlab-name}'
            resourceGroupName: myResourceGroup
            subscriptionId: '{subscription-id}'
          responses:
            '200':
              body:
                uploadUri: https://{storage-name}.blob.core.windows.net/uploads/{blob-name}?sv=2017-04-17&sr=b&sig={signature}&st=2018-10-02T01:55:24Z&se=2018-10-03T02:10:23Z&sp=rcw
      summary: Azure DevTest Labs Labs_ Generate Upload Uri
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerateUploadUriParameter'
        description: Properties for generating an upload URI.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/importVirtualMachine
  : post:
      description: Import a virtual machine into a different lab. This operation can take a while to complete.
      operationId: Labs_ImportVirtualMachine
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Import Virtual Machine
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImportLabVirtualMachineRequest'
        description: This represents the payload required to import a virtual machine from a different lab into the current one
        required: true
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/listVhds:
    post:
      description: List disk images available for custom image creation.
      operationId: Labs_ListVhds
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        example: example-value
        schema:
          type: string
      - $ref: '#/components/parameters/api-version'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LabVhdList'
        default:
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      tags:
      - Labs
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Azure DevTest Labs Labs_ List Vhds
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    LabProperties:
      description: Properties of a lab.
      properties:
        announcement:
          $ref: '#/components/schemas/LabAnnouncementProperties'
          description: The properties of any lab announcement associated with this lab
        artifactsStorageAccount:
          description: The lab's artifact storage account.
          readOnly: true
          type: string
        createdDate:
          description: The creation date of the lab.
          format: date-time
          readOnly: true
          type: string
        defaultPremiumStorageAccount:
          description: The lab's default premium storage account.
          readOnly: true
          type: string
        defaultStorageAccount:
          description: The lab's default storage account.
          readOnly: true
          type: string
        environmentPermission:
          description: The access rights to be granted to the user when provisioning an environment
          enum:
          - Reader
          - Contributor
          type: string
          x-ms-enum:
            modelAsS

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