Azure / Azure/azure-rest-api-specs

DevTest Labs does not contain the latest Preview API (2018-10-15-preview) spec

Open
#22,026 5 comments 1 reaction 0 assignees View on GitHub
Devtestlab Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
6k
Avg merge
2d 22h
Merged PRs (30d)
444

Description

Looking at the content for [DevTest Lab](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/devtestlabs/resource-manager/Microsoft.DevTestLab). It is missing the latest Preview API `2018-10-15-preview` that includes a lot more features than the latest `2018-09-15` version. Example properties:

- Support for system assigned managed identities.
- Use existing storage account for the Lab Artifacts instead of the default.
- Encryption using Customer managed keys using the Disk Encryption set.
- Browser Connect via Azure Bastion.
- Specifying a custom resource group for VM Creation.
- Isolation of lab resources. This changes the Storage accounts and key vaults to 'Selected networks only'
- Disabling auto upgrade of custom script extension.

This causes the following warning when developing Bicep module for DTL:

```bicep
Warning BCP081: Resource type "Microsoft.DevTestLab/labs@2018-10-15-preview" does not have types available.
```

However, the latest API `2018-10-15-preview` is used when managing DTL from the Azure Portal and is referenced in the Resource Provider blade

![image](https://user-images.githubusercontent.com/28486158/210279985-4b4a86e7-8973-4067-aca0-6bce825b95f5.png)

Also, in Resource Explorer

![image](https://user-images.githubusercontent.com/28486158/210279945-95845644-b4b1-4f82-97e3-1290ff8529ce.png)

And when querying the RP via PowerShell:

![image](https://user-images.githubusercontent.com/28486158/210280011-ff9e9487-5346-430b-8304-8ecb225a0789.png)

In addition: Both [Template Documentation](https://learn.microsoft.com/en-us/azure/templates/microsoft.devtestlab/2018-09-15/labs?pivots=deployment-language-bicep) and the [API Documentation](https://learn.microsoft.com/en-us/rest/api/dtl/labs) are missing the latest API `2018-10-15-preview` and parameter usage guidance.

Contributor guide

Open the contributing guide

Research direction

Start in specification/devtestlabs/resource-manager/Microsoft.DevTestLab and compare the existing 2018-09-15 specification with the 2018-10-15-preview API described in the issue. Check the Azure Resource Explorer and Resource Provider references for the listed properties. Done means the preview API is represented and the related Bicep warning and documentation gaps are addressed.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, openapi
Domain
api
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.