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


Проекты и пулы Microsoft.DevCenter

Определение ресурсов Bicep

Тип ресурсов проектов и пулов можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/projects/pools, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.DevCenter/projects/pools@2025-02-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    devBoxDefinition: {
      imageReference: {
        id: 'string'
      }
      sku: {
        capacity: int
        family: 'string'
        name: 'string'
        size: 'string'
        tier: 'string'
      }
    }
    devBoxDefinitionName: 'string'
    devBoxDefinitionType: 'string'
    displayName: 'string'
    licenseType: 'string'
    localAdministrator: 'string'
    managedVirtualNetworkRegions: [
      'string'
    ]
    networkConnectionName: 'string'
    singleSignOnStatus: 'string'
    stopOnDisconnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    stopOnNoConnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    virtualNetworkType: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

ImageReference

Имя Описание Ценность
идентификатор Идентификатор изображения или идентификатор версии образа. При указании идентификатора образа будет использоваться последняя версия. струна

Microsoft.DevCenter/projects/pools

Имя Описание Ценность
местоположение Географическое расположение, в котором находится ресурс строка (обязательно)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 3
Максимальная длина = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: проекты
свойства Свойства пула PoolProperties
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

PoolDevBoxDefinition

Имя Описание Ценность
ImageReference Справочные сведения о изображении. ImageReference
SKU Номер SKU для полей разработки, созданный из пула. Sku

PoolProperties

Имя Описание Ценность
devBoxDefinition Определение компьютеров, созданных из этого пула. Будет игнорироваться, если devBoxDefinitionType является ссылкой или не указан. PoolDevBoxDefinition
devBoxDefinitionName Имя определения Dev Box в родительском проекте этого пула. Будет игнорироваться, если devBoxDefinitionType имеет значение. струна
devBoxDefinitionType Указывает, создается ли пул из существующего определения Поля разработки или если он указан напрямую. "Справочник"
Значение
displayName Отображаемое имя пула. струна
licenseType Указывает тип лицензии, указывающий, что вызывающий объект уже приобрел лицензии для созданных модулей Dev Boxes. "Windows_Client"
localAdministrator Указывает, добавляются ли владельцы Dev Box в этом пуле в качестве локальных администраторов в Поле разработки. "Отключено"
"Включено"
managedVirtualNetworkRegions Регионы управляемой виртуальной сети (требуется, если managedNetworkType является Управляемым). string[]
networkConnectionName Имя сетевого подключения в родительском проекте этого пула струна
singleSignOnStatus Указывает, создаются ли поля Dev Box в этом пуле с включенным единым входом. Кроме того, требуется включить единый вход в клиент. "Отключено"
"Включено"
stopOnDisconnect Остановите параметры конфигурации отключения для Dev Boxes, созданные в этом пуле. StopOnDisconnectConfiguration
stopOnNoConnect Остановите параметры конфигурации подключения для Dev Boxes, созданные в этом пуле. StopOnNoConnectConfiguration
virtualNetworkType Указывает, использует ли пул виртуальную сеть, управляемую корпорацией Майкрософт или предоставленной клиентом сетью. "Managed" (Управляемый)
"Неуправляемый"

Sku

Имя Описание Ценность
способность Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. int
семья Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Например, P3. Обычно это код буквы и числа строка (обязательно)
размер Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
ярус Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. "Базовый"
"Бесплатный"
"Премиум"
"Стандартный"

StopOnDisconnectConfiguration

Имя Описание Ценность
gracePeriodMinutes Указанное время в минутах ожидания перед остановкой Поля разработки после обнаружения отключения. int
статус Если функция остановите поле разработки при отключении после включения льготного периода. "Отключено"
"Включено"

StopOnNoConnectConfiguration

Имя Описание Ценность
gracePeriodMinutes Указанное время в минутах ожидания перед остановкой Поля разработки, если подключение не выполнено. int
статус Позволяет ему остановить запущенную функцию Dev Box, когда она не была подключена, после завершения льготного периода. "Отключено"
"Включено"

TrackedResourceTags

Имя Описание Ценность

Примеры использования

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл Описание
настройка службы Dev Box Этот шаблон создаст все ресурсы администратора Dev Box в рамках краткого руководства по началу работы Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки.
развертывание службы Dev Box Со встроенным образом Этот шаблон предоставляет способ развертывания службы Dev Box со встроенным образом.

