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


Рабочие области и службы Microsoft.MachineLearningServices 2020-05-01-preview

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

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

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

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

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/services@2020-05-01-preview' = {
  name: 'string'
  location: 'string'
  parent: resourceSymbolicName
  description: 'string'
  environmentImageRequest: {
    assets: [
      {
        id: 'string'
        mimeType: 'string'
        unpack: bool
        url: 'string'
      }
    ]
    driverProgram: 'string'
    environment: {
      docker: {
        baseDockerfile: 'string'
        baseImage: 'string'
        baseImageRegistry: {
          address: 'string'
          password: 'string'
          username: 'string'
        }
      }
      environmentVariables: {
        {customized property}: 'string'
      }
      inferencingStackVersion: 'string'
      name: 'string'
      python: {
        baseCondaEnvironment: 'string'
        condaDependencies: any()
        interpreterPath: 'string'
        userManagedDependencies: bool
      }
      r: {
        bioConductorPackages: [
          'string'
        ]
        cranPackages: [
          {
            name: 'string'
            repository: 'string'
          }
        ]
        customUrlPackages: [
          'string'
        ]
        gitHubPackages: [
          {
            authToken: 'string'
            repository: 'string'
          }
        ]
        rscriptPath: 'string'
        rVersion: 'string'
        snapshotDate: 'string'
        userManaged: bool
      }
      spark: {
        packages: [
          {
            artifact: 'string'
            group: 'string'
            version: 'string'
          }
        ]
        precachePackages: bool
        repositories: [
          'string'
        ]
      }
      version: 'string'
    }
    environmentReference: {
      name: 'string'
      version: 'string'
    }
    modelIds: [
      'string'
    ]
    models: [
      {
        createdTime: 'string'
        datasets: [
          {
            id: 'string'
            name: 'string'
          }
        ]
        derivedModelIds: [
          'string'
        ]
        description: 'string'
        experimentName: 'string'
        framework: 'string'
        frameworkVersion: 'string'
        id: 'string'
        kvTags: {}
        mimeType: 'string'
        modifiedTime: 'string'
        name: 'string'
        parentModelId: 'string'
        properties: {
          {customized property}: 'string'
        }
        resourceRequirements: {
          cpu: int
          fpga: int
          gpu: int
          memoryInGB: int
        }
        runId: 'string'
        sampleInputData: 'string'
        sampleOutputData: 'string'
        unpack: bool
        url: 'string'
        version: int
      }
    ]
  }
  keys: {
    primaryKey: 'string'
    secondaryKey: 'string'
  }
  kvTags: {}
  properties: {
    {customized property}: 'string'
  }
  computeType: 'string'
  // For remaining properties, see workspaces/services objects
}

объекты рабочих областей и служб

Задайте свойство computeType, чтобы указать тип объекта.

Для ACIиспользуйте:

  computeType: 'ACI'
  appInsightsEnabled: bool
  authEnabled: bool
  cname: 'string'
  containerResourceRequirements: {
    cpu: int
    fpga: int
    gpu: int
    memoryInGB: int
  }
  dataCollection: {
    eventHubEnabled: bool
    storageEnabled: bool
  }
  dnsNameLabel: 'string'
  encryptionProperties: {
    keyName: 'string'
    keyVersion: 'string'
    vaultBaseUrl: 'string'
  }
  sslCertificate: 'string'
  sslEnabled: bool
  sslKey: 'string'
  vnetConfiguration: {
    subnetName: 'string'
    vnetName: 'string'
  }

Для AKSиспользуйте:

  computeType: 'AKS'
  aadAuthEnabled: bool
  appInsightsEnabled: bool
  authEnabled: bool
  autoScaler: {
    autoscaleEnabled: bool
    maxReplicas: int
    minReplicas: int
    refreshPeriodInSeconds: int
    targetUtilization: int
  }
  computeName: 'string'
  containerResourceRequirements: {
    cpu: int
    fpga: int
    gpu: int
    memoryInGB: int
  }
  dataCollection: {
    eventHubEnabled: bool
    storageEnabled: bool
  }
  isDefault: bool
  livenessProbeRequirements: {
    failureThreshold: int
    initialDelaySeconds: int
    periodSeconds: int
    successThreshold: int
    timeoutSeconds: int
  }
  maxConcurrentRequestsPerContainer: int
  maxQueueWaitMs: int
  namespace: 'string'
  numReplicas: int
  scoringTimeoutMs: int
  trafficPercentile: int
  type: 'string'

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

рабочие области и службы

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

Узнайте, как задать имена и типы дочерних ресурсов в Bicep.
строка (обязательно)
местоположение Имя расположения или региона Azure. струна
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: рабочих областей
описание Описание службы. струна
environmentImageRequest Среда, модели и ресурсы, необходимые для вывода. CreateServiceRequestEnvironmentImageRequest
Ключи Ключи проверки подлинности. CreateServiceRequestKeys
kvTags Словарь тегов службы. Теги являются изменяемыми. объект
свойства Словарь свойств службы. Свойства неизменяемы. CreateServiceRequestProperties
computeType Установка типа объекта ACI
AKS (обязательно)

ACIServiceCreateRequest

Имя Описание Ценность
computeType Тип вычислительной среды для службы. ACI (обязательно)
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности в службе. bool
cname CName для службы. струна
containerResourceRequirements Требования к ресурсу контейнера. ContainerResourceRequirements
dataCollection Сведения о параметрах сбора данных, указанных. ACIServiceCreateRequestDataCollection
dnsNameLabel Метка DNS для службы. струна
encryptionProperties Свойства шифрования. ACIServiceCreateRequestEncryptionProperties
sslCertificate Общедоступный SSL-сертификат в формате PEM, используемый при включении SSL. струна
sslEnabled Включен ли протокол SSL. bool
sslKey Открытый SSL-ключ в формате PEM для сертификата. струна
vnetConfiguration Конфигурация виртуальной сети. ACIServiceCreateRequestVnetConfiguration

