Microsoft.DevTestLab labs/virtualmachines.
Определение ресурса Bicep
Тип ресурса labs/virtualmachines можно развернуть с помощью операций, предназначенных для:
- Группы ресурсов — см. команды развертывания групп ресурсов.
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.DevTestLab/labs/virtualmachines, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
allowClaim: bool
artifacts: [
{
artifactId: 'string'
artifactTitle: 'string'
deploymentStatusMessage: 'string'
installTime: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
status: 'string'
vmExtensionStatusMessage: 'string'
}
]
createdDate: 'string'
customImageId: 'string'
dataDiskParameters: [
{
attachNewDataDiskOptions: {
diskName: 'string'
diskSizeGiB: int
diskType: 'string'
}
existingLabDiskId: 'string'
hostCaching: 'string'
}
]
disallowPublicIpAddress: bool
environmentId: 'string'
expirationDate: 'string'
galleryImageReference: {
offer: 'string'
osType: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
isAuthenticationWithSshKey: bool
labSubnetName: 'string'
labVirtualNetworkId: 'string'
networkInterface: {
dnsName: 'string'
privateIpAddress: 'string'
publicIpAddress: 'string'
publicIpAddressId: 'string'
rdpAuthority: 'string'
sharedPublicIpAddressConfiguration: {
inboundNatRules: [
{
backendPort: int
frontendPort: int
transportProtocol: 'string'
}
]
}
sshAuthority: 'string'
subnetId: 'string'
virtualNetworkId: 'string'
}
notes: 'string'
ownerObjectId: 'string'
ownerUserPrincipalName: 'string'
password: 'string'
planId: 'string'
scheduleParameters: [
{
name: 'string'
properties: {
dailyRecurrence: {
time: 'string'
}
hourlyRecurrence: {
minute: int
}
notificationSettings: {
emailRecipient: 'string'
notificationLocale: 'string'
status: 'string'
timeInMinutes: int
webhookUrl: 'string'
}
status: 'string'
targetResourceId: 'string'
taskType: 'string'
weeklyRecurrence: {
time: 'string'
weekdays: [
'string'
]
}
}
tags: {}
}
]
size: 'string'
sshKey: 'string'
storageType: 'string'
userName: 'string'
}
}
Значения свойств
labs/virtualmachines
Имя | Описание | Значение |
---|---|---|
name | имя ресурса. Узнайте, как задать имена и типы для дочерних ресурсов в Bicep. |
string (обязательно) Ограничение символов: 1–15 (Windows) 1–64 (Linux) Допустимые символы: Буквенно-цифровые символы и дефисы. Начинается и закачивается буквенно-цифровым символом. Не может содержать только цифры. |
location | Расположение ресурса. | строка |
tags | Теги ресурса. | Словарь имен и значений тегов. См . раздел Теги в шаблонах |
родитель | В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить только в том случае, если дочерний ресурс объявлен за пределами родительского ресурса. Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса. |
Символьное имя ресурса типа: labs |
properties | Свойства ресурса. | LabVirtualMachineProperties (обязательно) |
LabVirtualMachineProperties
Имя | Описание | Значение |
---|---|---|
allowClaim | Указывает, может ли другой пользователь стать владельцем виртуальной машины. | bool |
артефакты | Артефакты, устанавливаемые на виртуальной машине. | ArtifactInstallProperties[] |
createdDate | Дата создания виртуальной машины. | строка |
customImageId | Идентификатор пользовательского образа виртуальной машины. | строка |
dataDiskParameters | Новые или существующие диски данных для подключения к виртуальной машине после создания | DataDiskProperties[] |
disallowPublicIpAddress | Указывает, будет ли виртуальная машина создана без общедоступного IP-адреса. | bool |
environmentId | Идентификатор ресурса среды, содержащей эту виртуальную машину, если таковой есть. | строка |
expirationDate | Дата окончания срока действия виртуальной машины. | строка |
galleryImageReference | Ссылка на образ виртуальной машины microsoft Azure Marketplace. | GalleryImageReference |
isAuthenticationWithSshKey | Указывает, использует ли эта виртуальная машина ключ SSH для проверки подлинности. | bool |
labSubnetName | Имя подсети лаборатории виртуальной машины. | строка |
labVirtualNetworkId | Идентификатор виртуальной сети лаборатории виртуальной машины. | строка |
networkInterface. | Свойства сетевого интерфейса. | Свойства NetworkInterfaceProperties |
HDInsight | Заметки виртуальной машины. | строка |
ownerObjectId | Идентификатор объекта владельца виртуальной машины. | строка |
ownerUserPrincipalName | Имя участника-пользователя владельца виртуальной машины. | строка |
password | Пароль администратора виртуальной машины. | строка |
planId | Идентификатор плана, связанного с образом виртуальной машины. | строка |
scheduleParameters | Создаваемые расписания виртуальных машин | ScheduleCreationParameter[] |
size | Размер виртуальной машины. | строка |
sshKey | Ключ SSH администратора виртуальной машины. | строка |
storageType | Тип хранилища, используемого для виртуальной машины (например, "Стандартный", "Премиум"). | строка |
userName | Имя пользователя виртуальной машины. | строка |
ArtifactInstallProperties
Имя | Описание | Значение |
---|---|---|
artifactId | Идентификатор артефакта. | строка |
artifactTitle | Заголовок артефакта. | строка |
deploymentStatusMessage | Сообщение о состоянии из развертывания. | строка |
installTime | Время начала установки артефакта на виртуальной машине. | строка |
параметры | Параметры артефакта. | ArtifactParameterProperties[] |
status | Состояние артефакта. | строка |
vmExtensionStatusMessage | Сообщение о состоянии из расширения виртуальной машины. | строка |
Свойства ArtifactParameterProperties
Имя | Описание | Значение |
---|---|---|
name | Имя параметра артефакта. | строка |
value | Значение параметра артефакта. | строка |
DataDiskProperties
Имя | Описание | Значение |
---|---|---|
attachNewDataDiskOptions | Задает параметры для подключения нового диска к виртуальной машине. | AttachNewDataDiskOptions |
existingLabDiskId | Указывает существующий идентификатор диска лаборатории для подключения к виртуальной машине. | строка |
HostCaching | Параметр кэширования для диска данных (т. е. None, ReadOnly, ReadWrite). | "Нет" ReadOnly ReadWrite |
AttachNewDataDiskOptions
Имя | Описание | Значение |
---|---|---|
имя_диска | Имя подключаемого диска. | строка |
diskSizeGib | Размер подключаемого диска в гибибайтах. | INT |
diskType | Тип хранилища для диска (например, "Стандартный", "Премиум"). | "Премиум" "Стандартный" 'StandardSSD' |
GalleryImageReference
Имя | Описание | Значение |
---|---|---|
offer | Предложение изображения из коллекции. | строка |
osType | Тип ОС образа коллекции. | строка |
publisher | Издатель образа коллекции. | строка |
sku | Номер SKU образа коллекции. | строка |
version | Версия образа коллекции. | строка |
Свойства NetworkInterfaceProperties
Имя | Описание | Значение |
---|---|---|
dnsName | DNS-имя. | строка |
privateIpAddress | Частный IP-адрес. | строка |
publicIpAddress | Общедоступный IP-адрес. | строка |
publicIpAddressId | Идентификатор ресурса общедоступного IP-адреса. | строка |
rdpAuthority | Свойство RdpAuthority — это имя узла DNS сервера или IP-адрес, за которым следует номер порта службы для протокола удаленного рабочего стола (RDP). | строка |
sharedPublicIpAddressConfiguration | Конфигурация совместного использования общедоступного IP-адреса на нескольких виртуальных машинах. | SharedPublicIpAddressConfiguration |
sshAuthority | Свойство SshAuthority — это имя узла DNS сервера или IP-адрес, за которым следует номер порта службы для SSH. | строка |
subnetId | Идентификатор ресурса дочерней сети. | строка |
virtualNetworkId | Идентификатор ресурса виртуальной сети. | строка |
SharedPublicIpAddressConfiguration
Имя | Описание | Значение |
---|---|---|
inboundNatRules | Входящие правила NAT | InboundNatRule[] |
InboundNatRule
Имя | Описание | Значение |
---|---|---|
backendPort | Порт, на который будет перенаправляться внешний трафик. | INT |
frontendPort | Порт внешней конечной точки входящего подключения. Возможный диапазон значений — от 1 до 65 535 включительно. Если значение не указано, значение будет выделено автоматически. | INT |
transportProtocol | Транспортный протокол для конечной точки. | "Tcp" 'Udp' |
ScheduleCreationParameter
Имя | Описание | Значение |
---|---|---|
name | Имя виртуальной машины или среды | строка |
properties | Свойства расписания. | Свойства ScheduleCreationParameterProperties |
tags | Теги ресурса. | object |
Свойства ScheduleCreationParameterProperties
Имя | Описание | Значение |
---|---|---|
dailyRecurrence | Если расписание будет выполняться один раз в день недели, укажите ежедневное повторение. | DayDetails |
hourlyRecurrence | Если расписание будет выполняться несколько раз в день, укажите ежечасное повторение. | HourDetails |
notificationSettings | Параметры уведомлений. | NotificationSettings |
status | Состояние расписания (т. е. "Включено", "Отключено") | "Отключено" "Включено" |
targetResourceId | Идентификатор ресурса, которому принадлежит расписание | строка |
taskType | Тип задачи расписания (например, LabVmsShutdownTask, LabVmAutoStart). | строка |
weeklyRecurrence | Если расписание будет выполняться только в некоторые дни недели, укажите еженедельное повторение. | WeekDetails |
DayDetails
Имя | Описание | Значение |
---|---|---|
time | Время суток, когда расписание будет выполняться. | строка |
HourDetails
Имя | Описание | Значение |
---|---|---|
minute | Минуты часа, на который будет выполняться расписание. | INT |
NotificationSettings
Имя | Описание | Значение |
---|---|---|
emailRecipient | Получатель электронной почты для отправки уведомлений (может быть списком адресов электронной почты, разделенных точкой с запятой). | строка |
notificationLocale | Языковой стандарт, используемый при отправке уведомления (резервный вариант для неподдерживаемых языков — EN). | строка |
status | Если для этого расписания включены уведомления (т. е. включено, отключено). | "Отключено" "Включено" |
timeInMinutes | Время в минутах до события, при котором будет отправлено уведомление. | INT |
webhookUrl | URL-адрес веб-перехватчика, на который будет отправлено уведомление. | строка |
WeekDetails
Имя | Описание | Значение |
---|---|---|
time | Время суток, когда будет выполняться расписание. | строка |
Будние дни | Дни недели, для которых задано расписание (например, воскресенье, понедельник, вторник и т. д.). | string[] |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
Шаблон | Описание |
---|---|
Создание лаборатории в Azure DevTest Labs с виртуальной машиной Windows Server |
Этот шаблон создает новый экземпляр DevTest Lab/DTL с виртуальной машиной Windows Server 2019 Datacenter. Дополнительные шаблоны быстрого запуска Azure Resource Manager для Azure DevTest Labs доступны на страницеhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Создает лабораторию в Azure DevTest Labs с запрошенной виртуальной машиной |
Этот шаблон создает новый экземпляр DevTest Lab/DTL с запрошенной виртуальной машиной Windows Server 2019 Datacenter. Дополнительные шаблоны быстрого запуска Azure Resource Manager для Azure DevTest Labs доступны на страницеhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Определение ресурса шаблона ARM
Тип ресурса labs/virtualmachines можно развернуть с помощью операций, предназначенных для:
- Группы ресурсов — см. команды развертывания группы ресурсов.
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.DevTestLab/labs/virtualmachines, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.DevTestLab/labs/virtualmachines",
"apiVersion": "2018-09-15",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"allowClaim": "bool",
"artifacts": [
{
"artifactId": "string",
"artifactTitle": "string",
"deploymentStatusMessage": "string",
"installTime": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
],
"status": "string",
"vmExtensionStatusMessage": "string"
}
],
"createdDate": "string",
"customImageId": "string",
"dataDiskParameters": [
{
"attachNewDataDiskOptions": {
"diskName": "string",
"diskSizeGiB": "int",
"diskType": "string"
},
"existingLabDiskId": "string",
"hostCaching": "string"
}
],
"disallowPublicIpAddress": "bool",
"environmentId": "string",
"expirationDate": "string",
"galleryImageReference": {
"offer": "string",
"osType": "string",
"publisher": "string",
"sku": "string",
"version": "string"
},
"isAuthenticationWithSshKey": "bool",
"labSubnetName": "string",
"labVirtualNetworkId": "string",
"networkInterface": {
"dnsName": "string",
"privateIpAddress": "string",
"publicIpAddress": "string",
"publicIpAddressId": "string",
"rdpAuthority": "string",
"sharedPublicIpAddressConfiguration": {
"inboundNatRules": [
{
"backendPort": "int",
"frontendPort": "int",
"transportProtocol": "string"
}
]
},
"sshAuthority": "string",
"subnetId": "string",
"virtualNetworkId": "string"
},
"notes": "string",
"ownerObjectId": "string",
"ownerUserPrincipalName": "string",
"password": "string",
"planId": "string",
"scheduleParameters": [
{
"name": "string",
"properties": {
"dailyRecurrence": {
"time": "string"
},
"hourlyRecurrence": {
"minute": "int"
},
"notificationSettings": {
"emailRecipient": "string",
"notificationLocale": "string",
"status": "string",
"timeInMinutes": "int",
"webhookUrl": "string"
},
"status": "string",
"targetResourceId": "string",
"taskType": "string",
"weeklyRecurrence": {
"time": "string",
"weekdays": [ "string" ]
}
},
"tags": {}
}
],
"size": "string",
"sshKey": "string",
"storageType": "string",
"userName": "string"
}
}
Значения свойств
labs/virtualmachines
Имя | Описание | Значение |
---|---|---|
тип | Тип ресурса | Microsoft.DevTestLab/labs/virtualmachines |
версия_API | Версия API ресурсов | '2018-09-15' |
name | имя ресурса. Узнайте, как задать имена и типы для дочерних ресурсов в шаблонах JSON ARM. |
строка (обязательно) Ограничение символов: 1–15 (Windows) 1–64 (Linux) Допустимые символы: Буквенно-цифровые символы и дефисы. Начинается и закачивается буквенно-цифровым символом. Не может содержать только цифры. |
location | Расположение ресурса. | строка |
tags | Теги ресурса. | Словарь имен и значений тегов. См . раздел Теги в шаблонах |
properties | Свойства ресурса. | LabVirtualMachineProperties (обязательно) |
LabVirtualMachineProperties
Имя | Описание | Значение |
---|---|---|
allowClaim | Указывает, может ли другой пользователь стать владельцем виртуальной машины. | bool |
артефакты | Артефакты, устанавливаемые на виртуальной машине. | ArtifactInstallProperties[] |
createdDate | Дата создания виртуальной машины. | строка |
customImageId | Идентификатор пользовательского образа виртуальной машины. | строка |
dataDiskParameters | Новые или существующие диски данных для подключения к виртуальной машине после создания | DataDiskProperties[] |
disallowPublicIpAddress | Указывает, будет ли виртуальная машина создана без общедоступного IP-адреса. | bool |
environmentId | Идентификатор ресурса среды, содержащей эту виртуальную машину, если таковой есть. | строка |
expirationDate | Дата окончания срока действия виртуальной машины. | строка |
galleryImageReference | Ссылка на образ Azure Marketplace Microsoft для виртуальной машины. | GalleryImageReference |
isAuthenticationWithSshKey | Указывает, использует ли эта виртуальная машина ключ SSH для проверки подлинности. | bool |
labSubnetName | Имя подсети лаборатории виртуальной машины. | строка |
labVirtualNetworkId | Идентификатор виртуальной сети лаборатории виртуальной машины. | строка |
networkInterface. | Свойства сетевого интерфейса. | NetworkInterfaceProperties |
HDInsight | Заметки о виртуальной машине. | строка |
ownerObjectId | Идентификатор объекта владельца виртуальной машины. | строка |
ownerUserPrincipalName | Имя участника-пользователя владельца виртуальной машины. | строка |
password | Пароль администратора виртуальной машины. | строка |
planId | Идентификатор плана, связанного с образом виртуальной машины | строка |
scheduleParameters | Создаваемые расписания виртуальных машин | ScheduleCreationParameter[] |
size | Размер виртуальной машины. | строка |
sshKey | Ключ SSH администратора виртуальной машины. | строка |
storageType | Тип хранилища, используемого для виртуальной машины (например, "Стандартный", "Премиум"). | строка |
userName | Имя пользователя виртуальной машины. | строка |
ArtifactInstallProperties
Имя | Описание | Значение |
---|---|---|
artifactId | Идентификатор артефакта. | строка |
artifactTitle | Название артефакта. | строка |
deploymentStatusMessage | Сообщение о состоянии из развертывания. | строка |
installTime | Время начала установки артефакта на виртуальной машине. | строка |
параметры | Параметры артефакта. | ArtifactParameterProperties[] |
status | Состояние артефакта. | строка |
vmExtensionStatusMessage | Сообщение о состоянии из расширения виртуальной машины. | строка |
ArtifactParameterProperties
Имя | Описание | Значение |
---|---|---|
name | Имя параметра артефакта. | строка |
value | Значение параметра артефакта. | строка |
DataDiskProperties
Имя | Описание | Значение |
---|---|---|
attachNewDataDiskOptions | Задает параметры для подключения нового диска к виртуальной машине. | AttachNewDataDiskOptions |
existingLabDiskId | Указывает идентификатор существующего диска лаборатории для подключения к виртуальной машине. | строка |
hostCaching | Параметр кэширования для диска данных (например, None, ReadOnly, ReadWrite). | "Нет" ReadOnly ReadWrite |
AttachNewDataDiskOptions
Имя | Описание | Значение |
---|---|---|
имя_диска | Имя подключаемого диска. | строка |
diskSizeGiB | Размер подключаемого диска в гибибайтах. | INT |
diskType | Тип хранилища для диска (например, "Стандартный", "Премиум"). | "Премиум" "Стандартный" StandardSSD |
GalleryImageReference
Имя | Описание | Значение |
---|---|---|
offer | Предложение образа коллекции. | строка |
osType | Тип ОС образа коллекции. | строка |
publisher | Издатель образа коллекции. | строка |
sku | Номер SKU образа коллекции. | строка |
version | Версия образа коллекции. | строка |
NetworkInterfaceProperties
Имя | Описание | Значение |
---|---|---|
dnsName | DNS-имя. | строка |
privateIpAddress | Частный IP-адрес. | строка |
publicIpAddress | Общедоступный IP-адрес. | строка |
publicIpAddressId | Идентификатор ресурса общедоступного IP-адреса. | строка |
rdpAuthority | Свойство RdpAuthority — это DNS-имя узла сервера или IP-адрес, за которым следует номер порта службы для протокола удаленного рабочего стола (RDP). | строка |
sharedPublicIpAddressConfiguration | Конфигурация совместного использования общедоступного IP-адреса на нескольких виртуальных машинах. | SharedPublicIpAddressConfiguration |
sshAuthority | Свойство SshAuthority — это dns-имя узла сервера или IP-адрес, за которым следует номер порта службы для SSH. | строка |
subnetId | Идентификатор ресурса дочерней сети. | строка |
virtualNetworkId | Идентификатор ресурса виртуальной сети. | строка |
SharedPublicIpAddressConfiguration
Имя | Описание | Значение |
---|---|---|
inboundNatRules | Правила NAT для входящих подключений | InboundNatRule[] |
InboundNatRule
Имя | Описание | Значение |
---|---|---|
backendPort | Порт, на который будет перенаправляться внешний трафик. | INT |
frontendPort | Порт внешней конечной точки входящего подключения. Возможный диапазон значений — от 1 до 65 535 включительно. Если значение не указано, значение будет выделено автоматически. | INT |
transportProtocol | Транспортный протокол для конечной точки. | Tcp "Udp" |
ScheduleCreationParameter
Имя | Описание | Значение |
---|---|---|
name | Имя виртуальной машины или среды | строка |
properties | Свойства расписания. | Свойства ScheduleCreationParameterProperties |
tags | Теги ресурса. | object |
Свойства ScheduleCreationParameterProperties
Имя | Описание | Значение |
---|---|---|
dailyRecurrence | Если расписание будет выполняться один раз в день недели, укажите ежедневное повторение. | DayDetails |
hourlyRecurrence | Если расписание будет выполняться несколько раз в день, укажите ежечасное повторение. | HourDetails |
notificationSettings | Параметры уведомлений. | NotificationSettings |
status | Состояние расписания (т. е. "Включено", "Отключено") | "Отключено" "Включено" |
targetResourceId | Идентификатор ресурса, которому принадлежит расписание | строка |
taskType | Тип задачи расписания (например, LabVmsShutdownTask, LabVmAutoStart). | строка |
weeklyRecurrence | Если расписание будет выполняться только в некоторые дни недели, укажите еженедельное повторение. | WeekDetails |
DayDetails
Имя | Описание | Значение |
---|---|---|
time | Время суток, когда расписание будет выполняться. | строка |
HourDetails
Имя | Описание | Значение |
---|---|---|
minute | Минуты часа выполнения расписания. | INT |
NotificationSettings
Имя | Описание | Значение |
---|---|---|
emailRecipient | Получатель электронной почты для отправки уведомлений (может быть списком адресов электронной почты, разделенных точкой с запятой). | строка |
notificationLocale | Языковой стандарт, используемый при отправке уведомления (резервным вариантом для неподдерживаемых языков является EN). | строка |
status | Если для этого расписания включены уведомления (т. е. включено, отключено). | "Отключено" "Включено" |
timeInMinutes | Время в минутах до события, когда будет отправлено уведомление. | INT |
webhookUrl | URL-адрес веб-перехватчика, по которому будет отправлено уведомление. | строка |
WeekDetails
Имя | Описание | Значение |
---|---|---|
time | Время суток, когда расписание будет выполняться. | строка |
Будние дни | Дни недели, для которых задано расписание (например, воскресенье, понедельник, вторник и т. д.). | string[] |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
Шаблон | Описание |
---|---|
Создание лаборатории в Azure DevTest Labs с помощью виртуальной машины Windows Server |
Этот шаблон создает новый экземпляр DevTest Lab или DTL с виртуальной машиной Windows Server 2019 Datacenter. Дополнительные шаблоны быстрого запуска Azure Resource Manager для Azure DevTest Labs доступны на страницеhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Создание лаборатории в Azure DevTest Labs с запрошенной виртуальной машиной |
Этот шаблон создает новый экземпляр DevTest Lab или DTL с запрошенной виртуальной машиной Windows Server 2019 Datacenter. Дополнительные шаблоны быстрого запуска Azure Resource Manager для Azure DevTest Labs доступны на страницеhttps://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса labs/virtualmachines можно развернуть с помощью операций, предназначенных для:
- Группы ресурсов
Список измененных свойств в каждой версии API см. в журнале изменений.
Формат ресурсов
Чтобы создать ресурс Microsoft.DevTestLab/labs/virtualmachines, добавьте в шаблон следующую terraform.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
allowClaim = bool
artifacts = [
{
artifactId = "string"
artifactTitle = "string"
deploymentStatusMessage = "string"
installTime = "string"
parameters = [
{
name = "string"
value = "string"
}
]
status = "string"
vmExtensionStatusMessage = "string"
}
]
createdDate = "string"
customImageId = "string"
dataDiskParameters = [
{
attachNewDataDiskOptions = {
diskName = "string"
diskSizeGiB = int
diskType = "string"
}
existingLabDiskId = "string"
hostCaching = "string"
}
]
disallowPublicIpAddress = bool
environmentId = "string"
expirationDate = "string"
galleryImageReference = {
offer = "string"
osType = "string"
publisher = "string"
sku = "string"
version = "string"
}
isAuthenticationWithSshKey = bool
labSubnetName = "string"
labVirtualNetworkId = "string"
networkInterface = {
dnsName = "string"
privateIpAddress = "string"
publicIpAddress = "string"
publicIpAddressId = "string"
rdpAuthority = "string"
sharedPublicIpAddressConfiguration = {
inboundNatRules = [
{
backendPort = int
frontendPort = int
transportProtocol = "string"
}
]
}
sshAuthority = "string"
subnetId = "string"
virtualNetworkId = "string"
}
notes = "string"
ownerObjectId = "string"
ownerUserPrincipalName = "string"
password = "string"
planId = "string"
scheduleParameters = [
{
name = "string"
properties = {
dailyRecurrence = {
time = "string"
}
hourlyRecurrence = {
minute = int
}
notificationSettings = {
emailRecipient = "string"
notificationLocale = "string"
status = "string"
timeInMinutes = int
webhookUrl = "string"
}
status = "string"
targetResourceId = "string"
taskType = "string"
weeklyRecurrence = {
time = "string"
weekdays = [
"string"
]
}
}
tags = {}
}
]
size = "string"
sshKey = "string"
storageType = "string"
userName = "string"
}
})
}
Значения свойств
labs/virtualmachines
Имя | Описание | Значение |
---|---|---|
тип | Тип ресурса | "Microsoft.DevTestLab/labs/virtualmachines@2018-09-15" |
name | имя ресурса. | строка (обязательно) Ограничение символов: 1–15 (Windows) 1–64 (Linux) Допустимые символы: Буквенно-цифровые символы и дефисы. Начинается и закачивается буквенно-цифровым символом. Не может содержать только цифры. |
location | Расположение ресурса. | строка |
parent_id | Идентификатор ресурса, который является родительским для этого ресурса. | Идентификатор ресурса типа: labs |
tags | Теги ресурса. | Словарь имен и значений тегов. |
properties | Свойства ресурса. | LabVirtualMachineProperties (обязательно) |
LabVirtualMachineProperties
Имя | Описание | Значение |
---|---|---|
allowClaim | Указывает, может ли другой пользователь стать владельцем виртуальной машины. | bool |
артефакты | Артефакты, устанавливаемые на виртуальной машине. | ArtifactInstallProperties[] |
createdDate | Дата создания виртуальной машины. | строка |
customImageId | Идентификатор пользовательского образа виртуальной машины. | строка |
dataDiskParameters | Новые или существующие диски данных для подключения к виртуальной машине после создания | DataDiskProperties[] |
disallowPublicIpAddress | Указывает, будет ли виртуальная машина создана без общедоступного IP-адреса. | bool |
environmentId | Идентификатор ресурса среды, содержащей эту виртуальную машину, если таковой есть. | строка |
expirationDate | Дата окончания срока действия виртуальной машины. | строка |
galleryImageReference | Ссылка на образ Azure Marketplace Microsoft для виртуальной машины. | GalleryImageReference |
isAuthenticationWithSshKey | Указывает, использует ли эта виртуальная машина ключ SSH для проверки подлинности. | bool |
labSubnetName | Имя подсети лаборатории виртуальной машины. | строка |
labVirtualNetworkId | Идентификатор виртуальной сети лаборатории виртуальной машины. | строка |
networkInterface. | Свойства сетевого интерфейса. | NetworkInterfaceProperties |
HDInsight | Заметки о виртуальной машине. | строка |
ownerObjectId | Идентификатор объекта владельца виртуальной машины. | строка |
ownerUserPrincipalName | Имя участника-пользователя владельца виртуальной машины. | строка |
password | Пароль администратора виртуальной машины. | строка |
planId | Идентификатор плана, связанного с образом виртуальной машины | строка |
scheduleParameters | Создаваемые расписания виртуальных машин | ScheduleCreationParameter[] |
size | Размер виртуальной машины. | строка |
sshKey | Ключ SSH администратора виртуальной машины. | строка |
storageType | Тип хранилища, используемого для виртуальной машины (например, "Стандартный", "Премиум"). | строка |
userName | Имя пользователя виртуальной машины. | строка |
ArtifactInstallProperties
Имя | Описание | Значение |
---|---|---|
artifactId | Идентификатор артефакта. | строка |
artifactTitle | Заголовок артефакта. | строка |
deploymentStatusMessage | Сообщение о состоянии из развертывания. | строка |
installTime | Время начала установки артефакта на виртуальной машине. | строка |
параметры | Параметры артефакта. | ArtifactParameterProperties[] |
status | Состояние артефакта. | строка |
vmExtensionStatusMessage | Сообщение о состоянии из расширения виртуальной машины. | строка |
Свойства ArtifactParameterProperties
Имя | Описание | Значение |
---|---|---|
name | Имя параметра артефакта. | строка |
value | Значение параметра артефакта. | строка |
DataDiskProperties
Имя | Описание | Значение |
---|---|---|
attachNewDataDiskOptions | Задает параметры для подключения нового диска к виртуальной машине. | AttachNewDataDiskOptions |
existingLabDiskId | Указывает существующий идентификатор диска лаборатории для подключения к виртуальной машине. | строка |
HostCaching | Параметр кэширования для диска данных (т. е. None, ReadOnly, ReadWrite). | "None" ReadOnly ReadWrite |
AttachNewDataDiskOptions
Имя | Описание | Значение |
---|---|---|
имя_диска | Имя подключаемого диска. | строка |
diskSizeGib | Размер подключаемого диска в гибибайтах. | INT |
diskType | Тип хранилища для диска (например, "Стандартный", "Премиум"). | "Премиум" "Стандартный" "StandardSSD" |
GalleryImageReference
Имя | Описание | Значение |
---|---|---|
offer | Предложение изображения из коллекции. | строка |
osType | Тип ОС образа коллекции. | строка |
publisher | Издатель образа коллекции. | строка |
sku | Номер SKU образа коллекции. | строка |
version | Версия образа коллекции. | строка |
Свойства NetworkInterfaceProperties
Имя | Описание | Значение |
---|---|---|
dnsName | DNS-имя. | строка |
privateIpAddress | Частный IP-адрес. | строка |
publicIpAddress | Общедоступный IP-адрес. | строка |
publicIpAddressId | Идентификатор ресурса общедоступного IP-адреса. | строка |
rdpAuthority | Свойство RdpAuthority — это DNS-имя узла сервера или IP-адрес, за которым следует номер порта службы для протокола удаленного рабочего стола (RDP). | строка |
sharedPublicIpAddressConfiguration | Конфигурация совместного использования общедоступного IP-адреса на нескольких виртуальных машинах. | SharedPublicIpAddressConfiguration |
sshAuthority | Свойство SshAuthority — это dns-имя узла сервера или IP-адрес, за которым следует номер порта службы для SSH. | строка |
subnetId | Идентификатор ресурса дочерней сети. | строка |
virtualNetworkId | Идентификатор ресурса виртуальной сети. | строка |
SharedPublicIpAddressConfiguration
Имя | Описание | Значение |
---|---|---|
inboundNatRules | Правила NAT для входящих подключений | InboundNatRule[] |
InboundNatRule
Имя | Описание | Значение |
---|---|---|
backendPort | Порт, на который будет перенаправляться внешний трафик. | INT |
frontendPort | Порт внешней конечной точки входящего подключения. Возможный диапазон значений — от 1 до 65 535 включительно. Если значение не указано, значение будет выделено автоматически. | INT |
transportProtocol | Транспортный протокол для конечной точки. | "Tcp" "Udp" |
ScheduleCreationParameter
Имя | Описание | Значение |
---|---|---|
name | Имя виртуальной машины или среды | строка |
properties | Свойства расписания. | ScheduleCreationParameterProperties |
tags | Теги ресурса. | объект |
ScheduleCreationParameterProperties
Имя | Описание | Значение |
---|---|---|
dailyRecurrence | Если расписание будет выполняться один раз в день недели, укажите ежедневное повторение. | DayDetails |
hourlyRecurrence | Если расписание будет выполняться несколько раз в день, укажите ежечасное повторение. | HourDetails |
notificationSettings | Параметры уведомлений. | NotificationSettings |
status | Состояние расписания (т. е. Включено, Отключено) | "Отключено" "Включено" |
targetResourceId | Идентификатор ресурса, которому принадлежит расписание | строка |
taskType | Тип задачи расписания (например, LabVmsShutdownTask, LabVmAutoStart). | строка |
weeklyRecurrence | Если расписание будет выполняться только в некоторые дни недели, укажите еженедельное повторение. | WeekDetails |
DayDetails
Имя | Описание | Значение |
---|---|---|
time | Время суток, когда будет выполняться расписание. | строка |
HourDetails
Имя | Описание | Значение |
---|---|---|
minute | Минуты часа, на который будет выполняться расписание. | INT |
NotificationSettings
Имя | Описание | Значение |
---|---|---|
emailRecipient | Получатель электронной почты для отправки уведомлений (может быть списком адресов электронной почты, разделенных точкой с запятой). | строка |
notificationLocale | Языковой стандарт, используемый при отправке уведомления (резервный вариант для неподдерживаемых языков — EN). | строка |
status | Если для этого расписания включены уведомления (т. е. включено, отключено). | "Отключено" "Включено" |
timeInMinutes | Время в минутах до события, при котором будет отправлено уведомление. | INT |
webhookUrl | URL-адрес веб-перехватчика, на который будет отправлено уведомление. | строка |
WeekDetails
Имя | Описание | Значение |
---|---|---|
time | Время суток, когда будет выполняться расписание. | строка |
Будние дни | Дни недели, для которых задано расписание (например, воскресенье, понедельник, вторник и т. д.). | string[] |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по