Labs - Create Or Update

Служба:: Dev Test Labs

Версия API:: 2018-09-15

Создайте или замените существующую лабораторию. Эта операция может занять некоторое время.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}?api-version=2018-09-15

Параметры URI

Имя	В	Обязательно	Тип	Описание
name	path	True	string	Имя лаборатории.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Тип	Описание
location	string	Географическое расположение, в котором находится ресурс
properties.announcement	LabAnnouncementProperties	Свойства любого объявления лаборатории, связанного с этой лабораторией
properties.environmentPermission	EnvironmentPermission	Права доступа, предоставляемые пользователю при подготовке среды
properties.extendedProperties	object	Расширенные свойства лаборатории, используемой для экспериментальных функций
properties.labStorageType	StorageType	Тип хранилища, используемого лабораторией. Он может быть либо премиум, либо стандартный. Значение по умолчанию — Premium.
properties.mandatoryArtifactsResourceIdsLinux	string[]	Упорядоченный список идентификаторов ресурсов артефактов, которые должны применяться ко всем созданиям виртуальных машин Linux по умолчанию до артефактов, указанных пользователем.
properties.mandatoryArtifactsResourceIdsWindows	string[]	Упорядоченный список идентификаторов ресурсов артефактов, которые должны применяться ко всем созданиям виртуальных машин Windows по умолчанию до артефактов, указанных пользователем.
properties.premiumDataDisks	PremiumDataDisk	Параметр для включения использования дисков данных класса Premium. Если его значение равно "Включено", допускается создание дисков данных уровня "Стандартный" или "Премиум". Если значение равно "Отключено", допускается только создание стандартных дисков данных.
properties.support	LabSupportProperties	Свойства любого сообщения о поддержке лаборатории, связанного с этой лабораторией
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	Lab	Операция обновления ресурса 'Lab' выполнена успешно
201 Created	Lab	Операция по созданию ресурса 'Lab' выполнена успешно Заголовки Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

Lab

Операция обновления ресурса 'Lab' выполнена успешно

201 Created

Lab

Операция по созданию ресурса 'Lab' выполнена успешно

Заголовки

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Labs_CreateOrUpdate

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}?api-version=2018-09-15

