مختبرات Microsoft.DevTestLab/virtualnetworks

• Latest
• 2018-09-15
• 2016-05-15
• 2015-05-21-preview

تعريف مورد Bicep

يمكن نشر نوع مورد labs/virtualnetworks مع العمليات التي تستهدف:

• مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

أمثلة الاستخدام

عينات Bicep

مثال أساسي لنشر الشبكة الظاهرية داخل مختبر DevTest.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource lab 'Microsoft.DevTestLab/labs@2018-09-15' = {
  name: resourceName
  location: location
  properties: {
    labStorageType: 'Premium'
  }
}

resource virtualNetwork 'Microsoft.DevTestLab/labs/virtualNetworks@2018-09-15' = {
  name: resourceName
  parent: lab
  properties: {
    description: ''
    subnetOverrides: [
      {
        labSubnetName: '${resourceName}Subnet'
        resourceId: resourceId(
          'Microsoft.Network/virtualNetworks/subnets',
          resourceGroup().name,
          resourceName,
          '${resourceName}Subnet'
        )
        useInVmCreationPermission: 'Allow'
        usePublicIpAddressPermission: 'Allow'
      }
    ]
  }
}

نماذج Azure Quickstart

تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.

ملف Bicep	Description
إنشاء مختبر في Azure DevTest Labs باستخدام جهاز ظاهري	ينشئ هذا القالب مثيل DevTest Lab / DTL جديدا مع جهاز ظاهري لمركز بيانات Windows Server 2019 المطالب به. يتوفر المزيد من قوالب التشغيل السريع ل Azure Resource Manager لمختبرات Azure DevTest في https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates

تنسيق المورد

لإنشاء مورد 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
location	الموقع الجغرافي حيث يعيش المورد	string
name	اسم المورد	سلسلة (مطلوب)
parent	في Bicep، يمكنك تحديد المورد الأصل لمورد تابع. تحتاج فقط إلى إضافة هذه الخاصية عند الإعلان عن المورد التابع خارج المورد الأصل. لمزيد من المعلومات، راجع مورد تابع خارج المورد الأصل.	الاسم الرمزي للمورد من النوع: مختبرات
properties	خصائص المورد.	VirtualNetworkProperties (مطلوب)
tags	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

Port

Name	Description	Value
backendPort	منفذ الواجهة الخلفية للجهاز الظاهري الهدف.	int
transportProtocol	نوع البروتوكول للمنفذ.	'Tcp' 'Udp'

Subnet

Name	Description	Value
allowPublicIp	نهج الإذن للشبكة الفرعية للسماح بعناوين IP العامة (أي السماح، رفض)).	'Allow' 'Default' 'Deny'
labSubnetName	اسم الشبكة الفرعية كما رأينا في المختبر.	string
resourceId	معرف المورد للشبكة الفرعية.	string

SubnetOverride

Name	Description	Value
labSubnetName	الاسم المعطى للشبكة الفرعية داخل المختبر.	string
resourceId	معرف المورد للشبكة الفرعية.	string
sharedPublicIpAddressConfiguration	الخصائص التي ستشاركها الأجهزة الظاهرية على هذه الشبكة الفرعية.	SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission	يشير إلى ما إذا كان يمكن استخدام هذه الشبكة الفرعية أثناء إنشاء الجهاز الظاهري (أي السماح، رفض).	'Allow' 'Default' 'Deny'
usePublicIpAddressPermission	يشير إلى ما إذا كان يمكن تعيين عناوين IP العامة إلى الأجهزة الظاهرية على هذه الشبكة الفرعية (أي السماح، الرفض).	'Allow' 'Default' 'Deny'
virtualNetworkPoolName	تجمع الشبكة الظاهرية المقترن بهذه الشبكة الفرعية.	string

SubnetSharedPublicIpAddressConfiguration

Name	Description	Value
allowedPorts	منافذ الواجهة الخلفية التي يسمح للأجهزة الظاهرية على هذه الشبكة الفرعية بعرضها	Port[]

VirtualNetworkProperties

Name	Description	Value
allowedSubnets	الشبكات الفرعية المسموح بها للشبكة الظاهرية.	Subnet[]
description	وصف الشبكة الظاهرية.	string
externalProviderResourceId	معرف مورد Microsoft.Network للشبكة الظاهرية.	string
subnetOverrides	تتجاوز الشبكة الفرعية الشبكة الظاهرية.	SubnetOverride[]

علامات تعريف الشبكة الظاهرية

Name	Description	Value

تعريف مورد قالب ARM

يمكن نشر نوع مورد labs/virtualnetworks مع العمليات التي تستهدف:

• مجموعات الموارد - راجع أوامر نشر مجموعة الموارد لقائمة الخصائص المتغيرة في كل إصدار من واجهة برمجة التطبيقات، راجع سجل التغيير.

أمثلة الاستخدام

قوالب Azure Quickstart

قوالب Azure Quickstart التالية توزيع نوع المورد هذا.

Template	Description
إنشاء مختبر في Azure DevTest Labs باستخدام جهاز ظاهري	ينشئ هذا القالب مثيل DevTest Lab / DTL جديدا مع جهاز ظاهري لمركز بيانات Windows Server 2019 المطالب به. يتوفر المزيد من قوالب التشغيل السريع ل Azure Resource Manager لمختبرات Azure DevTest في https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates

تنسيق المورد

لإنشاء مورد 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	إصدار واجهة برمجة التطبيقات	'2018-09-15'
location	الموقع الجغرافي حيث يعيش المورد	string
name	اسم المورد	سلسلة (مطلوب)
properties	خصائص المورد.	VirtualNetworkProperties (مطلوب)
tags	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
type	نوع المورد	'Microsoft.DevTestLab/labs/virtualnetworks'