Определение ресурса шаблона ARM

Тип ресурсов проектов и пулов можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/projects/pools, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.DevCenter/projects/pools",
  "apiVersion": "2025-02-01",
  "name": "string",
  "location": "string",
  "properties": {
    "devBoxDefinition": {
      "imageReference": {
        "id": "string"
      },
      "sku": {
        "capacity": "int",
        "family": "string",
        "name": "string",
        "size": "string",
        "tier": "string"
      }
    },
    "devBoxDefinitionName": "string",
    "devBoxDefinitionType": "string",
    "displayName": "string",
    "licenseType": "string",
    "localAdministrator": "string",
    "managedVirtualNetworkRegions": [ "string" ],
    "networkConnectionName": "string",
    "singleSignOnStatus": "string",
    "stopOnDisconnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "stopOnNoConnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "virtualNetworkType": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

ImageReference

Имя Описание Ценность
идентификатор Идентификатор изображения или идентификатор версии образа. При указании идентификатора образа будет использоваться последняя версия. струна

Microsoft.DevCenter/projects/pools

Имя Описание Ценность
apiVersion Версия API '2025-02-01'
местоположение Географическое расположение, в котором находится ресурс строка (обязательно)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 3
Максимальная длина = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (обязательно)
свойства Свойства пула PoolProperties
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.DevCenter/projects/pools"

PoolDevBoxDefinition

Имя Описание Ценность
ImageReference Справочные сведения о изображении. ImageReference
SKU Номер SKU для полей разработки, созданный из пула. Sku

PoolProperties

Имя Описание Ценность
devBoxDefinition Определение компьютеров, созданных из этого пула. Будет игнорироваться, если devBoxDefinitionType является ссылкой или не указан. PoolDevBoxDefinition
devBoxDefinitionName Имя определения Dev Box в родительском проекте этого пула. Будет игнорироваться, если devBoxDefinitionType имеет значение. струна
devBoxDefinitionType Указывает, создается ли пул из существующего определения Поля разработки или если он указан напрямую. "Справочник"
Значение
displayName Отображаемое имя пула. струна
licenseType Указывает тип лицензии, указывающий, что вызывающий объект уже приобрел лицензии для созданных модулей Dev Boxes. "Windows_Client"
localAdministrator Указывает, добавляются ли владельцы Dev Box в этом пуле в качестве локальных администраторов в Поле разработки. "Отключено"
"Включено"
managedVirtualNetworkRegions Регионы управляемой виртуальной сети (требуется, если managedNetworkType является Управляемым). string[]
networkConnectionName Имя сетевого подключения в родительском проекте этого пула струна
singleSignOnStatus Указывает, создаются ли поля Dev Box в этом пуле с включенным единым входом. Кроме того, требуется включить единый вход в клиент. "Отключено"
"Включено"
stopOnDisconnect Остановите параметры конфигурации отключения для Dev Boxes, созданные в этом пуле. StopOnDisconnectConfiguration
stopOnNoConnect Остановите параметры конфигурации подключения для Dev Boxes, созданные в этом пуле. StopOnNoConnectConfiguration
virtualNetworkType Указывает, использует ли пул виртуальную сеть, управляемую корпорацией Майкрософт или предоставленной клиентом сетью. "Managed" (Управляемый)
"Неуправляемый"

Sku

Имя Описание Ценность
способность Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. int
семья Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Например, P3. Обычно это код буквы и числа строка (обязательно)
размер Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
ярус Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. "Базовый"
"Бесплатный"
"Премиум"
"Стандартный"

StopOnDisconnectConfiguration

Имя Описание Ценность
gracePeriodMinutes Указанное время в минутах ожидания перед остановкой Поля разработки после обнаружения отключения. int
статус Если функция остановите поле разработки при отключении после включения льготного периода. "Отключено"
"Включено"

StopOnNoConnectConfiguration

Имя Описание Ценность
gracePeriodMinutes Указанное время в минутах ожидания перед остановкой Поля разработки, если подключение не выполнено. int
статус Позволяет ему остановить запущенную функцию Dev Box, когда она не была подключена, после завершения льготного периода. "Отключено"
"Включено"

TrackedResourceTags

Имя Описание Ценность

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон Описание
настройка службы Dev Box

развертывание в Azure
Этот шаблон создаст все ресурсы администратора Dev Box в рамках краткого руководства по началу работы Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки.
развертывание службы Dev Box Со встроенным образом

развертывание в Azure
Этот шаблон предоставляет способ развертывания службы Dev Box со встроенным образом.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурсов проектов и пулов можно развернуть с помощью операций, предназначенных для следующих операций:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/projects/pools, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/pools@2025-02-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      devBoxDefinition = {
        imageReference = {
          id = "string"
        }
        sku = {
          capacity = int
          family = "string"
          name = "string"
          size = "string"
          tier = "string"
        }
      }
      devBoxDefinitionName = "string"
      devBoxDefinitionType = "string"
      displayName = "string"
      licenseType = "string"
      localAdministrator = "string"
      managedVirtualNetworkRegions = [
        "string"
      ]
      networkConnectionName = "string"
      singleSignOnStatus = "string"
      stopOnDisconnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      stopOnNoConnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      virtualNetworkType = "string"
    }
  }
}