{
  "location": "{location}",
  "properties": {
    "labStorageType": "{Standard|Premium}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Пример ответа

Код состояния:: 200

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Код состояния:: 201

{
  "name": "{labName}",
  "type": "Microsoft.DevTestLab/labs",
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}",
  "location": "{location}",
  "properties": {
    "announcement": {
      "enabled": "Disabled",
      "expired": false,
      "markdown": "",
      "title": ""
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "environmentPermission": "Reader",
    "labStorageType": "Standard",
    "mandatoryArtifactsResourceIdsLinux": [],
    "mandatoryArtifactsResourceIdsWindows": [],
    "premiumDataDisks": "Disabled",
    "provisioningState": "Creating",
    "support": {
      "enabled": "Disabled",
      "markdown": ""
    },
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
EnableStatus	Указывает, включен ли источник артефакта (значения: включено, отключено).
EnvironmentPermission	Права доступа, предоставляемые пользователю при подготовке среды
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
Lab	Лаборатория.
LabAnnouncementProperties	Свойства баннера объявления лаборатории
LabSupportProperties	Свойства баннера поддержки лаборатории
PremiumDataDisk	Параметр для включения использования дисков данных класса Premium. Если его значение равно "Включено", допускается создание дисков данных уровня "Стандартный" или "Премиум". Если значение равно "Отключено", допускается только создание стандартных дисков данных.
StorageType	Тип хранилища для диска (например, "Стандартный", "Премиум").
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

EnableStatus

Перечисление

Указывает, включен ли источник артефакта (значения: включено, отключено).

Значение	Описание
Enabled
Disabled

EnvironmentPermission

Перечисление

Права доступа, предоставляемые пользователю при подготовке среды

Значение	Описание
Reader
Contributor

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

Lab

Объект

Лаборатория.

Имя	Тип	Default value	Описание
id	string		Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string		Географическое расположение, в котором находится ресурс
name	string		Имя ресурса
properties.announcement	LabAnnouncementProperties		Свойства любого объявления лаборатории, связанного с этой лабораторией
properties.artifactsStorageAccount	string		Учетная запись хранения артефактов лаборатории.
properties.createdDate	string (date-time)		Дата создания лаборатории.
properties.defaultPremiumStorageAccount	string		Учетная запись хранения класса Premium по умолчанию лаборатории.
properties.defaultStorageAccount	string		Учетная запись хранения лаборатории по умолчанию.
properties.environmentPermission	EnvironmentPermission		Права доступа, предоставляемые пользователю при подготовке среды
properties.extendedProperties	object		Расширенные свойства лаборатории, используемой для экспериментальных функций
properties.labStorageType	StorageType	Premium	Тип хранилища, используемого лабораторией. Он может быть либо премиум, либо стандартный. Значение по умолчанию — Premium.
properties.loadBalancerId	string		Подсистема балансировки нагрузки, используемая для виртуальных машин лаборатории, использующих общий IP-адрес.
properties.mandatoryArtifactsResourceIdsLinux	string[]		Упорядоченный список идентификаторов ресурсов артефактов, которые должны применяться ко всем созданиям виртуальных машин Linux по умолчанию до артефактов, указанных пользователем.
properties.mandatoryArtifactsResourceIdsWindows	string[]		Упорядоченный список идентификаторов ресурсов артефактов, которые должны применяться ко всем созданиям виртуальных машин Windows по умолчанию до артефактов, указанных пользователем.
properties.networkSecurityGroupId	string		Группа безопасности сети, подключенная к сетевым интерфейсам лаборатории для ограничения открытых портов.
properties.premiumDataDiskStorageAccount	string		Учетная запись хранения диска данных класса Premium.
properties.premiumDataDisks	PremiumDataDisk		Параметр для включения использования дисков данных класса Premium. Если его значение равно "Включено", допускается создание дисков данных уровня "Стандартный" или "Премиум". Если значение равно "Отключено", допускается только создание стандартных дисков данных.
properties.provisioningState	string		Состояние подготовки ресурса.
properties.publicIpId	string		Общедоступный IP-адрес подсистемы балансировки нагрузки лаборатории.
properties.support	LabSupportProperties		Свойства любого сообщения о поддержке лаборатории, связанного с этой лабораторией
properties.uniqueIdentifier	string		Уникальный неизменяемый идентификатор ресурса (GUID).
properties.vaultName	string		Хранилище ключей лаборатории.
properties.vmCreationResourceGroup	string		Группа ресурсов, в которой будут созданы все новые виртуальные машины лаборатории. Чтобы разрешить DevTest Labs управлять созданием группы ресурсов, задайте для этого значения значение NULL.
systemData	systemData		Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object		Теги ресурсов.
type	string		Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

LabAnnouncementProperties

Объект

Свойства баннера объявления лаборатории

Имя	Тип	Описание
enabled	EnableStatus	В настоящее время ли объявление лаборатории активно или включено?
expirationDate	string (date-time)	Время истечения срока действия объявления (null для никогда)
expired	boolean	Истек ли срок действия этого объявления?
markdown	string	Текст markdown (если таковой) отображается в пользовательском интерфейсе этой лаборатории. Если осталось пустое или null, ничего не будет отображаться.
provisioningState	string	Состояние подготовки ресурса.
title	string	Название обычного текста для объявления лаборатории
uniqueIdentifier	string	Уникальный неизменяемый идентификатор ресурса (GUID).

LabSupportProperties

Объект

Свойства баннера поддержки лаборатории

Имя	Тип	Описание
enabled	EnableStatus	В настоящее время ли баннер поддержки лаборатории активен или включен?
markdown	string	Текст markdown (если таковой) отображается в пользовательском интерфейсе этой лаборатории. Если осталось пустое или null, ничего не будет отображаться.

PremiumDataDisk

Перечисление

Параметр для включения использования дисков данных класса Premium. Если его значение равно "Включено", допускается создание дисков данных уровня "Стандартный" или "Премиум". Если значение равно "Отключено", допускается только создание стандартных дисков данных.

Значение	Описание
Disabled
Enabled

StorageType

Перечисление

Тип хранилища для диска (например, "Стандартный", "Премиум").

Значение	Описание
Standard
Premium
StandardSSD

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

Labs - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Labs_CreateOrUpdate

Образец запроса

Пример ответа

Определения

createdByType

EnableStatus

EnvironmentPermission

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Lab

LabAnnouncementProperties

LabSupportProperties

PremiumDataDisk

StorageType

systemData