ContainerResourceRequirements

Имя Описание Ценность
ЦПУ Количество ядер ЦП в контейнере. int
fpga Количество устройств PCIE FPGA, предоставляемых контейнеру. Должно быть несколько из 2. int
Графический процессор Количество ядер GPU в контейнере. int
memoryInGB Объем памяти контейнера в ГБ. int

ACIServiceCreateRequestDataCollection

Имя Описание Ценность
eventHubEnabled Параметр включения и отключения концентратора событий. bool
storageEnabled Параметр включения и отключения хранилища. bool

ACIServiceCreateRequestEncryptionProperties

Имя Описание Ценность
keyName Имя ключа шифрования строка (обязательно)
keyVersion Версия ключа шифрования строка (обязательно)
vaultBaseUrl Базовый URL-адрес хранилища строка (обязательно)

ACIServiceCreateRequestVnetConfiguration

Имя Описание Ценность
subnetName Имя подсети виртуальной сети. струна
имя виртуальной сети Имя виртуальной сети. струна

AKSServiceCreateRequest

Имя Описание Ценность
computeType Тип вычислительной среды для службы. AKS (обязательно)
aadAuthEnabled Включена ли проверка подлинности AAD. bool
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности. bool
autoScaler Свойства автомасштабирования. AKSServiceCreateRequestAutoScaler
computeName Имя вычислительного ресурса. струна
containerResourceRequirements Требования к ресурсу контейнера. ContainerResourceRequirements
dataCollection Сведения о параметрах сбора данных, указанных. AKSServiceCreateRequestDataCollection
isDefault Это вариант по умолчанию. bool
livenessProbeRequirements Требования к пробе активности. AKSServiceCreateRequestLivenessProbeRequirements
maxConcurrentRequestsPerContainer Максимальное количество одновременных запросов на контейнер. int
maxQueueWaitMs Максимальное время, когда запрос будет ждать в очереди (в миллисекундах). После этого служба вернет 503 (служба недоступна) int
пространство имен Пространство имен Kubernetes для службы. струна
numReplicas Количество реплик в кластере. int
оценкаTimeoutMs Время ожидания оценки в миллисекундах. int
trafficPercentile Количество получаемых вариантов трафика. int
тип Тип варианта. Control
"Лечение"

AKSServiceCreateRequestAutoScaler

Имя Описание Ценность
autoscaleEnabled Параметр включения и отключения автоматического масштабирования. bool
maxReplicas Максимальное количество реплик в кластере. int
minReplicas Минимальное количество реплик для уменьшения масштаба. int
refreshPeriodInSeconds Количество секунд, ожидаемых между автоматическим масштабированием обновлений. int
targetUtilization Процент целевого использования, используемый для определения того, следует ли масштабировать кластер. int

AKSServiceCreateRequestDataCollection

Имя Описание Ценность
eventHubEnabled Параметр включения и отключения концентратора событий. bool
storageEnabled Параметр включения и отключения хранилища. bool

AKSServiceCreateRequestLivenessProbeRequirements

Имя Описание Ценность
failureThreshold Количество сбоев, которые необходимо разрешить, прежде чем возвращать неработоспособное состояние. int
initialDelaySeconds Задержка до первой пробы в секундах. int
periodSeconds Продолжительность времени между пробами в секундах. int
successThreshold Количество успешных проб перед возвратом работоспособного состояния. int
timeoutSeconds Время ожидания пробы в секундах. int

CreateServiceRequestEnvironmentImageRequest

Имя Описание Ценность
авуары Список ресурсов. ImageAsset[]
driverProgram Имя файла драйвера. струна
окружающая среда Сведения о среде машинного обучения Azure. EnvironmentImageRequestEnvironment
environmentReference Уникальные сведения об идентификации среды машинного обучения Azure. EnvironmentImageRequestEnvironmentReference
modelIds Список идентификаторов модели. string[]
Модели Список моделей. модели[]

ImageAsset

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
mimeType Тип mime. струна
распаковывать Является ли ресурс распакованным. bool
URL-адрес URL-адрес ресурса. струна

EnvironmentImageRequestEnvironment

Имя Описание Ценность
докер Определение контейнера Docker. ModelEnvironmentDefinitionDocker
environmentVariables Определение переменных среды, которые необходимо определить в среде. ModelEnvironmentDefinitionEnvironmentVariables
inferencingStackVersion Версия стека вывода, добавленная в образ. Чтобы избежать добавления стека вывода, не устанавливайте это значение. Допустимые значения: "latest". струна
имя Имя среды. струна
питон Параметры среды Python. ModelEnvironmentDefinitionPython
r Параметры среды R. ModelEnvironmentDefinitionR
искра Конфигурация среды Spark. ModelEnvironmentDefinitionSpark
Версия Версия среды. струна

ModelEnvironmentDefinitionDocker

Имя Описание Ценность
baseDockerfile Базовый файл Dockerfile, используемый для запусков на основе Docker. Взаимоисключающе с BaseImage. струна
baseImage Базовый образ, используемый для запусков на основе Docker. Взаимоисключающ с BaseDockerfile. струна
baseImageRegistry Реестр образов, содержащий базовый образ. ModelDockerSectionBaseImageRegistry

ModelDockerSectionBaseImageRegistry

Имя Описание Ценность
адрес струна
пароль струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
имя пользователя струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.

ModelEnvironmentDefinitionEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

ModelEnvironmentDefinitionPython

Имя Описание Ценность
baseCondaEnvironment струна
condaDependencies Объект JObject, содержащий зависимости Conda. Для Bicep можно использовать функцию any().
интерпретаторPath Путь интерпретатора Python, используемый, если сборка среды не требуется. Указанный путь используется для вызова пользовательского скрипта. струна
userManagedDependencies True означает, что AzureML повторно использует существующую среду Python; False означает, что AzureML создаст среду Python на основе спецификации зависимостей Conda. bool

