Labs - Create Or Update
Создайте или замените существующую лабораторию. Эта операция может занять некоторое время.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}?api-version=2018-09-15
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
name
|
path | True |
string |
Имя лаборатории. |
resource
|
path | True |
string |
Имя группы ресурсов. |
subscription
|
path | True |
string |
Идентификатор подписки. |
api-version
|
query | True |
string |
Версия API клиента. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
location |
string |
Расположение ресурса. |
properties.announcement |
Свойства любого объявления лаборатории, связанного с этой лабораторией |
|
properties.environmentPermission |
Права доступа, предоставляемые пользователю при подготовке среды |
|
properties.extendedProperties |
object |
Расширенные свойства лаборатории, используемые для экспериментальных функций |
properties.labStorageType |
Тип хранилища, используемого лабораторией. Это может быть категория "Премиум" или "Стандартный". Значение по умолчанию — Premium. |
|
properties.mandatoryArtifactsResourceIdsLinux |
string[] |
Упорядоченный список идентификаторов ресурсов артефактов, которые должны быть применены ко всем созданным виртуальным машинам Linux по умолчанию перед артефактами, указанными пользователем. |
properties.mandatoryArtifactsResourceIdsWindows |
string[] |
Упорядоченный список идентификаторов ресурсов артефактов, которые должны применяться ко всем созданным виртуальным машинам Windows по умолчанию до артефактов, указанных пользователем. |
properties.premiumDataDisks |
Параметр для включения использования дисков данных уровня "Премиум". Если его значение равно "Включено", создание дисков данных уровня "Стандартный" или "Премиум" разрешено. Если для нее задано значение Disabled, допускается только создание стандартных дисков данных. |
|
properties.support |
Свойства любого сообщения о поддержке лаборатории, связанного с этой лабораторией |
|
tags |
object |
Теги ресурса. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ОК |
|
201 Created |
Создание |
|
Other Status Codes |
BadRequest |
Безопасность
azure_auth
Неявное предоставление OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Имя | Описание |
---|---|
user_impersonation | Доступ к Microsoft Azure |
Примеры
Labs_CreateOrUpdate
Sample Request
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}?api-version=2018-09-15
{
"properties": {
"labStorageType": "{Standard|Premium}"
},
"location": "{location}",
"tags": {
"tagName1": "tagValue1"
}
}
Sample Response
{
"properties": {
"labStorageType": "Standard",
"mandatoryArtifactsResourceIdsLinux": [],
"mandatoryArtifactsResourceIdsWindows": [],
"createdDate": "2018-10-01T18:40:48.1739018-07:00",
"premiumDataDisks": "Disabled",
"environmentPermission": "Reader",
"announcement": {
"title": "",
"markdown": "",
"enabled": "Disabled",
"expired": false
},
"support": {
"enabled": "Disabled",
"markdown": ""
},
"provisioningState": "Creating",
"uniqueIdentifier": "{uniqueIdentifier}"
},
"id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
"name": "{labName}",
"type": "Microsoft.DevTestLab/labs",
"location": "{location}",
"tags": {
"tagName1": "tagValue1"
}
}
{
"properties": {
"labStorageType": "Standard",
"mandatoryArtifactsResourceIdsLinux": [],
"mandatoryArtifactsResourceIdsWindows": [],
"createdDate": "2018-10-01T18:40:48.1739018-07:00",
"premiumDataDisks": "Disabled",
"environmentPermission": "Reader",
"announcement": {
"title": "",
"markdown": "",
"enabled": "Disabled",
"expired": false
},
"support": {
"enabled": "Disabled",
"markdown": ""
},
"provisioningState": "Creating",
"uniqueIdentifier": "{uniqueIdentifier}"
},
"id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
"name": "{labName}",
"type": "Microsoft.DevTestLab/labs",
"location": "{location}",
"tags": {
"tagName1": "tagValue1"
}
}
Определения
Имя | Описание |
---|---|
Cloud |
Ошибка из запроса REST. |
Cloud |
Текст ошибки из запроса REST. |
Enable |
Состояние расписания (т. е. Включено, Отключено) |
Environment |
Права доступа, предоставляемые пользователю при подготовке среды |
Lab |
Лаборатория. |
Lab |
Свойства баннера объявления лаборатории |
Lab |
Свойства баннера поддержки лаборатории |
Premium |
Параметр для включения использования дисков данных уровня "Премиум". Если его значение равно "Включено", создание дисков данных уровня "Стандартный" или "Премиум" разрешено. Если для нее задано значение Disabled, допускается только создание стандартных дисков данных. |
Storage |
Тип хранилища для диска (например, "Стандартный", "Премиум"). |
CloudError
Ошибка из запроса REST.
Имя | Тип | Описание |
---|---|---|
error |
Произошла облачная ошибка |
CloudErrorBody
Текст ошибки из запроса REST.
Имя | Тип | Описание |
---|---|---|
code |
string |
Код ошибки. |
details |
Внутренние ошибки. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
EnableStatus
Состояние расписания (т. е. Включено, Отключено)
Имя | Тип | Описание |
---|---|---|
Disabled |
string |
|
Enabled |
string |
EnvironmentPermission
Права доступа, предоставляемые пользователю при подготовке среды
Имя | Тип | Описание |
---|---|---|
Contributor |
string |
|
Reader |
string |
Lab
Лаборатория.
Имя | Тип | Значение по умолчанию | Описание |
---|---|---|---|
id |
string |
Идентификатор ресурса. |
|
location |
string |
Расположение ресурса. |
|
name |
string |
Имя ресурса. |
|
properties.announcement |
Свойства любого объявления лаборатории, связанного с этой лабораторией |
||
properties.artifactsStorageAccount |
string |
Учетная запись хранения артефактов лаборатории. |
|
properties.createdDate |
string |
Дата создания лаборатории. |
|
properties.defaultPremiumStorageAccount |
string |
Учетная запись хранения класса "Премиум" по умолчанию. |
|
properties.defaultStorageAccount |
string |
Учетная запись хранения лаборатории по умолчанию. |
|
properties.environmentPermission |
Права доступа, предоставляемые пользователю при подготовке среды |
||
properties.extendedProperties |
object |
Расширенные свойства лаборатории, используемые для экспериментальных функций |
|
properties.labStorageType | Premium |
Тип хранилища, используемого лабораторией. Это может быть категория "Премиум" или "Стандартный". Значение по умолчанию — Premium. |
|
properties.loadBalancerId |
string |
Подсистема балансировки нагрузки, используемая для виртуальных машин лаборатории, использующих общий IP-адрес. |
|
properties.mandatoryArtifactsResourceIdsLinux |
string[] |
Упорядоченный список идентификаторов ресурсов артефактов, которые должны быть применены ко всем созданным виртуальным машинам Linux по умолчанию перед артефактами, указанными пользователем. |
|
properties.mandatoryArtifactsResourceIdsWindows |
string[] |
Упорядоченный список идентификаторов ресурсов артефактов, которые должны применяться ко всем созданным виртуальным машинам Windows по умолчанию до артефактов, указанных пользователем. |
|
properties.networkSecurityGroupId |
string |
Группа безопасности сети, подключенная к виртуальным машинам лаборатории, сетевые интерфейсы для ограничения открытых портов. |
|
properties.premiumDataDiskStorageAccount |
string |
Учетная запись хранения диска данных лаборатории уровня "Премиум". |
|
properties.premiumDataDisks |
Параметр для включения использования дисков данных уровня "Премиум". Если его значение равно "Включено", создание дисков данных уровня "Стандартный" или "Премиум" разрешено. Если для нее задано значение Disabled, допускается только создание стандартных дисков данных. |
||
properties.provisioningState |
string |
Состояние подготовки ресурса. |
|
properties.publicIpId |
string |
Общедоступный IP-адрес подсистемы балансировки нагрузки лаборатории. |
|
properties.support |
Свойства любого сообщения о поддержке лаборатории, связанного с этой лабораторией |
||
properties.uniqueIdentifier |
string |
Уникальный неизменяемый идентификатор ресурса (GUID). |
|
properties.vaultName |
string |
Хранилище ключей лаборатории. |
|
properties.vmCreationResourceGroup |
string |
Группа ресурсов, в которой будут созданы все новые виртуальные машины лаборатории. Чтобы позволить DevTest Labs управлять созданием группы ресурсов, присвойте этому значению значение null. |
|
tags |
object |
Теги ресурса. |
|
type |
string |
Тип ресурса. |
LabAnnouncementProperties
Свойства баннера объявления лаборатории
Имя | Тип | Описание |
---|---|---|
enabled |
Является ли объявление лаборатории активным или включенным в настоящее время? |
|
expirationDate |
string |
Время истечения срока действия объявления (null для никогда) |
expired |
boolean |
Истек ли срок действия этого объявления? |
markdown |
string |
Текст Markdown (при наличии), отображаемый в этом задании в пользовательском интерфейсе. Если оставить значение пустым или пустым, ничего не будет отображаться. |
provisioningState |
string |
Состояние подготовки ресурса. |
title |
string |
Заголовок в виде обычного текста для объявления лаборатории |
uniqueIdentifier |
string |
Уникальный неизменяемый идентификатор ресурса (GUID). |
LabSupportProperties
Свойства баннера поддержки лаборатории
Имя | Тип | Описание |
---|---|---|
enabled |
Активен или включен ли баннер поддержки лаборатории в настоящее время? |
|
markdown |
string |
Текст Markdown (при наличии), отображаемый в этом задании в пользовательском интерфейсе. Если оставить значение пустым или пустым, ничего не будет отображаться. |
PremiumDataDisk
Параметр для включения использования дисков данных уровня "Премиум". Если его значение равно "Включено", создание дисков данных уровня "Стандартный" или "Премиум" разрешено. Если для нее задано значение Disabled, допускается только создание стандартных дисков данных.
Имя | Тип | Описание |
---|---|---|
Disabled |
string |
|
Enabled |
string |
StorageType
Тип хранилища для диска (например, "Стандартный", "Премиум").
Имя | Тип | Описание |
---|---|---|
Premium |
string |
|
Standard |
string |
|
StandardSSD |
string |