Значения свойств

ImageReference

Имя Описание Ценность
идентификатор Идентификатор изображения или идентификатор версии образа. При указании идентификатора образа будет использоваться последняя версия. струна

Microsoft.DevCenter/projects/pools

Имя Описание Ценность
местоположение Географическое расположение, в котором находится ресурс строка (обязательно)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 3
Максимальная длина = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: проекты
свойства Свойства пула PoolProperties
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.DevCenter/projects/pools@2025-02-01"

PoolDevBoxDefinition

Имя Описание Ценность
ImageReference Справочные сведения о изображении. ImageReference
SKU Номер SKU для полей разработки, созданный из пула. Sku

PoolProperties

Имя Описание Ценность
devBoxDefinition Определение компьютеров, созданных из этого пула. Будет игнорироваться, если devBoxDefinitionType является ссылкой или не указан. PoolDevBoxDefinition
devBoxDefinitionName Имя определения Dev Box в родительском проекте этого пула. Будет игнорироваться, если devBoxDefinitionType имеет значение. струна
devBoxDefinitionType Указывает, создается ли пул из существующего определения Поля разработки или если он указан напрямую. "Справочник"
Значение
displayName Отображаемое имя пула. струна
licenseType Указывает тип лицензии, указывающий, что вызывающий объект уже приобрел лицензии для созданных модулей Dev Boxes. "Windows_Client"
localAdministrator Указывает, добавляются ли владельцы Dev Box в этом пуле в качестве локальных администраторов в Поле разработки. "Отключено"
"Включено"
managedVirtualNetworkRegions Регионы управляемой виртуальной сети (требуется, если managedNetworkType является Управляемым). string[]
networkConnectionName Имя сетевого подключения в родительском проекте этого пула струна
singleSignOnStatus Указывает, создаются ли поля Dev Box в этом пуле с включенным единым входом. Кроме того, требуется включить единый вход в клиент. "Отключено"
"Включено"
stopOnDisconnect Остановите параметры конфигурации отключения для Dev Boxes, созданные в этом пуле. StopOnDisconnectConfiguration
stopOnNoConnect Остановите параметры конфигурации подключения для Dev Boxes, созданные в этом пуле. StopOnNoConnectConfiguration
virtualNetworkType Указывает, использует ли пул виртуальную сеть, управляемую корпорацией Майкрософт или предоставленной клиентом сетью. "Managed" (Управляемый)
"Неуправляемый"

Sku

Имя Описание Ценность
способность Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. int
семья Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Например, P3. Обычно это код буквы и числа строка (обязательно)
размер Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
ярус Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. "Базовый"
"Бесплатный"
"Премиум"
"Стандартный"

StopOnDisconnectConfiguration

Имя Описание Ценность
gracePeriodMinutes Указанное время в минутах ожидания перед остановкой Поля разработки после обнаружения отключения. int
статус Если функция остановите поле разработки при отключении после включения льготного периода. "Отключено"
"Включено"

StopOnNoConnectConfiguration

Имя Описание Ценность
gracePeriodMinutes Указанное время в минутах ожидания перед остановкой Поля разработки, если подключение не выполнено. int
статус Позволяет ему остановить запущенную функцию Dev Box, когда она не была подключена, после завершения льготного периода. "Отключено"
"Включено"

TrackedResourceTags

Имя Описание Ценность