Azure DevTest Labs Labs API

swagger: '2.0'
info:
  description: The DevTest Labs Client.
  title: DevTestLabsClient ArmTemplates Labs API
  version: '2018-09-15'
  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
    version: '2.0'
  x-preferred: true
  x-providerName: azure.com
  x-serviceName: devtestlabs-DTL
  x-tags:
  - Azure
  - Microsoft
host: management.azure.com
schemes:
- https
consumes:
- application/json
produces:
- application/json
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: '#/parameters/subscriptionId'
      - description: 'Specify the $expand query. Example: ''properties($select=defaultStorageAccount)'''
        in: query
        name: $expand
        type: string
        example: example-value
      - description: 'The filter to apply to the operation. Example: ''$filter=contains(name,''myName'')'
        in: query
        name: $filter
        type: string
        example: example-value
      - description: 'The maximum number of resources to return from the operation. Example: ''$top=10'''
        format: int32
        in: query
        name: $top
        type: integer
        example: example-value
      - description: 'The ordering expression for the results, using OData notation. Example: ''$orderby=name desc'''
        in: query
        name: $orderby
        type: string
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/LabList'
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: 'Specify the $expand query. Example: ''properties($select=defaultStorageAccount)'''
        in: query
        name: $expand
        type: string
        example: example-value
      - description: 'The filter to apply to the operation. Example: ''$filter=contains(name,''myName'')'
        in: query
        name: $filter
        type: string
        example: example-value
      - description: 'The maximum number of resources to return from the operation. Example: ''$top=10'''
        format: int32
        in: query
        name: $top
        type: integer
        example: example-value
      - description: 'The ordering expression for the results, using OData notation. Example: ''$orderby=name desc'''
        in: query
        name: $orderby
        type: string
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/LabList'
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        '204':
          description: No Content
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - description: 'Specify the $expand query. Example: ''properties($select=defaultStorageAccount)'''
        in: query
        name: $expand
        type: string
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Lab'
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - description: A lab.
        in: body
        name: lab
        required: true
        schema:
          $ref: '#/definitions/LabFragment'
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Lab'
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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
    put:
      description: Create or replace an existing lab. This operation can take a while to complete.
      operationId: Labs_CreateOrUpdate
      parameters:
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - description: A lab.
        in: body
        name: lab
        required: true
        schema:
          $ref: '#/definitions/Lab'
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Lab'
        '201':
          description: Created
          schema:
            $ref: '#/definitions/Lab'
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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
  /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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - description: Properties for creating a virtual machine.
        in: body
        name: labVirtualMachineCreationParameter
        required: true
        schema:
          $ref: '#/definitions/LabVirtualMachineCreationParameter'
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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
  ? /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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - description: The parameters of the export operation.
        in: body
        name: exportResourceUsageParameters
        required: true
        schema:
          $ref: '#/definitions/ExportResourceUsageParameters'
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/CloudError'
      tags:
      - Labs
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Export Resource Usage
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - description: Properties for generating an upload URI.
        in: body
        name: generateUploadUriParameter
        required: true
        schema:
          $ref: '#/definitions/GenerateUploadUriParameter'
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/GenerateUploadUriResponse'
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/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
  ? /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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - description: This represents the payload required to import a virtual machine from a different lab into the current one
        in: body
        name: importLabVirtualMachineRequest
        required: true
        schema:
          $ref: '#/definitions/ImportLabVirtualMachineRequest'
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
        '202':
          description: Accepted
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/CloudError'
      tags:
      - Labs
      x-ms-long-running-operation: true
      summary: Azure DevTest Labs Labs_ Import Virtual Machine
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /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: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - description: The name of the lab.
        in: path
        name: name
        required: true
        type: string
        example: example-value
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/LabVhdList'
        default:
          description: BadRequest
          schema:
            $ref: '#/definitions/CloudError'
      tags:
      - Labs
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Azure DevTest Labs Labs_ List Vhds
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
definitions:
  LabProperties:
    description: Properties of a lab.
    properties:
      announcement:
        $ref: '#/definitions/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:
          modelAsString: true
          name: EnvironmentPermission
      extendedProperties:
        additionalProperties:
          type: string
        description: Extended properties of the lab used for experimental features
        type: object
      labStorageType:
        description: Type of storage used by the lab. It can be either Premium or Standard. Default is Premium.
        enum:
        - Standard
        - Premium
        - StandardSSD
        type: string
        x-ms-enum:
          modelAsString: true
          name: StorageType
      loadBalancerId:
        description: The load balancer used to for lab VMs that use shared IP address.
        readOnly: true
        type: string
      mandatoryArtifactsResourceIdsLinux:
        description: The ordered list of artifact resource IDs that should be applied on all Linux VM creations by default, prior to the artifacts specified by the user.
        items:
          type: string
        type: array
      mandatoryArtifactsResourceIdsWindows:
        description: The ordered list of artifact resource IDs that should be applied on all Windows VM creations by default, prior to the artifacts specified by the user.
        items:
          type: string
        type: array
      networkSecurityGroupId:
        description: The Network Security Group attached to the lab VMs Network interfaces to restrict open ports.
        readOnly: true
        type: string
      premiumDataDiskStorageAccount:
        description: The lab's premium data disk storage account.
        readOnly: true
        type: string
      premiumDataDisks:
        description: "The setting to enable usage of premium data disks.\r\nWhen its value is 'Enabled', creation of standard or premium data disks is allowed.\r\nWhen its value is 'Disabled', only creation of standard data disks is allowed."
        enum:
        - Disabled
        - Enabled
        type: string
        x-ms-enum:
          modelAsString: true
          name: Pre

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