快速入门：使用 Azure REST API 在 Azure 开发测试实验室中创建实验室

通过 Azure REST API 开始使用 Azure 开发测试实验室。 Azure 开发测试实验室包含一组资源，例如 Azure 虚拟机（VM）和网络。 通过此基础结构，可以通过指定限制和配额来更好地管理这些资源。 使用 Azure REST API 可以管理 Azure 平台中托管服务上的操作。

先决条件

• 拥有有效订阅的 Azure 帐户。 免费创建帐户。

• 已安装 PowerShell Az 模块 。 确保具有最新版本。 如有必要，请运行 Update-Module -Name Az。

准备请求正文

准备 请求正文 供 REST 调用使用。

将以下 JSON 语法复制并粘贴到名为 body.json 的文件中。 将文件保存在本地计算机或 Azure 存储帐户中。

{
  "properties": {
    "labStorageType": "Standard"
  },
  "location": "westus2",
  "tags": {
    "Env": "alpha"
  }
}

登录到 Azure 订阅

1. 为变量提供适当的值，然后执行脚本。

   $subscription = "subscriptionID"
   $resourceGroup = "resourceGroupName"
   $labName = "labName"
   $file = "path\body.json"
   

2. 在工作站上，使用 PowerShell Connect-AzAccount cmdlet 登录到 Azure 订阅，并按照屏幕上的说明进行作。

   # Sign in to your Azure subscription
   $sub = Get-AzSubscription -ErrorAction SilentlyContinue
   if(-not($sub))
   {
       Connect-AzAccount
   }
   
   # If you have multiple subscriptions, set the one to use
   # Set-AzContext -SubscriptionId $subscription
   

生成提交请求正文

PUT 请求的语法为：
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}?api-version=2018-09-15。

执行以下 PowerShell 脚本，将请求值传递给参数。 请求正文的内容也会传递给参数。

# build URI
$URI = "https://management.azure.com/subscriptions/$subscription/resourceGroups/$resourceGroup/providers/Microsoft.DevTestLab/labs/$labName`?api-version=2018-09-15"

# build body
$body = Get-Content $file

获取身份验证令牌

使用以下命令检索身份验证令牌：

$azContext = Get-AzContext
$azProfile = [Microsoft.Azure.Commands.Common.Authentication.Abstractions.AzureRmProfileProvider]::Instance.Profile
$profileClient = New-Object -TypeName Microsoft.Azure.Commands.ResourceManager.Common.RMProfileClient -ArgumentList ($azProfile)
$token = $profileClient.AcquireAccessToken($azContext.Subscription.TenantId)
$authHeader = @{
    'Content-Type'='application/json'
    'Authorization'='Bearer ' + $token.AccessToken
}

调用 REST API

使用以下命令调用 REST API 并查看响应。

# Invoke the REST API
$response = Invoke-RestMethod -Uri $URI -Method PUT -Headers $authHeader -Body $body

# Review output
$response | ConvertTo-Json

响应应类似于以下文本：

{
    "properties":  {
                       "labStorageType":  "Standard",
                       "mandatoryArtifactsResourceIdsLinux":  [

                                                              ],
                       "mandatoryArtifactsResourceIdsWindows":  [

                                                                ],
                       "createdDate":  "2021-10-27T20:22:49.7495913+00:00",
                       "premiumDataDisks":  "Disabled",
                       "environmentPermission":  "Reader",
                       "announcement":  {
                                            "title":  "",
                                            "markdown":  "",
                                            "enabled":  "Disabled",
                                            "expired":  false
                                        },
                       "support":  {
                                       "enabled":  "Disabled",
                                       "markdown":  ""
                                   },
                       "provisioningState":  "Creating",
                       "uniqueIdentifier":  "uniqueID"
                   },
    "id":  "/subscriptions/ContosoID/resourcegroups/groupcontoso/providers/microsoft.devtestlab/labs/myotherlab",

    "name":  "myOtherLab",
    "type":  "Microsoft.DevTestLab/labs",
    "location":  "westus2",
    "tags":  {
                 "Env":  "alpha"
             }
}

清理资源

如果不打算继续使用此实验室，请执行以下步骤将其删除：

1. 为变量提供适当的值，然后执行脚本。

   $subscription = "subscriptionID"
   $resourceGroup = "resourceGroupName"
   $labName = "labName"
   

2. 执行以下脚本，从 Azure 开发测试实验室中删除命名实验室。

   # build URI
   $URI = "https://management.azure.com/subscriptions/$subscription/resourceGroups/$resourceGroup/providers/Microsoft.DevTestLab/labs/$labName`?api-version=2018-09-15"
   
   # obtain access token
   $azContext = Get-AzContext
   $azProfile = [Microsoft.Azure.Commands.Common.Authentication.Abstractions.AzureRmProfileProvider]::Instance.Profile
   $profileClient = New-Object -TypeName Microsoft.Azure.Commands.ResourceManager.Common.RMProfileClient -ArgumentList ($azProfile)
   $token = $profileClient.AcquireAccessToken($azContext.Subscription.TenantId)
   $authHeader = @{
       'Content-Type'='application/json'
       'Authorization'='Bearer ' + $token.AccessToken
   }
   
   # Invoke the REST API
   Invoke-RestMethod -Uri $URI -Method DELETE -Headers $authHeader
   

后续步骤

在本快速入门中，你已使用 Azure REST API 创建了实验室。 若要了解如何访问实验室，请转到下一教程：