ModelEnvironmentDefinitionR

Имя Описание Ценность
bioConductorPackages Пакеты из Bioconductor. string[]
cranPackages Используемые пакеты CRAN. RCranPackage[]
customUrlPackages Пакеты из пользовательских URL-адресов. string[]
gitHubPackages Пакеты непосредственно из GitHub. RGitHubPackage[]
rscriptPath Путь Rscript для использования, если сборка среды не требуется.
Указанный путь используется для вызова пользовательского скрипта.
струна
rVersion Установленная версия R струна
Моментальный снимок Дата создания моментального снимка MRAN для использования в формате ггГГ-MM-DD, например "2019-04-17" струна
userManaged Указывает, управляется ли среда пользователем или AzureML. bool

RCranPackage

Имя Описание Ценность
имя Имя пакета. струна
хранилище Имя репозитория. струна

RGitHubPackage

Имя Описание Ценность
authToken Личный маркер доступа для установки из частного репозитория струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
хранилище Адрес репозитория в формате имени пользователя/репозитория[/subdir][@ref,#pull]. струна

ModelEnvironmentDefinitionSpark

Имя Описание Ценность
Пакеты Используемые пакеты Spark. SparkMavenPackage[]
precachePackages Следует ли прикрашивать пакеты. bool
Репозитории Список репозиториев Spark. string[]

SparkMavenPackage

Имя Описание Ценность
артефакт струна
группа струна
Версия струна

EnvironmentImageRequestEnvironmentReference

Имя Описание Ценность
имя Имя среды. струна
Версия Версия среды. струна

Модель

Имя Описание Ценность
createdTime Время создания модели (UTC). струна
Наборов данных Список наборов данных, связанных с моделью. DatasetReference[]
производныеModelIds Модели, производные от этой модели string[]
описание Текст описания модели. струна
experimentName Имя эксперимента, в котором была создана эта модель. струна
каркас Платформа модели. струна
frameworkVersion Версия платформы модели. струна
идентификатор Идентификатор модели. струна
kvTags Словарь тегов модели. Элементы изменяются. объект
mimeType Тип MIME содержимого модели. Дополнительные сведения о типе MIME откройте https://www.iana.org/assignments/media-types/media-types.xhtml строка (обязательно)
modifiedTime Время последнего изменения модели (UTC). струна
имя Имя модели. строка (обязательно)
parentModelId Идентификатор родительской модели. струна
свойства Словарь свойств Model. Свойства неизменяемы. ModelProperties
resourceRequirements Требования к ресурсам для модели ContainerResourceRequirements
runId RunId, создавший эту модель. струна
sampleInputData Пример входных данных для модели. Ссылка на набор данных в рабочей области в формате aml://dataset/{datasetId} струна
sampleOutputData Пример выходных данных для модели. Ссылка на набор данных в рабочей области в формате aml://dataset/{datasetId} струна
распаковывать Указывает, нужно ли распаковывать модель во время создания образа Docker. bool
URL-адрес URL-адрес модели. Обычно URL-адрес SAS. строка (обязательно)
Версия Версия модели, назначенная службой управления моделями. int

DatasetReference

Имя Описание Ценность
идентификатор Идентификатор ссылки на набор данных. струна
имя Имя ссылки на набор данных. струна

ModelProperties

Имя Описание Ценность
{настраиваемое свойство} струна

CreateServiceRequestKeys

Имя Описание Ценность
primaryKey Первичный ключ. струна
secondaryKey Вторичный ключ. струна

CreateServiceRequestProperties

Имя Описание Ценность
{настраиваемое свойство} струна

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

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

Шаблон Описание
создание службы машинного обучения Azure

развертывание в Azure
Этот шаблон создает службу машинного обучения Azure.
создание службы машинного обучения Azure (AKS)

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

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

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

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

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

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

{
  "type": "Microsoft.MachineLearningServices/workspaces/services",
  "apiVersion": "2020-05-01-preview",
  "name": "string",
  "location": "string",
  "description": "string",
  "environmentImageRequest": {
    "assets": [
      {
        "id": "string",
        "mimeType": "string",
        "unpack": "bool",
        "url": "string"
      }
    ],
    "driverProgram": "string",
    "environment": {
      "docker": {
        "baseDockerfile": "string",
        "baseImage": "string",
        "baseImageRegistry": {
          "address": "string",
          "password": "string",
          "username": "string"
        }
      },
      "environmentVariables": {
        "{customized property}": "string"
      },
      "inferencingStackVersion": "string",
      "name": "string",
      "python": {
        "baseCondaEnvironment": "string",
        "condaDependencies": {},
        "interpreterPath": "string",
        "userManagedDependencies": "bool"
      },
      "r": {
        "bioConductorPackages": [ "string" ],
        "cranPackages": [
          {
            "name": "string",
            "repository": "string"
          }
        ],
        "customUrlPackages": [ "string" ],
        "gitHubPackages": [
          {
            "authToken": "string",
            "repository": "string"
          }
        ],
        "rscriptPath": "string",
        "rVersion": "string",
        "snapshotDate": "string",
        "userManaged": "bool"
      },
      "spark": {
        "packages": [
          {
            "artifact": "string",
            "group": "string",
            "version": "string"
          }
        ],
        "precachePackages": "bool",
        "repositories": [ "string" ]
      },
      "version": "string"
    },
    "environmentReference": {
      "name": "string",
      "version": "string"
    },
    "modelIds": [ "string" ],
    "models": [
      {
        "createdTime": "string",
        "datasets": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "derivedModelIds": [ "string" ],
        "description": "string",
        "experimentName": "string",
        "framework": "string",
        "frameworkVersion": "string",
        "id": "string",
        "kvTags": {},
        "mimeType": "string",
        "modifiedTime": "string",
        "name": "string",
        "parentModelId": "string",
        "properties": {
          "{customized property}": "string"
        },
        "resourceRequirements": {
          "cpu": "int",
          "fpga": "int",
          "gpu": "int",
          "memoryInGB": "int"
        },
        "runId": "string",
        "sampleInputData": "string",
        "sampleOutputData": "string",
        "unpack": "bool",
        "url": "string",
        "version": "int"
      }
    ]
  },
  "keys": {
    "primaryKey": "string",
    "secondaryKey": "string"
  },
  "kvTags": {},
  "properties": {
    "{customized property}": "string"
  },
  "computeType": "string"
  // For remaining properties, see workspaces/services objects
}

объекты рабочих областей и служб

Задайте свойство computeType, чтобы указать тип объекта.

Для ACIиспользуйте:

  "computeType": "ACI",
  "appInsightsEnabled": "bool",
  "authEnabled": "bool",
  "cname": "string",
  "containerResourceRequirements": {
    "cpu": "int",
    "fpga": "int",
    "gpu": "int",
    "memoryInGB": "int"
  },
  "dataCollection": {
    "eventHubEnabled": "bool",
    "storageEnabled": "bool"
  },
  "dnsNameLabel": "string",
  "encryptionProperties": {
    "keyName": "string",
    "keyVersion": "string",
    "vaultBaseUrl": "string"
  },
  "sslCertificate": "string",
  "sslEnabled": "bool",
  "sslKey": "string",
  "vnetConfiguration": {
    "subnetName": "string",
    "vnetName": "string"
  }

Для AKSиспользуйте:

  "computeType": "AKS",
  "aadAuthEnabled": "bool",
  "appInsightsEnabled": "bool",
  "authEnabled": "bool",
  "autoScaler": {
    "autoscaleEnabled": "bool",
    "maxReplicas": "int",
    "minReplicas": "int",
    "refreshPeriodInSeconds": "int",
    "targetUtilization": "int"
  },
  "computeName": "string",
  "containerResourceRequirements": {
    "cpu": "int",
    "fpga": "int",
    "gpu": "int",
    "memoryInGB": "int"
  },
  "dataCollection": {
    "eventHubEnabled": "bool",
    "storageEnabled": "bool"
  },
  "isDefault": "bool",
  "livenessProbeRequirements": {
    "failureThreshold": "int",
    "initialDelaySeconds": "int",
    "periodSeconds": "int",
    "successThreshold": "int",
    "timeoutSeconds": "int"
  },
  "maxConcurrentRequestsPerContainer": "int",
  "maxQueueWaitMs": "int",
  "namespace": "string",
  "numReplicas": "int",
  "scoringTimeoutMs": "int",
  "trafficPercentile": "int",
  "type": "string"

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

рабочие области и службы

Имя Описание Ценность
тип Тип ресурса "Microsoft.MachineLearningServices/workspaces/services"
apiVersion Версия API ресурсов '2020-05-01-preview'
имя Имя ресурса

Узнайте, как задать имена и типы дочерних ресурсов в шаблонах ARM JSON.
строка (обязательно)
местоположение Имя расположения или региона Azure. струна
описание Описание службы. струна
environmentImageRequest Среда, модели и ресурсы, необходимые для вывода. CreateServiceRequestEnvironmentImageRequest
Ключи Ключи проверки подлинности. CreateServiceRequestKeys
kvTags Словарь тегов службы. Теги являются изменяемыми. объект
свойства Словарь свойств службы. Свойства неизменяемы. CreateServiceRequestProperties
computeType Установка типа объекта ACI
AKS (обязательно)

ACIServiceCreateRequest

Имя Описание Ценность
computeType Тип вычислительной среды для службы. ACI (обязательно)
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности в службе. bool
cname CName для службы. струна
containerResourceRequirements Требования к ресурсу контейнера. ContainerResourceRequirements
dataCollection Сведения о параметрах сбора данных, указанных. ACIServiceCreateRequestDataCollection
dnsNameLabel Метка DNS для службы. струна
encryptionProperties Свойства шифрования. ACIServiceCreateRequestEncryptionProperties
sslCertificate Общедоступный SSL-сертификат в формате PEM, используемый при включении SSL. струна
sslEnabled Включен ли протокол SSL. bool
sslKey Открытый SSL-ключ в формате PEM для сертификата. струна
vnetConfiguration Конфигурация виртуальной сети. ACIServiceCreateRequestVnetConfiguration

ContainerResourceRequirements

Имя Описание Ценность
ЦПУ Количество ядер ЦП в контейнере. int
fpga Количество устройств PCIE FPGA, предоставляемых контейнеру. Должно быть несколько из 2. int
Графический процессор Количество ядер GPU в контейнере. int
memoryInGB Объем памяти контейнера в ГБ. int

ACIServiceCreateRequestDataCollection

Имя Описание Ценность
eventHubEnabled Параметр включения и отключения концентратора событий. bool
storageEnabled Параметр включения и отключения хранилища. bool

ACIServiceCreateRequestEncryptionProperties

Имя Описание Ценность
keyName Имя ключа шифрования строка (обязательно)
keyVersion Версия ключа шифрования строка (обязательно)
vaultBaseUrl Базовый URL-адрес хранилища строка (обязательно)

ACIServiceCreateRequestVnetConfiguration

Имя Описание Ценность
subnetName Имя подсети виртуальной сети. струна
имя виртуальной сети Имя виртуальной сети. струна

AKSServiceCreateRequest

Имя Описание Ценность
computeType Тип вычислительной среды для службы. AKS (обязательно)
aadAuthEnabled Включена ли проверка подлинности AAD. bool
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности. bool
autoScaler Свойства автомасштабирования. AKSServiceCreateRequestAutoScaler
computeName Имя вычислительного ресурса. струна
containerResourceRequirements Требования к ресурсу контейнера. ContainerResourceRequirements
dataCollection Сведения о параметрах сбора данных, указанных. AKSServiceCreateRequestDataCollection
isDefault Это вариант по умолчанию. bool
livenessProbeRequirements Требования к пробе активности. AKSServiceCreateRequestLivenessProbeRequirements
maxConcurrentRequestsPerContainer Максимальное количество одновременных запросов на контейнер. int
maxQueueWaitMs Максимальное время, когда запрос будет ждать в очереди (в миллисекундах). После этого служба вернет 503 (служба недоступна) int
пространство имен Пространство имен Kubernetes для службы. струна
numReplicas Количество реплик в кластере. int
оценкаTimeoutMs Время ожидания оценки в миллисекундах. int
trafficPercentile Количество получаемых вариантов трафика. int
тип Тип варианта. Control
"Лечение"

AKSServiceCreateRequestAutoScaler

Имя Описание Ценность
autoscaleEnabled Параметр включения и отключения автоматического масштабирования. bool
maxReplicas Максимальное количество реплик в кластере. int
minReplicas Минимальное количество реплик для уменьшения масштаба. int
refreshPeriodInSeconds Количество секунд, ожидаемых между автоматическим масштабированием обновлений. int
targetUtilization Процент целевого использования, используемый для определения того, следует ли масштабировать кластер. int

AKSServiceCreateRequestDataCollection

Имя Описание Ценность
eventHubEnabled Параметр включения и отключения концентратора событий. bool
storageEnabled Параметр включения и отключения хранилища. bool

AKSServiceCreateRequestLivenessProbeRequirements

Имя Описание Ценность
failureThreshold Количество сбоев, которые необходимо разрешить, прежде чем возвращать неработоспособное состояние. int
initialDelaySeconds Задержка до первой пробы в секундах. int
periodSeconds Продолжительность времени между пробами в секундах. int
successThreshold Количество успешных проб перед возвратом работоспособного состояния. int
timeoutSeconds Время ожидания пробы в секундах. int

CreateServiceRequestEnvironmentImageRequest

Имя Описание Ценность
авуары Список ресурсов. ImageAsset[]
driverProgram Имя файла драйвера. струна
окружающая среда Сведения о среде машинного обучения Azure. EnvironmentImageRequestEnvironment
environmentReference Уникальные сведения об идентификации среды машинного обучения Azure. EnvironmentImageRequestEnvironmentReference
modelIds Список идентификаторов модели. string[]
Модели Список моделей. модели[]

ImageAsset

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
mimeType Тип mime. струна
распаковывать Является ли ресурс распакованным. bool
URL-адрес URL-адрес ресурса. струна

EnvironmentImageRequestEnvironment

Имя Описание Ценность
докер Определение контейнера Docker. ModelEnvironmentDefinitionDocker
environmentVariables Определение переменных среды, которые необходимо определить в среде. ModelEnvironmentDefinitionEnvironmentVariables
inferencingStackVersion Версия стека вывода, добавленная в образ. Чтобы избежать добавления стека вывода, не устанавливайте это значение. Допустимые значения: "latest". струна
имя Имя среды. струна
питон Параметры среды Python. ModelEnvironmentDefinitionPython
r Параметры среды R. ModelEnvironmentDefinitionR
искра Конфигурация среды Spark. ModelEnvironmentDefinitionSpark
Версия Версия среды. струна

ModelEnvironmentDefinitionDocker

Имя Описание Ценность
baseDockerfile Базовый файл Dockerfile, используемый для запусков на основе Docker. Взаимоисключающе с BaseImage. струна
baseImage Базовый образ, используемый для запусков на основе Docker. Взаимоисключающ с BaseDockerfile. струна
baseImageRegistry Реестр образов, содержащий базовый образ. ModelDockerSectionBaseImageRegistry

ModelDockerSectionBaseImageRegistry

Имя Описание Ценность
адрес струна
пароль струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
имя пользователя струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.

ModelEnvironmentDefinitionEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

ModelEnvironmentDefinitionPython

Имя Описание Ценность
baseCondaEnvironment струна
condaDependencies Объект JObject, содержащий зависимости Conda.
интерпретаторPath Путь интерпретатора Python, используемый, если сборка среды не требуется. Указанный путь используется для вызова пользовательского скрипта. струна
userManagedDependencies True означает, что AzureML повторно использует существующую среду Python; False означает, что AzureML создаст среду Python на основе спецификации зависимостей Conda. bool

ModelEnvironmentDefinitionR

Имя Описание Ценность
bioConductorPackages Пакеты из Bioconductor. string[]
cranPackages Используемые пакеты CRAN. RCranPackage[]
customUrlPackages Пакеты из пользовательских URL-адресов. string[]
gitHubPackages Пакеты непосредственно из GitHub. RGitHubPackage[]
rscriptPath Путь Rscript для использования, если сборка среды не требуется.
Указанный путь используется для вызова пользовательского скрипта.
струна
rVersion Установленная версия R струна
Моментальный снимок Дата создания моментального снимка MRAN для использования в формате ггГГ-MM-DD, например "2019-04-17" струна
userManaged Указывает, управляется ли среда пользователем или AzureML. bool

RCranPackage

Имя Описание Ценность
имя Имя пакета. струна
хранилище Имя репозитория. струна

RGitHubPackage

Имя Описание Ценность
authToken Личный маркер доступа для установки из частного репозитория струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
хранилище Адрес репозитория в формате имени пользователя/репозитория[/subdir][@ref,#pull]. струна

ModelEnvironmentDefinitionSpark

Имя Описание Ценность
Пакеты Используемые пакеты Spark. SparkMavenPackage[]
precachePackages Следует ли прикрашивать пакеты. bool
Репозитории Список репозиториев Spark. string[]

SparkMavenPackage

Имя Описание Ценность
артефакт струна
группа струна
Версия струна

EnvironmentImageRequestEnvironmentReference

Имя Описание Ценность
имя Имя среды. струна
Версия Версия среды. струна

Модель

Имя Описание Ценность
createdTime Время создания модели (UTC). струна
Наборов данных Список наборов данных, связанных с моделью. DatasetReference[]
производныеModelIds Модели, производные от этой модели string[]
описание Текст описания модели. струна
experimentName Имя эксперимента, в котором была создана эта модель. струна
каркас Платформа модели. струна
frameworkVersion Версия платформы модели. струна
идентификатор Идентификатор модели. струна
kvTags Словарь тегов модели. Элементы изменяются. объект
mimeType Тип MIME содержимого модели. Дополнительные сведения о типе MIME откройте https://www.iana.org/assignments/media-types/media-types.xhtml строка (обязательно)
modifiedTime Время последнего изменения модели (UTC). струна
имя Имя модели. строка (обязательно)
parentModelId Идентификатор родительской модели. струна
свойства Словарь свойств Model. Свойства неизменяемы. ModelProperties
resourceRequirements Требования к ресурсам для модели ContainerResourceRequirements
runId RunId, создавший эту модель. струна
sampleInputData Пример входных данных для модели. Ссылка на набор данных в рабочей области в формате aml://dataset/{datasetId} струна
sampleOutputData Пример выходных данных для модели. Ссылка на набор данных в рабочей области в формате aml://dataset/{datasetId} струна
распаковывать Указывает, нужно ли распаковывать модель во время создания образа Docker. bool
URL-адрес URL-адрес модели. Обычно URL-адрес SAS. строка (обязательно)
Версия Версия модели, назначенная службой управления моделями. int

DatasetReference

Имя Описание Ценность
идентификатор Идентификатор ссылки на набор данных. струна
имя Имя ссылки на набор данных. струна

ModelProperties

Имя Описание Ценность
{настраиваемое свойство} струна

CreateServiceRequestKeys

Имя Описание Ценность
primaryKey Первичный ключ. струна
secondaryKey Вторичный ключ. струна

CreateServiceRequestProperties

Имя Описание Ценность
{настраиваемое свойство} струна

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

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

Шаблон Описание
создание службы машинного обучения Azure

развертывание в Azure
Этот шаблон создает службу машинного обучения Azure.
создание службы машинного обучения Azure (AKS)

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

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/services@2020-05-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  // For remaining properties, see workspaces/services objects
  body = jsonencode({
    description = "string"
    environmentImageRequest = {
      assets = [
        {
          id = "string"
          mimeType = "string"
          unpack = bool
          url = "string"
        }
      ]
      driverProgram = "string"
      environment = {
        docker = {
          baseDockerfile = "string"
          baseImage = "string"
          baseImageRegistry = {
            address = "string"
            password = "string"
            username = "string"
          }
        }
        environmentVariables = {
          {customized property} = "string"
        }
        inferencingStackVersion = "string"
        name = "string"
        python = {
          baseCondaEnvironment = "string"
          interpreterPath = "string"
          userManagedDependencies = bool
        }
        r = {
          bioConductorPackages = [
            "string"
          ]
          cranPackages = [
            {
              name = "string"
              repository = "string"
            }
          ]
          customUrlPackages = [
            "string"
          ]
          gitHubPackages = [
            {
              authToken = "string"
              repository = "string"
            }
          ]
          rscriptPath = "string"
          rVersion = "string"
          snapshotDate = "string"
          userManaged = bool
        }
        spark = {
          packages = [
            {
              artifact = "string"
              group = "string"
              version = "string"
            }
          ]
          precachePackages = bool
          repositories = [
            "string"
          ]
        }
        version = "string"
      }
      environmentReference = {
        name = "string"
        version = "string"
      }
      modelIds = [
        "string"
      ]
      models = [
        {
          createdTime = "string"
          datasets = [
            {
              id = "string"
              name = "string"
            }
          ]
          derivedModelIds = [
            "string"
          ]
          description = "string"
          experimentName = "string"
          framework = "string"
          frameworkVersion = "string"
          id = "string"
          kvTags = {}
          mimeType = "string"
          modifiedTime = "string"
          name = "string"
          parentModelId = "string"
          properties = {
            {customized property} = "string"
          }
          resourceRequirements = {
            cpu = int
            fpga = int
            gpu = int
            memoryInGB = int
          }
          runId = "string"
          sampleInputData = "string"
          sampleOutputData = "string"
          unpack = bool
          url = "string"
          version = int
        }
      ]
    }
    keys = {
      primaryKey = "string"
      secondaryKey = "string"
    }
    kvTags = {}
    body = jsonencode({
    properties = {
      {customized property} = "string"
    }
    computeType = "string"
  })
}

объекты рабочих областей и служб

Задайте свойство computeType, чтобы указать тип объекта.

Для ACIиспользуйте:

  computeType = "ACI"
  appInsightsEnabled = bool
  authEnabled = bool
  cname = "string"
  containerResourceRequirements = {
    cpu = int
    fpga = int
    gpu = int
    memoryInGB = int
  }
  dataCollection = {
    eventHubEnabled = bool
    storageEnabled = bool
  }
  dnsNameLabel = "string"
  encryptionProperties = {
    keyName = "string"
    keyVersion = "string"
    vaultBaseUrl = "string"
  }
  sslCertificate = "string"
  sslEnabled = bool
  sslKey = "string"
  vnetConfiguration = {
    subnetName = "string"
    vnetName = "string"
  }

Для AKSиспользуйте:

  computeType = "AKS"
  aadAuthEnabled = bool
  appInsightsEnabled = bool
  authEnabled = bool
  autoScaler = {
    autoscaleEnabled = bool
    maxReplicas = int
    minReplicas = int
    refreshPeriodInSeconds = int
    targetUtilization = int
  }
  computeName = "string"
  containerResourceRequirements = {
    cpu = int
    fpga = int
    gpu = int
    memoryInGB = int
  }
  dataCollection = {
    eventHubEnabled = bool
    storageEnabled = bool
  }
  isDefault = bool
  livenessProbeRequirements = {
    failureThreshold = int
    initialDelaySeconds = int
    periodSeconds = int
    successThreshold = int
    timeoutSeconds = int
  }
  maxConcurrentRequestsPerContainer = int
  maxQueueWaitMs = int
  namespace = "string"
  numReplicas = int
  scoringTimeoutMs = int
  trafficPercentile = int
  type = "string"

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

рабочие области и службы

Имя Описание Ценность
тип Тип ресурса "Microsoft.MachineLearningServices/workspaces/services@2020-05-01-preview"
имя Имя ресурса строка (обязательно)
местоположение Имя расположения или региона Azure. струна
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: рабочих областей
описание Описание службы. струна
environmentImageRequest Среда, модели и ресурсы, необходимые для вывода. CreateServiceRequestEnvironmentImageRequest
Ключи Ключи проверки подлинности. CreateServiceRequestKeys
kvTags Словарь тегов службы. Теги являются изменяемыми. объект
свойства Словарь свойств службы. Свойства неизменяемы. CreateServiceRequestProperties
computeType Установка типа объекта ACI
AKS (обязательно)

ACIServiceCreateRequest

Имя Описание Ценность
computeType Тип вычислительной среды для службы. ACI (обязательно)
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности в службе. bool
cname CName для службы. струна
containerResourceRequirements Требования к ресурсу контейнера. ContainerResourceRequirements
dataCollection Сведения о параметрах сбора данных, указанных. ACIServiceCreateRequestDataCollection
dnsNameLabel Метка DNS для службы. струна
encryptionProperties Свойства шифрования. ACIServiceCreateRequestEncryptionProperties
sslCertificate Общедоступный SSL-сертификат в формате PEM, используемый при включении SSL. струна
sslEnabled Включен ли протокол SSL. bool
sslKey Открытый SSL-ключ в формате PEM для сертификата. струна
vnetConfiguration Конфигурация виртуальной сети. ACIServiceCreateRequestVnetConfiguration

ContainerResourceRequirements

Имя Описание Ценность
ЦПУ Количество ядер ЦП в контейнере. int
fpga Количество устройств PCIE FPGA, предоставляемых контейнеру. Должно быть несколько из 2. int
Графический процессор Количество ядер GPU в контейнере. int
memoryInGB Объем памяти контейнера в ГБ. int

ACIServiceCreateRequestDataCollection

Имя Описание Ценность
eventHubEnabled Параметр включения и отключения концентратора событий. bool
storageEnabled Параметр включения и отключения хранилища. bool

ACIServiceCreateRequestEncryptionProperties

Имя Описание Ценность
keyName Имя ключа шифрования строка (обязательно)
keyVersion Версия ключа шифрования строка (обязательно)
vaultBaseUrl Базовый URL-адрес хранилища строка (обязательно)

ACIServiceCreateRequestVnetConfiguration

Имя Описание Ценность
subnetName Имя подсети виртуальной сети. струна
имя виртуальной сети Имя виртуальной сети. струна

AKSServiceCreateRequest

Имя Описание Ценность
computeType Тип вычислительной среды для службы. "AKS" (обязательно)
aadAuthEnabled Включена ли проверка подлинности AAD. bool
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности. bool
autoScaler Свойства автомасштабирования. AKSServiceCreateRequestAutoScaler
computeName Имя вычислительного ресурса. струна
containerResourceRequirements Требования к ресурсу контейнера. ContainerResourceRequirements
dataCollection Сведения о параметрах сбора данных, указанных. AKSServiceCreateRequestDataCollection
isDefault Это вариант по умолчанию. bool
livenessProbeRequirements Требования к пробе активности. AKSServiceCreateRequestLivenessProbeRequirements
maxConcurrentRequestsPerContainer Максимальное количество одновременных запросов на контейнер. int
maxQueueWaitMs Максимальное время, когда запрос будет ждать в очереди (в миллисекундах). После этого служба вернет 503 (служба недоступна) int
пространство имен Пространство имен Kubernetes для службы. струна
numReplicas Количество реплик в кластере. int
оценкаTimeoutMs Время ожидания оценки в миллисекундах. int
trafficPercentile Количество получаемых вариантов трафика. int
тип Тип варианта. Элемент управления
"Лечение"

AKSServiceCreateRequestAutoScaler

Имя Описание Ценность
autoscaleEnabled Параметр включения и отключения автоматического масштабирования. bool
maxReplicas Максимальное количество реплик в кластере. int
minReplicas Минимальное количество реплик для уменьшения масштаба. int
refreshPeriodInSeconds Количество секунд, ожидаемых между автоматическим масштабированием обновлений. int
targetUtilization Процент целевого использования, используемый для определения того, следует ли масштабировать кластер. int

AKSServiceCreateRequestDataCollection

Имя Описание Ценность
eventHubEnabled Параметр включения и отключения концентратора событий. bool
storageEnabled Параметр включения и отключения хранилища. bool

AKSServiceCreateRequestLivenessProbeRequirements

Имя Описание Ценность
failureThreshold Количество сбоев, которые необходимо разрешить, прежде чем возвращать неработоспособное состояние. int
initialDelaySeconds Задержка до первой пробы в секундах. int
periodSeconds Продолжительность времени между пробами в секундах. int
successThreshold Количество успешных проб перед возвратом работоспособного состояния. int
timeoutSeconds Время ожидания пробы в секундах. int

CreateServiceRequestEnvironmentImageRequest

Имя Описание Ценность
авуары Список ресурсов. ImageAsset[]
driverProgram Имя файла драйвера. струна
окружающая среда Сведения о среде машинного обучения Azure. EnvironmentImageRequestEnvironment
environmentReference Уникальные сведения об идентификации среды машинного обучения Azure. EnvironmentImageRequestEnvironmentReference
modelIds Список идентификаторов модели. string[]
Модели Список моделей. модели[]

ImageAsset

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
mimeType Тип mime. струна
распаковывать Является ли ресурс распакованным. bool
URL-адрес URL-адрес ресурса. струна

EnvironmentImageRequestEnvironment

Имя Описание Ценность
докер Определение контейнера Docker. ModelEnvironmentDefinitionDocker
environmentVariables Определение переменных среды, которые необходимо определить в среде. ModelEnvironmentDefinitionEnvironmentVariables
inferencingStackVersion Версия стека вывода, добавленная в образ. Чтобы избежать добавления стека вывода, не устанавливайте это значение. Допустимые значения: "latest". струна
имя Имя среды. струна
питон Параметры среды Python. ModelEnvironmentDefinitionPython
r Параметры среды R. ModelEnvironmentDefinitionR
искра Конфигурация среды Spark. ModelEnvironmentDefinitionSpark
Версия Версия среды. струна

ModelEnvironmentDefinitionDocker

Имя Описание Ценность
baseDockerfile Базовый файл Dockerfile, используемый для запусков на основе Docker. Взаимоисключающе с BaseImage. струна
baseImage Базовый образ, используемый для запусков на основе Docker. Взаимоисключающ с BaseDockerfile. струна
baseImageRegistry Реестр образов, содержащий базовый образ. ModelDockerSectionBaseImageRegistry

ModelDockerSectionBaseImageRegistry

Имя Описание Ценность
адрес струна
пароль струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
имя пользователя струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.

ModelEnvironmentDefinitionEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

ModelEnvironmentDefinitionPython

Имя Описание Ценность
baseCondaEnvironment струна
condaDependencies Объект JObject, содержащий зависимости Conda.
интерпретаторPath Путь интерпретатора Python, используемый, если сборка среды не требуется. Указанный путь используется для вызова пользовательского скрипта. струна
userManagedDependencies True означает, что AzureML повторно использует существующую среду Python; False означает, что AzureML создаст среду Python на основе спецификации зависимостей Conda. bool

ModelEnvironmentDefinitionR

Имя Описание Ценность
bioConductorPackages Пакеты из Bioconductor. string[]
cranPackages Используемые пакеты CRAN. RCranPackage[]
customUrlPackages Пакеты из пользовательских URL-адресов. string[]
gitHubPackages Пакеты непосредственно из GitHub. RGitHubPackage[]
rscriptPath Путь Rscript для использования, если сборка среды не требуется.
Указанный путь используется для вызова пользовательского скрипта.
струна
rVersion Установленная версия R струна
Моментальный снимок Дата создания моментального снимка MRAN для использования в формате ггГГ-MM-DD, например "2019-04-17" струна
userManaged Указывает, управляется ли среда пользователем или AzureML. bool

RCranPackage

Имя Описание Ценность
имя Имя пакета. струна
хранилище Имя репозитория. струна

RGitHubPackage

Имя Описание Ценность
authToken Личный маркер доступа для установки из частного репозитория струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
хранилище Адрес репозитория в формате имени пользователя/репозитория[/subdir][@ref,#pull]. струна

ModelEnvironmentDefinitionSpark

Имя Описание Ценность
Пакеты Используемые пакеты Spark. SparkMavenPackage[]
precachePackages Следует ли прикрашивать пакеты. bool
Репозитории Список репозиториев Spark. string[]

SparkMavenPackage

Имя Описание Ценность
артефакт струна
группа струна
Версия струна

EnvironmentImageRequestEnvironmentReference

Имя Описание Ценность
имя Имя среды. струна
Версия Версия среды. струна

Модель

Имя Описание Ценность
createdTime Время создания модели (UTC). струна
Наборов данных Список наборов данных, связанных с моделью. DatasetReference[]
производныеModelIds Модели, производные от этой модели string[]
описание Текст описания модели. струна
experimentName Имя эксперимента, в котором была создана эта модель. струна
каркас Платформа модели. струна
frameworkVersion Версия платформы модели. струна
идентификатор Идентификатор модели. струна
kvTags Словарь тегов модели. Элементы изменяются. объект
mimeType Тип MIME содержимого модели. Дополнительные сведения о типе MIME откройте https://www.iana.org/assignments/media-types/media-types.xhtml строка (обязательно)
modifiedTime Время последнего изменения модели (UTC). струна
имя Имя модели. строка (обязательно)
parentModelId Идентификатор родительской модели. струна
свойства Словарь свойств Model. Свойства неизменяемы. ModelProperties
resourceRequirements Требования к ресурсам для модели ContainerResourceRequirements
runId RunId, создавший эту модель. струна
sampleInputData Пример входных данных для модели. Ссылка на набор данных в рабочей области в формате aml://dataset/{datasetId} струна
sampleOutputData Пример выходных данных для модели. Ссылка на набор данных в рабочей области в формате aml://dataset/{datasetId} струна
распаковывать Указывает, нужно ли распаковывать модель во время создания образа Docker. bool
URL-адрес URL-адрес модели. Обычно URL-адрес SAS. строка (обязательно)
Версия Версия модели, назначенная службой управления моделями. int

DatasetReference

Имя Описание Ценность
идентификатор Идентификатор ссылки на набор данных. струна
имя Имя ссылки на набор данных. струна

ModelProperties

Имя Описание Ценность
{настраиваемое свойство} струна

CreateServiceRequestKeys

Имя Описание Ценность
primaryKey Первичный ключ. струна
secondaryKey Вторичный ключ. струна

CreateServiceRequestProperties

Имя Описание Ценность
{настраиваемое свойство} струна