你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Bicep 资源定义
可以使用目标操作部署实验室/virtualnetworks 资源类型:
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.DevTestLab/labs/virtualnetworks 资源,请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
allowedSubnets: [
{
allowPublicIp: 'string'
labSubnetName: 'string'
resourceId: 'string'
}
]
description: 'string'
externalProviderResourceId: 'string'
subnetOverrides: [
{
labSubnetName: 'string'
resourceId: 'string'
sharedPublicIpAddressConfiguration: {
allowedPorts: [
{
backendPort: int
transportProtocol: 'string'
}
]
}
useInVmCreationPermission: 'string'
usePublicIpAddressPermission: 'string'
virtualNetworkPoolName: 'string'
}
]
}
tags: {
{customized property}: 'string'
}
}
属性值
Microsoft.DevTestLab/labs/virtualnetworks
| Name | Description | Value |
|---|---|---|
| 位置 | 资源的位置。 | 字符串 |
| name | 资源名称 | string (必需) |
| 父级 | 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。 有关详细信息,请参阅 父资源外部的子资源。 |
类型资源的符号名称:实验室 |
| properties | 资源的属性。 | VirtualNetworkProperties (必需) |
| tags | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
Port
| Name | Description | Value |
|---|---|---|
| backendPort | 目标虚拟机的后端端口。 | int |
| transportProtocol | 端口的协议类型。 | 'Tcp' 'Udp' |
ResourceTags
| Name | Description | Value |
|---|
Subnet
| Name | Description | Value |
|---|---|---|
| allowPublicIp | 允许公共 IP 地址(即允许、拒绝)的子网的权限策略。 | 'Allow' 'Default' 'Deny' |
| labSubnetName | 实验室中显示的子网名称。 | 字符串 |
| resourceId | 子网的资源 ID。 | 字符串 |
SubnetOverride
| Name | Description | Value |
|---|---|---|
| labSubnetName | 为实验室中的子网提供的名称。 | 字符串 |
| resourceId | 子网的资源 ID。 | 字符串 |
| sharedPublicIpAddressConfiguration | 此子网上的虚拟机将共享的属性。 | SubnetSharedPublicIpAddressConfiguration |
| useInVmCreationPermission | 指示是否可以在虚拟机创建期间使用此子网(即允许、拒绝)。 | 'Allow' 'Default' 'Deny' |
| usePublicIpAddressPermission | 指示是否可以将此子网上的公共 IP 地址分配给虚拟机(即允许、拒绝)。 | 'Allow' 'Default' 'Deny' |
| virtualNetworkPoolName | 与此子网关联的虚拟网络池。 | 字符串 |
SubnetSharedPublicIpAddressConfiguration
| Name | Description | Value |
|---|---|---|
| allowedPorts | 允许此子网上的虚拟机公开的后端端口 | Port[] |
VirtualNetworkProperties
| Name | Description | Value |
|---|---|---|
| allowedSubnets | 虚拟网络的允许子网。 | Subnet[] |
| description | 虚拟网络的说明。 | 字符串 |
| externalProviderResourceId | 虚拟网络的 Microsoft.Network 资源标识符。 | 字符串 |
| subnetOverrides | 虚拟网络的子网替代。 | SubnetOverride[] |
用法示例
Azure 快速入门示例
以下 Azure 快速入门模板 包含用于部署此资源类型的 Bicep 示例。
| Bicep 文件 | Description |
|---|---|
| 使用声明的 VM 在 Azure 开发测试实验室中创建实验室 | 此模板使用声明的 Windows Server 2019 Datacenter VM 创建一个新的开发测试实验室/DTL 实例。 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates 提供了适用于 Azure 开发测试实验室的更多 Azure 资源管理器快速入门模板 |
ARM 模板资源定义
可以使用目标操作部署实验室/virtualnetworks 资源类型:
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.DevTestLab/labs/virtualnetworks 资源,请将以下 JSON 添加到模板。
{
"type": "Microsoft.DevTestLab/labs/virtualnetworks",
"apiVersion": "2018-09-15",
"name": "string",
"location": "string",
"properties": {
"allowedSubnets": [
{
"allowPublicIp": "string",
"labSubnetName": "string",
"resourceId": "string"
}
],
"description": "string",
"externalProviderResourceId": "string",
"subnetOverrides": [
{
"labSubnetName": "string",
"resourceId": "string",
"sharedPublicIpAddressConfiguration": {
"allowedPorts": [
{
"backendPort": "int",
"transportProtocol": "string"
}
]
},
"useInVmCreationPermission": "string",
"usePublicIpAddressPermission": "string",
"virtualNetworkPoolName": "string"
}
]
},
"tags": {
"{customized property}": "string"
}
}
属性值
Microsoft.DevTestLab/labs/virtualnetworks
| Name | Description | Value |
|---|---|---|
| apiVersion | API 版本 | '2018-09-15' |
| 位置 | 资源的位置。 | 字符串 |
| name | 资源名称 | string (必需) |
| properties | 资源的属性。 | VirtualNetworkProperties (必需) |
| tags | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
| 类型 | 资源类型 | 'Microsoft.DevTestLab/labs/virtualnetworks' |
Port
| Name | Description | Value |
|---|---|---|
| backendPort | 目标虚拟机的后端端口。 | int |
| transportProtocol | 端口的协议类型。 | 'Tcp' 'Udp' |
ResourceTags
| Name | Description | Value |
|---|
Subnet
| Name | Description | Value |
|---|---|---|
| allowPublicIp | 允许公共 IP 地址(即允许、拒绝)的子网的权限策略。 | 'Allow' 'Default' 'Deny' |
| labSubnetName | 实验室中显示的子网名称。 | 字符串 |
| resourceId | 子网的资源 ID。 | 字符串 |
SubnetOverride
| Name | Description | Value |
|---|---|---|
| labSubnetName | 为实验室中的子网提供的名称。 | 字符串 |
| resourceId | 子网的资源 ID。 | 字符串 |
| sharedPublicIpAddressConfiguration | 此子网上的虚拟机将共享的属性。 | SubnetSharedPublicIpAddressConfiguration |
| useInVmCreationPermission | 指示是否可以在虚拟机创建期间使用此子网(即允许、拒绝)。 | 'Allow' 'Default' 'Deny' |
| usePublicIpAddressPermission | 指示是否可以将此子网上的公共 IP 地址分配给虚拟机(即允许、拒绝)。 | 'Allow' 'Default' 'Deny' |
| virtualNetworkPoolName | 与此子网关联的虚拟网络池。 | 字符串 |
SubnetSharedPublicIpAddressConfiguration
| Name | Description | Value |
|---|---|---|
| allowedPorts | 允许此子网上的虚拟机公开的后端端口 | Port[] |
VirtualNetworkProperties
| Name | Description | Value |
|---|---|---|
| allowedSubnets | 虚拟网络的允许子网。 | Subnet[] |
| description | 虚拟网络的说明。 | 字符串 |
| externalProviderResourceId | 虚拟网络的 Microsoft.Network 资源标识符。 | 字符串 |
| subnetOverrides | 虚拟网络的子网替代。 | SubnetOverride[] |
用法示例
Azure 快速入门模板
以下 Azure 快速入门模板 部署此资源类型。
| Template | Description |
|---|---|
|
使用声明的 VM 在 Azure 开发测试实验室中创建实验室 |
此模板使用声明的 Windows Server 2019 Datacenter VM 创建一个新的开发测试实验室/DTL 实例。 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates 提供了适用于 Azure 开发测试实验室的更多 Azure 资源管理器快速入门模板 |
Terraform (AzAPI 提供程序)资源定义
可以使用目标操作部署实验室/virtualnetworks 资源类型:
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.DevTestLab/labs/virtualnetworks 资源,请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
allowedSubnets = [
{
allowPublicIp = "string"
labSubnetName = "string"
resourceId = "string"
}
]
description = "string"
externalProviderResourceId = "string"
subnetOverrides = [
{
labSubnetName = "string"
resourceId = "string"
sharedPublicIpAddressConfiguration = {
allowedPorts = [
{
backendPort = int
transportProtocol = "string"
}
]
}
useInVmCreationPermission = "string"
usePublicIpAddressPermission = "string"
virtualNetworkPoolName = "string"
}
]
}
}
}
属性值
Microsoft.DevTestLab/labs/virtualnetworks
| Name | Description | Value |
|---|---|---|
| 位置 | 资源的位置。 | 字符串 |
| name | 资源名称 | string (必需) |
| parent_id | 此资源的父资源的 ID。 | 类型资源的 ID:实验室 |
| properties | 资源的属性。 | VirtualNetworkProperties (必需) |
| tags | 资源标记 | 标记名称和值的字典。 |
| 类型 | 资源类型 | "Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15" |
Port
| Name | Description | Value |
|---|---|---|
| backendPort | 目标虚拟机的后端端口。 | int |
| transportProtocol | 端口的协议类型。 | 'Tcp' 'Udp' |
ResourceTags
| Name | Description | Value |
|---|
Subnet
| Name | Description | Value |
|---|---|---|
| allowPublicIp | 允许公共 IP 地址(即允许、拒绝)的子网的权限策略。 | 'Allow' 'Default' 'Deny' |
| labSubnetName | 实验室中显示的子网名称。 | 字符串 |
| resourceId | 子网的资源 ID。 | 字符串 |
SubnetOverride
| Name | Description | Value |
|---|---|---|
| labSubnetName | 为实验室中的子网提供的名称。 | 字符串 |
| resourceId | 子网的资源 ID。 | 字符串 |
| sharedPublicIpAddressConfiguration | 此子网上的虚拟机将共享的属性。 | SubnetSharedPublicIpAddressConfiguration |
| useInVmCreationPermission | 指示是否可以在虚拟机创建期间使用此子网(即允许、拒绝)。 | 'Allow' 'Default' 'Deny' |
| usePublicIpAddressPermission | 指示是否可以将此子网上的公共 IP 地址分配给虚拟机(即允许、拒绝)。 | 'Allow' 'Default' 'Deny' |
| virtualNetworkPoolName | 与此子网关联的虚拟网络池。 | 字符串 |
SubnetSharedPublicIpAddressConfiguration
| Name | Description | Value |
|---|---|---|
| allowedPorts | 允许此子网上的虚拟机公开的后端端口 | Port[] |
VirtualNetworkProperties
| Name | Description | Value |
|---|---|---|
| allowedSubnets | 虚拟网络的允许子网。 | Subnet[] |
| description | 虚拟网络的说明。 | 字符串 |
| externalProviderResourceId | 虚拟网络的 Microsoft.Network 资源标识符。 | 字符串 |
| subnetOverrides | 虚拟网络的子网替代。 | SubnetOverride[] |
用法示例
Terraform 示例
在开发测试实验室中部署虚拟网络的基本示例。
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "lab" {
type = "Microsoft.DevTestLab/labs@2018-09-15"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
labStorageType = "Premium"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
data "azapi_resource_id" "virtualNetwork" {
type = "Microsoft.Network/virtualNetworks@2023-04-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
}
data "azapi_resource_id" "subnet" {
type = "Microsoft.Network/virtualNetworks/subnets@2023-04-01"
parent_id = data.azapi_resource_id.virtualNetwork.id
name = "${var.resource_name}Subnet"
}
resource "azapi_resource" "virtualNetwork" {
type = "Microsoft.DevTestLab/labs/virtualNetworks@2018-09-15"
parent_id = azapi_resource.lab.id
name = var.resource_name
body = {
properties = {
description = ""
subnetOverrides = [
{
labSubnetName = data.azapi_resource_id.subnet.name
resourceId = data.azapi_resource_id.subnet.id
useInVmCreationPermission = "Allow"
usePublicIpAddressPermission = "Allow"
},
]
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}