Port

Name	Description	Value
backendPort	منفذ الواجهة الخلفية للجهاز الظاهري الهدف.	int
transportProtocol	نوع البروتوكول للمنفذ.	'Tcp' 'Udp'

Subnet

Name	Description	Value
allowPublicIp	نهج الإذن للشبكة الفرعية للسماح بعناوين IP العامة (أي السماح، رفض)).	'Allow' 'Default' 'Deny'
labSubnetName	اسم الشبكة الفرعية كما رأينا في المختبر.	string
resourceId	معرف المورد للشبكة الفرعية.	string

SubnetOverride

Name	Description	Value
labSubnetName	الاسم المعطى للشبكة الفرعية داخل المختبر.	string
resourceId	معرف المورد للشبكة الفرعية.	string
sharedPublicIpAddressConfiguration	الخصائص التي ستشاركها الأجهزة الظاهرية على هذه الشبكة الفرعية.	SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission	يشير إلى ما إذا كان يمكن استخدام هذه الشبكة الفرعية أثناء إنشاء الجهاز الظاهري (أي السماح، رفض).	'Allow' 'Default' 'Deny'
usePublicIpAddressPermission	يشير إلى ما إذا كان يمكن تعيين عناوين IP العامة إلى الأجهزة الظاهرية على هذه الشبكة الفرعية (أي السماح، الرفض).	'Allow' 'Default' 'Deny'
virtualNetworkPoolName	تجمع الشبكة الظاهرية المقترن بهذه الشبكة الفرعية.	string

SubnetSharedPublicIpAddressConfiguration

Name	Description	Value
allowedPorts	منافذ الواجهة الخلفية التي يسمح للأجهزة الظاهرية على هذه الشبكة الفرعية بعرضها	Port[]

VirtualNetworkProperties

Name	Description	Value
allowedSubnets	الشبكات الفرعية المسموح بها للشبكة الظاهرية.	Subnet[]
description	وصف الشبكة الظاهرية.	string
externalProviderResourceId	معرف مورد Microsoft.Network للشبكة الظاهرية.	string
subnetOverrides	تتجاوز الشبكة الفرعية الشبكة الظاهرية.	SubnetOverride[]

علامات تعريف الشبكة الظاهرية

Name	Description	Value

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد labs/virtualnetworks مع العمليات التي تستهدف:

• مجموعات الموارد للحصول على قائمة بالخصائص المتغيرة في كل إصدار من واجهة برمجة التطبيقات، انظر سجل التغيير.

أمثلة الاستخدام

عينات Terraform

مثال أساسي لنشر الشبكة الظاهرية داخل مختبر DevTest.

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    = ["*"]
}

تنسيق المورد

لإنشاء مورد 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
location	الموقع الجغرافي حيث يعيش المورد	string
name	اسم المورد	سلسلة (مطلوب)
parent_id	معرف المورد الأصل لهذا المورد.	معرف المورد من النوع: مختبرات
properties	خصائص المورد.	VirtualNetworkProperties (مطلوب)
tags	علامات الموارد	قاموس أسماء العلامات والقيم.
type	نوع المورد	"Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15"

Port

Name	Description	Value
backendPort	منفذ الواجهة الخلفية للجهاز الظاهري الهدف.	int
transportProtocol	نوع البروتوكول للمنفذ.	'Tcp' 'Udp'

Subnet

Name	Description	Value
allowPublicIp	نهج الإذن للشبكة الفرعية للسماح بعناوين IP العامة (أي السماح، رفض)).	'Allow' 'Default' 'Deny'
labSubnetName	اسم الشبكة الفرعية كما رأينا في المختبر.	string
resourceId	معرف المورد للشبكة الفرعية.	string

SubnetOverride

Name	Description	Value
labSubnetName	الاسم المعطى للشبكة الفرعية داخل المختبر.	string
resourceId	معرف المورد للشبكة الفرعية.	string
sharedPublicIpAddressConfiguration	الخصائص التي ستشاركها الأجهزة الظاهرية على هذه الشبكة الفرعية.	SubnetSharedPublicIpAddressConfiguration
useInVmCreationPermission	يشير إلى ما إذا كان يمكن استخدام هذه الشبكة الفرعية أثناء إنشاء الجهاز الظاهري (أي السماح، رفض).	'Allow' 'Default' 'Deny'
usePublicIpAddressPermission	يشير إلى ما إذا كان يمكن تعيين عناوين IP العامة إلى الأجهزة الظاهرية على هذه الشبكة الفرعية (أي السماح، الرفض).	'Allow' 'Default' 'Deny'
virtualNetworkPoolName	تجمع الشبكة الظاهرية المقترن بهذه الشبكة الفرعية.	string

SubnetSharedPublicIpAddressConfiguration

Name	Description	Value
allowedPorts	منافذ الواجهة الخلفية التي يسمح للأجهزة الظاهرية على هذه الشبكة الفرعية بعرضها	Port[]

VirtualNetworkProperties

Name	Description	Value
allowedSubnets	الشبكات الفرعية المسموح بها للشبكة الظاهرية.	Subnet[]
description	وصف الشبكة الظاهرية.	string
externalProviderResourceId	معرف مورد Microsoft.Network للشبكة الظاهرية.	string
subnetOverrides	تتجاوز الشبكة الفرعية الشبكة الظاهرية.	SubnetOverride[]

علامات تعريف الشبكة الظاهرية

Name	Description	Value