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


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

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

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

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

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

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/services@2020-09-01-preview' = {
  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(Azure.Bicep.Types.Concrete.AnyType)
        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: {
          {customized property}: 'string'
        }
        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: {
    {customized property}: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    {customized property}: 'string'
  }
  computeType: 'string'
  // For remaining properties, see Microsoft.MachineLearningServices/workspaces/services objects
}

Объекты Microsoft.MachineLearningServices/workspaces/services

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

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

{
  appInsightsEnabled: bool
  authEnabled: bool
  cname: 'string'
  computeType: 'ACI'
  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используйте:

{
  aadAuthEnabled: bool
  appInsightsEnabled: bool
  authEnabled: bool
  autoScaler: {
    autoscaleEnabled: bool
    maxReplicas: int
    minReplicas: int
    refreshPeriodInSeconds: int
    targetUtilization: int
  }
  computeName: 'string'
  computeType: 'AKS'
  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'
}

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

ACIServiceCreateRequest

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

ACIServiceCreateRequestDataCollection

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

ACIServiceCreateRequestEncryptionProperties

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

ACIServiceCreateRequestVnetConfiguration

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

AKSServiceCreateRequest

Имя Описание Ценность
aadAuthEnabled Включена ли проверка подлинности AAD. bool
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности. bool
autoScaler Свойства автомасштабирования. AKSServiceCreateRequestAutoScaler
computeName Имя вычислительного ресурса. струна
computeType Тип вычислительной среды для службы. AKS (обязательно)
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

ContainerResourceRequirements

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

CreateServiceRequestEnvironmentImageRequest

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

CreateServiceRequestKeys

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

CreateServiceRequestKvTags

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

CreateServiceRequestProperties

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

DatasetReference

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

EnvironmentImageRequestEnvironment

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

EnvironmentImageRequestEnvironmentReference

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

ImageAsset

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

Microsoft.MachineLearningServices/workspaces/services

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

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

Модель

Имя Описание Ценность
createdTime Время создания модели (UTC). струна
Наборов данных Список наборов данных, связанных с моделью. DatasetReference[]
производныеModelIds Модели, производные от этой модели string[]
описание Текст описания модели. струна
experimentName Имя эксперимента, в котором была создана эта модель. струна
каркас Платформа модели. струна
frameworkVersion Версия платформы модели. струна
идентификатор Идентификатор модели. струна
kvTags Словарь тегов модели. Элементы изменяются. ModelKvTags
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

ModelDockerSectionBaseImageRegistry

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

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

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

ModelEnvironmentDefinitionDocker

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

ModelEnvironmentDefinitionSpark

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

ModelKvTags

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

ModelProperties

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

RCranPackage

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

RGitHubPackage

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

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

SparkMavenPackage

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

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

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

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

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

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

{
  "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": {
          "{customized property}": "string"
        },
        "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": {
    "{customized property}": "string"
  },
  "location": "string",
  "name": "string",
  "properties": {
    "{customized property}": "string"
  },
  "computeType": "string"
  // For remaining properties, see Microsoft.MachineLearningServices/workspaces/services objects
}

Объекты Microsoft.MachineLearningServices/workspaces/services

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

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

{
  "appInsightsEnabled": "bool",
  "authEnabled": "bool",
  "cname": "string",
  "computeType": "ACI",
  "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используйте:

{
  "aadAuthEnabled": "bool",
  "appInsightsEnabled": "bool",
  "authEnabled": "bool",
  "autoScaler": {
    "autoscaleEnabled": "bool",
    "maxReplicas": "int",
    "minReplicas": "int",
    "refreshPeriodInSeconds": "int",
    "targetUtilization": "int"
  },
  "computeName": "string",
  "computeType": "AKS",
  "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"
}

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

ACIServiceCreateRequest

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

ACIServiceCreateRequestDataCollection

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

ACIServiceCreateRequestEncryptionProperties

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

ACIServiceCreateRequestVnetConfiguration

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

AKSServiceCreateRequest

Имя Описание Ценность
aadAuthEnabled Включена ли проверка подлинности AAD. bool
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности. bool
autoScaler Свойства автомасштабирования. AKSServiceCreateRequestAutoScaler
computeName Имя вычислительного ресурса. струна
computeType Тип вычислительной среды для службы. AKS (обязательно)
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

ContainerResourceRequirements

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

CreateServiceRequestEnvironmentImageRequest

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

CreateServiceRequestKeys

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

CreateServiceRequestKvTags

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

CreateServiceRequestProperties

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

DatasetReference

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

EnvironmentImageRequestEnvironment

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

EnvironmentImageRequestEnvironmentReference

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

ImageAsset

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

Microsoft.MachineLearningServices/workspaces/services

Имя Описание Ценность
apiVersion Версия API '2020-09-01-preview'
computeType Установите значение ACI для типа ACIServiceCreateRequest. Установите значение AKS для типа AKSServiceCreateRequest. ACI
AKS (обязательно)
описание Описание службы. струна
environmentImageRequest Среда, модели и ресурсы, необходимые для вывода. CreateServiceRequestEnvironmentImageRequest
Ключи Ключи проверки подлинности. CreateServiceRequestKeys
kvTags Словарь тегов службы. Теги являются изменяемыми. CreateServiceRequestKvTags
местоположение Имя расположения или региона Azure. струна
имя Имя ресурса строка (обязательно)
свойства Словарь свойств службы. Свойства неизменяемы. CreateServiceRequestProperties
тип Тип ресурса "Microsoft.MachineLearningServices/workspaces/services"

Модель

Имя Описание Ценность
createdTime Время создания модели (UTC). струна
Наборов данных Список наборов данных, связанных с моделью. DatasetReference[]
производныеModelIds Модели, производные от этой модели string[]
описание Текст описания модели. струна
experimentName Имя эксперимента, в котором была создана эта модель. струна
каркас Платформа модели. струна
frameworkVersion Версия платформы модели. струна
идентификатор Идентификатор модели. струна
kvTags Словарь тегов модели. Элементы изменяются. ModelKvTags
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

ModelDockerSectionBaseImageRegistry

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

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

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

ModelEnvironmentDefinitionDocker

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

ModelEnvironmentDefinitionSpark

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

ModelKvTags

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

ModelProperties

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

RCranPackage

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

RGitHubPackage

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

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

SparkMavenPackage

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

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

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

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

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

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

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  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 = {
          {customized property} = "string"
        }
        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 = {
    {customized property} = "string"
  }
  location = "string"
  name = "string"
  properties = {
    {customized property} = "string"
  }
  computeType = "string"
  // For remaining properties, see Microsoft.MachineLearningServices/workspaces/services objects
}

Объекты Microsoft.MachineLearningServices/workspaces/services

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

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

{
  appInsightsEnabled = bool
  authEnabled = bool
  cname = "string"
  computeType = "ACI"
  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используйте:

{
  aadAuthEnabled = bool
  appInsightsEnabled = bool
  authEnabled = bool
  autoScaler = {
    autoscaleEnabled = bool
    maxReplicas = int
    minReplicas = int
    refreshPeriodInSeconds = int
    targetUtilization = int
  }
  computeName = "string"
  computeType = "AKS"
  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"
}

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

ACIServiceCreateRequest

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

ACIServiceCreateRequestDataCollection

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

ACIServiceCreateRequestEncryptionProperties

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

ACIServiceCreateRequestVnetConfiguration

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

AKSServiceCreateRequest

Имя Описание Ценность
aadAuthEnabled Включена ли проверка подлинности AAD. bool
appInsightsEnabled Включена ли Application Insights. bool
authEnabled Включена ли проверка подлинности. bool
autoScaler Свойства автомасштабирования. AKSServiceCreateRequestAutoScaler
computeName Имя вычислительного ресурса. струна
computeType Тип вычислительной среды для службы. AKS (обязательно)
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

ContainerResourceRequirements

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

CreateServiceRequestEnvironmentImageRequest

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

CreateServiceRequestKeys

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

CreateServiceRequestKvTags

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

CreateServiceRequestProperties

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

DatasetReference

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

EnvironmentImageRequestEnvironment

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

EnvironmentImageRequestEnvironmentReference

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

ImageAsset

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

Microsoft.MachineLearningServices/workspaces/services

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

Модель

Имя Описание Ценность
createdTime Время создания модели (UTC). струна
Наборов данных Список наборов данных, связанных с моделью. DatasetReference[]
производныеModelIds Модели, производные от этой модели string[]
описание Текст описания модели. струна
experimentName Имя эксперимента, в котором была создана эта модель. струна
каркас Платформа модели. струна
frameworkVersion Версия платформы модели. струна
идентификатор Идентификатор модели. струна
kvTags Словарь тегов модели. Элементы изменяются. ModelKvTags
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

ModelDockerSectionBaseImageRegistry

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

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

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

ModelEnvironmentDefinitionDocker

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

ModelEnvironmentDefinitionSpark

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

ModelKvTags

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

ModelProperties

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

RCranPackage

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

RGitHubPackage

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

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

SparkMavenPackage

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