Áreas de trabalho Microsoft.MachineLearningServices 2023-08-01-preview

Definição de recurso do Bicep

O tipo de recurso das áreas de trabalho pode ser implementado com operações que visam:

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces@2023-08-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
    {customized property}: 'string'
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    allowPublicAccessWhenBehindVnet: bool
    applicationInsights: 'string'
    associatedWorkspaces: [
      'string'
    ]
    containerRegistries: [
      'string'
    ]
    containerRegistry: 'string'
    description: 'string'
    discoveryUrl: 'string'
    enableDataIsolation: bool
    encryption: {
      cosmosDbResourceId: 'string'
      identity: {
        userAssignedIdentity: 'string'
      }
      keyVaultProperties: {
        identityClientId: 'string'
        keyIdentifier: 'string'
        keyVaultArmId: 'string'
      }
      searchAccountResourceId: 'string'
      status: 'string'
      storageAccountResourceId: 'string'
    }
    existingWorkspaces: [
      'string'
    ]
    featureStoreSettings: {
      computeRuntime: {
        sparkRuntimeVersion: 'string'
      }
      offlineStoreConnectionName: 'string'
      onlineStoreConnectionName: 'string'
    }
    friendlyName: 'string'
    hbiWorkspace: bool
    hubResourceId: 'string'
    imageBuildCompute: 'string'
    keyVault: 'string'
    keyVaults: [
      'string'
    ]
    managedNetwork: {
      isolationMode: 'string'
      outboundRules: {
        {customized property}: {
          category: 'string'
          status: 'string'
          type: 'string'
          // For remaining properties, see OutboundRule objects
        }
      }
      status: {
        sparkReady: bool
        status: 'string'
      }
    }
    primaryUserAssignedIdentity: 'string'
    publicNetworkAccess: 'string'
    serverlessComputeSettings: {
      serverlessComputeCustomSubnet: 'string'
      serverlessComputeNoPublicIP: bool
    }
    serviceManagedResourcesSettings: {
      cosmosDb: {
        collectionsThroughput: int
      }
    }
    sharedPrivateLinkResources: [
      {
        name: 'string'
        properties: {
          groupId: 'string'
          privateLinkResourceId: 'string'
          requestMessage: 'string'
          status: 'string'
        }
      }
    ]
    softDeleteRetentionInDays: int
    storageAccount: 'string'
    storageAccounts: [
      'string'
    ]
    systemDatastoresAuthMode: 'string'
    v1LegacyMode: bool
    workspaceHubConfig: {
      additionalWorkspaceStorageAccounts: [
        'string'
      ]
      defaultWorkspaceResourceGroup: 'string'
    }
  }
}

Objetos OutboundRule

Defina a propriedade type para especificar o tipo de objeto.

Para FQDN, utilize:

  type: 'FQDN'
  destination: 'string'

Para PrivateEndpoint, utilize:

  type: 'PrivateEndpoint'
  destination: {
    serviceResourceId: 'string'
    sparkEnabled: bool
    sparkStatus: 'string'
    subresourceTarget: 'string'
  }

Para ServiceTag, utilize:

  type: 'ServiceTag'
  destination: {
    action: 'string'
    portRanges: 'string'
    protocol: 'string'
    serviceTag: 'string'
  }

Valores de propriedade

áreas de trabalho

Nome Descrição Valor
name O nome do recurso cadeia (obrigatório)

Limite de carateres: 3-33

Carateres válidos:
Alfanuméricos, hífenes e carateres de sublinhado.
localização cadeia (de carateres)
etiquetas Dicionário de {string} Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
sku Opcional. Este campo tem de ser implementado pelo RP porque o AML suporta mais do que uma camada SKU
tipo string
identidade Identidade de serviço gerida (identidades atribuídas pelo sistema e/ou pelo utilizador) ManagedServiceIdentity
propriedades Atributos adicionais da entidade. WorkspaceProperties (obrigatório)

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos). "Nenhum"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo utilizador associadas ao recurso. As chaves de dicionário userAssignedIdentities serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) nos pedidos. UserAssignedIdentities

UserAssignedIdentities

Nome Descrição Valor
{customized property} UserAssignedIdentity

UserAssignedIdentity

Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.

WorkspaceProperties

Nome Descrição Valor
allowPublicAccessWhenBehindVnet O sinalizador para indicar se deve permitir o acesso público atrás da VNet. bool
applicationInsights ID arm do application insights associado a esta área de trabalho. string
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry ID arm do registo de contentor associado a esta área de trabalho. string
descrição A descrição desta área de trabalho. string
discoveryUrl URL do serviço de deteção para identificar pontos finais regionais para serviços de experimentação de machine learning string
enableDataIsolation bool
Encriptação EncryptionProperty
existingWorkspaces string[]
featureStoreSettings Definições para a área de trabalho do tipo arquivo de funcionalidades. FeatureStoreSettings
friendlyName O nome amigável desta área de trabalho. Este nome é mutável string
hbiWorkspace O sinalizador para sinalizar dados HBI na área de trabalho e reduzir os dados de diagnóstico recolhidos pelo serviço bool
hubResourceId string
imageBuildCompute O nome de computação da compilação da imagem string
keyVault ID arm do cofre de chaves associado a esta área de trabalho. Isto não pode ser alterado depois de a área de trabalho ter sido criada string
keyVaults string[]
managedNetwork Definições de Rede Gerida para uma área de trabalho de machine learning. ManagedNetworkSettings
primaryUserAssignedIdentity O ID do recurso de identidade atribuído pelo utilizador que representa a identidade da área de trabalho. string
publicNetworkAccess Se os pedidos da Rede Pública são permitidos. "Desativado"
"Ativado"
serverlessComputeSettings Definições para computação sem servidor criadas na área de trabalho ServerlessComputeSettings
serviceManagedResourcesSettings As definições de recursos geridos pelo serviço. ServiceManagedResourcesSettings
sharedPrivateLinkResources A lista de recursos de ligação privada partilhados nesta área de trabalho. SharedPrivateLinkResource[]
softDeleteRetentionInDays Tempo de retenção em dias após a eliminação recuperável da área de trabalho. int
storageAccount ID arm da conta de armazenamento associada a esta área de trabalho. Isto não pode ser alterado depois de a área de trabalho ter sido criada string
storageAccounts string[]
systemDatastoresAuthMode O modo de autenticação utilizado para aceder aos arquivos de dados do sistema da área de trabalho. string
v1LegacyMode Ativar v1_legacy_mode pode impedi-lo de utilizar funcionalidades fornecidas pela API v2. bool
workspaceHubConfig Objeto de configuração do WorkspaceHub. WorkspaceHubConfig

EncryptionProperty

Nome Descrição Valor
cosmosDbResourceId A conta byok cosmosdb que o cliente traz para armazenar os dados do cliente
com encriptação
string
identidade Identidade a utilizar com o keyVault IdentityForCmk
keyVaultProperties Detalhes do KeyVault para efetuar a encriptação KeyVaultProperties (obrigatório)
searchAccountResourceId A conta de pesquisa byok que o cliente traz para armazenar os dados do cliente
com encriptação
string
status Indica se a encriptação está ou não ativada para a área de trabalho. "Desativado"
"Ativado" (obrigatório)
storageAccountResourceId A conta de armazenamento byok que o cliente traz para armazenar os dados do cliente
com encriptação
string

IdentityForCmk

Nome Descrição Valor
userAssignedIdentity UserAssignedIdentity a ser utilizado para obter a chave de encriptação do keyVault string

KeyVaultProperties

Nome Descrição Valor
identityClientId Atualmente, suportamos apenas a MSI SystemAssigned.
Precisamos disto quando suportarmos UserAssignedIdentities
string
keyIdentifier Identificador de chave keyVault para encriptar os dados cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
keyVaultArmId ID do Arm do KeyVault que contém a chave de encriptação de dados cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]

FeatureStoreSettings

Nome Descrição Valor
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nome Descrição Valor
sparkRuntimeVersion string

ManagedNetworkSettings

Nome Descrição Valor
isolationMode Modo de isolamento para a rede gerida de uma área de trabalho de machine learning. "AllowInternetOutbound"
"AllowOnlyApprovedOutbound"
"Desativado"
outboundRules Dicionário de {OutboundRule} ManagedNetworkSettingsOutboundRules
status Estado do Aprovisionamento para a rede gerida de uma área de trabalho de machine learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nome Descrição Valor
{customized property} OutboundRule

OutboundRule

Nome Descrição Valor
categoria Categoria de uma regra de saída de rede gerida de uma área de trabalho de machine learning. "Recomendado"
"Obrigatório"
"Definido pelo Utilizador"
status Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"
tipo Definir o tipo de objeto FQDN
PrivateEndpoint
ServiceTag (obrigatório)

FqdnOutboundRule

Nome Descrição Valor
tipo Tipo de uma regra de saída de rede gerida de uma área de trabalho de machine learning. "FQDN" (obrigatório)
destino string

PrivateEndpointOutboundRule

Nome Descrição Valor
tipo Tipo de uma regra de saída de rede gerida de uma área de trabalho de machine learning. "PrivateEndpoint" (obrigatório)
destino Destino do Ponto Final Privado para uma Regra de Saída de Ponto Final Privado para a rede gerida de uma área de trabalho de machine learning. PrivateEndpointDestination

PrivateEndpointDestination

Nome Descrição Valor
serviceResourceId string
sparkEnabled bool
sparkStatus Tipo de uma Regra de Saída de rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"
subresourceTarget string

ServiceTagOutboundRule

Nome Descrição Valor
tipo Tipo de uma regra de saída de rede gerida de uma área de trabalho de machine learning. "ServiceTag" (obrigatório)
destino Destino da Etiqueta de Serviço para uma Regra de Saída de Etiqueta de Serviço para a rede gerida de uma área de trabalho de machine learning. ServiceTagDestination

ServiceTagDestination

Nome Descrição Valor
action O número de ação para a regra de rede. "Permitir"
'Negar'
portRanges string
protocolo string
serviceTag string

ManagedNetworkProvisionStatus

Nome Descrição Valor
sparkReady bool
status Estado da rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"

ServerlessComputeSettings

Nome Descrição Valor
serverlessComputeCustomSubnet O ID de recurso de uma sub-rede de rede virtual existente na qual os nós de computação sem servidor devem ser implementados string
serverlessComputeNoPublicIP O sinalizador para sinalizar se os nós de computação sem servidor implementados na vNet personalizada não teriam endereços IP públicos para uma área de trabalho com ponto final privado bool

ServiceManagedResourcesSettings

Nome Descrição Valor
cosmosDb CosmosDbSettings

CosmosDbSettings

Nome Descrição Valor
collectionsThroughput int

SharedPrivateLinkResource

Nome Descrição Valor
name Nome exclusivo da ligação privada string
propriedades Propriedades de um recurso de ligação privada partilhado. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nome Descrição Valor
groupId ID do grupo da ligação privada string
privateLinkResourceId o ID do recurso ao qual a ligação privada está ligada string
requestMessage Mensagem de pedido string
status Estado da ligação do consumidor do serviço com o fornecedor de serviços "Aprovado"
"Desligado"
"Pendente"
"Rejeitado"
"Tempo Limite"

WorkspaceHubConfig

Nome Descrição Valor
additionalWorkspaceStorageAccounts cadeia[]
defaultWorkspaceResourceGroup string

Sku

Nome Descrição Valor
capacidade Se o SKU suportar o aumento horizontal/in, o número inteiro de capacidade deve ser incluído. Se não for possível aumentar/reduzir horizontalmente o recurso, tal poderá ser omitido. int
família Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. string
name O nome do SKU. Ex - P3. Normalmente, é um código letter+number cadeia (obrigatório)
size O tamanho do SKU. Quando o campo de nome é a combinação de camada e outro valor, este seria o código autónomo. string
tier Este campo tem de ser implementado pelo Fornecedor de Recursos se o serviço tiver mais do que um escalão, mas não for necessário num PUT. "Básico"
'Gratuito'
"Premium"
'Standard'

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Área de trabalho do Azure Machine Learning

Implementar no Azure
Este modelo cria uma nova Área de Trabalho do Azure Machine Learning, juntamente com uma Conta de Armazenamento encriptada, o KeyVault e o Registo do Applications Insights
Criar uma área de trabalho AML com vários Conjuntos de Dados & Datastores

Implementar no Azure
Este modelo cria uma área de trabalho do Azure Machine Learning com vários conjuntos de dados & arquivos de dados.
Configuração segura ponto a ponto do Azure Machine Learning

Implementar no Azure
Este conjunto de modelos bicep demonstra como configurar o Azure Machine Learning ponto a ponto numa configuração segura. Esta implementação de referência inclui a Área de Trabalho, um cluster de computação, uma instância de computação e um cluster do AKS privado anexado.
Configuração segura ponto a ponto do Azure Machine Learning (legado)

Implementar no Azure
Este conjunto de modelos bicep demonstra como configurar o Azure Machine Learning ponto a ponto numa configuração segura. Esta implementação de referência inclui a Área de Trabalho, um cluster de computação, uma instância de computação e um cluster do AKS privado anexado.
Criar um destino de computação do AKS com um endereço IP Privado

Implementar no Azure
Este modelo cria um destino de computação do AKS em determinada área de trabalho do serviço Azure Machine Learning com um endereço IP privado.
Criar uma área de trabalho do serviço Azure Machine Learning

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, Informações do Aplicação Azure e Azure Container Registry. Esta configuração descreve o conjunto mínimo de recursos necessários para começar a utilizar o Azure Machine Learning.
Criar uma área de trabalho do serviço Azure Machine Learning (CMK)

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, Informações do Aplicação Azure e Azure Container Registry. O exemplo mostra como configurar o Azure Machine Learning para encriptação com uma chave de encriptação gerida pelo cliente.
Criar uma área de trabalho do serviço Azure Machine Learning (vnet)

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, Informações do Aplicação Azure e Azure Container Registry. Esta configuração descreve o conjunto de recursos necessários para começar a utilizar o Azure Machine Learning numa configuração isolada de rede.
Criar uma área de trabalho do serviço Azure Machine Learning (legada)

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, Informações do Aplicação Azure e Azure Container Registry. Esta configuração descreve o conjunto de recursos necessários para começar a utilizar o Azure Machine Learning numa configuração isolada de rede.

Definição de recurso de modelo do ARM

O tipo de recurso das áreas de trabalho pode ser implementado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.MachineLearningServices/workspaces",
  "apiVersion": "2023-08-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
    "{customized property}": "string"
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "kind": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "allowPublicAccessWhenBehindVnet": "bool",
    "applicationInsights": "string",
    "associatedWorkspaces": [ "string" ],
    "containerRegistries": [ "string" ],
    "containerRegistry": "string",
    "description": "string",
    "discoveryUrl": "string",
    "enableDataIsolation": "bool",
    "encryption": {
      "cosmosDbResourceId": "string",
      "identity": {
        "userAssignedIdentity": "string"
      },
      "keyVaultProperties": {
        "identityClientId": "string",
        "keyIdentifier": "string",
        "keyVaultArmId": "string"
      },
      "searchAccountResourceId": "string",
      "status": "string",
      "storageAccountResourceId": "string"
    },
    "existingWorkspaces": [ "string" ],
    "featureStoreSettings": {
      "computeRuntime": {
        "sparkRuntimeVersion": "string"
      },
      "offlineStoreConnectionName": "string",
      "onlineStoreConnectionName": "string"
    },
    "friendlyName": "string",
    "hbiWorkspace": "bool",
    "hubResourceId": "string",
    "imageBuildCompute": "string",
    "keyVault": "string",
    "keyVaults": [ "string" ],
    "managedNetwork": {
      "isolationMode": "string",
      "outboundRules": {
        "{customized property}": {
          "category": "string",
          "status": "string",
          "type": "string"
          // For remaining properties, see OutboundRule objects
        }
      },
      "status": {
        "sparkReady": "bool",
        "status": "string"
      }
    },
    "primaryUserAssignedIdentity": "string",
    "publicNetworkAccess": "string",
    "serverlessComputeSettings": {
      "serverlessComputeCustomSubnet": "string",
      "serverlessComputeNoPublicIP": "bool"
    },
    "serviceManagedResourcesSettings": {
      "cosmosDb": {
        "collectionsThroughput": "int"
      }
    },
    "sharedPrivateLinkResources": [
      {
        "name": "string",
        "properties": {
          "groupId": "string",
          "privateLinkResourceId": "string",
          "requestMessage": "string",
          "status": "string"
        }
      }
    ],
    "softDeleteRetentionInDays": "int",
    "storageAccount": "string",
    "storageAccounts": [ "string" ],
    "systemDatastoresAuthMode": "string",
    "v1LegacyMode": "bool",
    "workspaceHubConfig": {
      "additionalWorkspaceStorageAccounts": [ "string" ],
      "defaultWorkspaceResourceGroup": "string"
    }
  }
}

Objetos OutboundRule

Defina a propriedade tipo para especificar o tipo de objeto.

Para FQDN, utilize:

  "type": "FQDN",
  "destination": "string"

Para PrivateEndpoint, utilize:

  "type": "PrivateEndpoint",
  "destination": {
    "serviceResourceId": "string",
    "sparkEnabled": "bool",
    "sparkStatus": "string",
    "subresourceTarget": "string"
  }

Para o ServiceTag, utilize:

  "type": "ServiceTag",
  "destination": {
    "action": "string",
    "portRanges": "string",
    "protocol": "string",
    "serviceTag": "string"
  }

Valores de propriedade

áreas de trabalho

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.MachineLearningServices/workspaces"
apiVersion A versão da API de recursos '2023-08-01-preview'
name O nome do recurso cadeia (obrigatório)

Limite de carateres: 3-33

Carateres válidos:
Alfanuméricos, hífenes e carateres de sublinhado.
localização cadeia (de carateres)
etiquetas Dicionário de {string} Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
sku Opcional. Este campo tem de ser implementado pelo RP porque o AML suporta mais do que uma camada SKU
tipo string
identidade Identidade de serviço gerida (identidades atribuídas pelo sistema e/ou pelo utilizador) ManagedServiceIdentity
propriedades Atributos adicionais da entidade. WorkspaceProperties (obrigatório)

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos). "Nenhum"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo utilizador associadas ao recurso. As chaves de dicionário userAssignedIdentities serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) nos pedidos. UserAssignedIdentities

UserAssignedIdentities

Nome Descrição Valor
{customized property} UserAssignedIdentity

UserAssignedIdentity

Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.

WorkspaceProperties

Nome Descrição Valor
allowPublicAccessWhenBehindVnet O sinalizador para indicar se deve permitir o acesso público atrás da VNet. bool
applicationInsights ID arm do application insights associado a esta área de trabalho. string
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry ID arm do registo de contentor associado a esta área de trabalho. string
descrição A descrição desta área de trabalho. string
discoveryUrl URL do serviço de deteção para identificar pontos finais regionais para serviços de experimentação de machine learning string
enableDataIsolation bool
Encriptação EncryptionProperty
existingWorkspaces string[]
featureStoreSettings Definições para a área de trabalho do tipo arquivo de funcionalidades. FeatureStoreSettings
friendlyName O nome amigável desta área de trabalho. Este nome é mutável string
hbiWorkspace O sinalizador para sinalizar dados HBI na área de trabalho e reduzir os dados de diagnóstico recolhidos pelo serviço bool
hubResourceId string
imageBuildCompute O nome de computação da compilação da imagem string
keyVault ID do ARM do cofre de chaves associado a esta área de trabalho. Isto não pode ser alterado depois de a área de trabalho ter sido criada string
keyVaults cadeia[]
managedNetwork Definições de Rede Gerida para uma área de trabalho de machine learning. ManagedNetworkSettings
primaryUserAssignedIdentity O ID do recurso de identidade atribuído pelo utilizador que representa a identidade da área de trabalho. string
publicNetworkAccess Se os pedidos da Rede Pública são permitidos. "Desativado"
"Ativado"
serverlessComputeSettings Definições para computação sem servidor criadas na área de trabalho ServerlessComputeSettings
serviceManagedResourcesSettings As definições de recursos geridos pelo serviço. ServiceManagedResourcesSettings
sharedPrivateLinkResources A lista de recursos de ligação privada partilhados nesta área de trabalho. SharedPrivateLinkResource[]
softDeleteRetentionInDays Tempo de retenção em dias após a eliminação recuperável da área de trabalho. int
storageAccount ID do ARM da conta de armazenamento associada a esta área de trabalho. Isto não pode ser alterado depois de a área de trabalho ter sido criada string
storageAccounts cadeia[]
systemDatastoresAuthMode O modo de autenticação utilizado para aceder aos arquivos de dados do sistema da área de trabalho. string
v1LegacyMode Ativar v1_legacy_mode pode impedi-lo de utilizar as funcionalidades fornecidas pela API v2. bool
workspaceHubConfig Objeto de configuração do WorkspaceHub. WorkspaceHubConfig

EncryptionProperty

Nome Descrição Valor
cosmosDbResourceId A conta byok cosmosdb que o cliente traz para armazenar os dados do cliente
com encriptação
string
identidade Identidade a utilizar com o keyVault IdentityForCmk
keyVaultProperties Detalhes do KeyVault para efetuar a encriptação KeyVaultProperties (obrigatório)
searchAccountResourceId A conta de pesquisa byok que o cliente traz para armazenar os dados do cliente
com encriptação
string
status Indica se a encriptação está ou não ativada para a área de trabalho. "Desativado"
"Ativado" (obrigatório)
storageAccountResourceId A conta de armazenamento byok que o cliente traz para armazenar os dados do cliente
com encriptação
string

IdentityForCmk

Nome Descrição Valor
userAssignedIdentity UserAssignedIdentity a ser utilizado para obter a chave de encriptação do keyVault string

KeyVaultProperties

Nome Descrição Valor
identityClientId Atualmente, suportamos apenas a MSI SystemAssigned.
Precisamos disto quando suportamos UserAssignedIdentities
string
keyIdentifier Identificador de chave KeyVault para encriptar os dados cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm ID que contém a chave de encriptação de dados cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]

FeatureStoreSettings

Nome Descrição Valor
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nome Descrição Valor
sparkRuntimeVersion string

ManagedNetworkSettings

Nome Descrição Valor
isolationMode Modo de isolamento para a rede gerida de uma área de trabalho de machine learning. "AllowInternetOutbound"
"AllowOnlyApprovedOutbound"
"Desativado"
outboundRules Dicionário de {OutboundRule} ManagedNetworkSettingsOutboundRules
status Estado do Aprovisionamento para a rede gerida de uma área de trabalho de machine learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nome Descrição Valor
{customized property} OutboundRule

OutboundRule

Nome Descrição Valor
categoria Categoria de uma regra de saída de rede gerida de uma área de trabalho de machine learning. "Recomendado"
"Obrigatório"
"Definido pelo Utilizador"
status Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"
tipo Definir o tipo de objeto FQDN
PrivateEndpoint
ServiceTag (obrigatório)

FqdnOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "FQDN" (obrigatório)
destino string

PrivateEndpointOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "PrivateEndpoint" (obrigatório)
destino Destino do Ponto Final Privado para uma Regra de Saída de Ponto Final Privado para a rede gerida de uma área de trabalho de machine learning. PrivateEndpointDestination

PrivateEndpointDestination

Nome Descrição Valor
serviceResourceId string
sparkEnabled bool
sparkStatus Tipo de uma Regra de Saída de rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"
subresourceTarget string

ServiceTagOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "ServiceTag" (obrigatório)
destino Destino da Etiqueta de Serviço para uma Regra de Saída de Etiquetas de Serviço para a rede gerida de uma área de trabalho de machine learning. ServiceTagDestination

ServiceTagDestination

Nome Descrição Valor
action A enumeração de ação para a regra de rede. "Permitir"
"Negar"
portRanges string
protocolo string
serviceTag string

ManagedNetworkProvisionStatus

Nome Descrição Valor
sparkReady bool
status Estado da rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"

ServerlessComputeSettings

Nome Descrição Valor
serverlessComputeCustomSubnet O ID de recurso de uma sub-rede de rede virtual existente na qual os nós de computação sem servidor devem ser implementados string
serverlessComputeNoPublicIP O sinalizador para sinalizar se os nós de computação sem servidor implementados na vNet personalizada não teriam endereços IP públicos para uma área de trabalho com ponto final privado bool

ServiceManagedResourcesSettings

Nome Descrição Valor
cosmosDb CosmosDbSettings

CosmosDbSettings

Nome Descrição Valor
collectionsThroughput int

SharedPrivateLinkResource

Nome Descrição Valor
name Nome exclusivo da ligação privada string
propriedades Propriedades de um recurso de ligação privada partilhado. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nome Descrição Valor
groupId ID do grupo da ligação privada string
privateLinkResourceId o ID de recurso ao qual a ligação privada está ligada string
requestMessage Pedir mensagem string
status Estado da ligação do consumidor do serviço com o fornecedor de serviços "Aprovado"
"Desligado"
"Pendente"
"Rejeitado"
"Tempo Limite"

WorkspaceHubConfig

Nome Descrição Valor
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup string

Sku

Nome Descrição Valor
capacidade Se o SKU suportar o aumento/aumento horizontal, o número inteiro da capacidade deve ser incluído. Se não for possível aumentar/reduzir horizontalmente para o recurso, tal poderá ser omitido. int
família Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. string
name O nome do SKU. Ex - P3. Normalmente, é um código letter+number cadeia (obrigatório)
size O tamanho do SKU. Quando o campo de nome é a combinação de camada e outro valor, este seria o código autónomo. string
tier Este campo tem de ser implementado pelo Fornecedor de Recursos se o serviço tiver mais do que um escalão, mas não for necessário num PUT. "Básico"
'Gratuito'
"Premium"
'Standard'

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Área de trabalho do Azure Machine Learning

Implementar no Azure
Este modelo cria uma nova Área de Trabalho do Azure Machine Learning, juntamente com uma Conta de Armazenamento encriptada, o KeyVault e o Registo do Applications Insights
Criar uma área de trabalho AML com vários Conjuntos de Dados & Arquivos de dados

Implementar no Azure
Este modelo cria uma área de trabalho do Azure Machine Learning com vários conjuntos de dados & arquivos de dados.
Configuração segura ponto a ponto do Azure Machine Learning

Implementar no Azure
Este conjunto de modelos bicep demonstra como configurar o Azure Machine Learning ponto a ponto numa configuração segura. Esta implementação de referência inclui a Área de Trabalho, um cluster de computação, instância de computação e cluster do AKS privado anexado.
Configuração segura ponto a ponto do Azure Machine Learning (legada)

Implementar no Azure
Este conjunto de modelos bicep demonstra como configurar o Azure Machine Learning ponto a ponto numa configuração segura. Esta implementação de referência inclui a Área de Trabalho, um cluster de computação, instância de computação e cluster do AKS privado anexado.
Criar um destino de computação do AKS com um endereço IP privado

Implementar no Azure
Este modelo cria um destino de computação do AKS numa determinada área de trabalho do serviço Azure Machine Learning com um endereço IP privado.
Criar uma área de trabalho do serviço Azure Machine Learning

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo o Azure Key Vault, o Armazenamento do Azure, o Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto mínimo de recursos necessários para começar a utilizar o Azure Machine Learning.
Criar uma área de trabalho do serviço Azure Machine Learning (CMK)

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo o Azure Key Vault, o Armazenamento do Azure, o Aplicação Azure Insights e Azure Container Registry. O exemplo mostra como configurar o Azure Machine Learning para encriptação com uma chave de encriptação gerida pelo cliente.
Criar uma área de trabalho do serviço Azure Machine Learning (vnet)

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo o Azure Key Vault, o Armazenamento do Azure, o Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto de recursos necessários para começar a utilizar o Azure Machine Learning numa configuração isolada de rede.
Criar uma área de trabalho do serviço Azure Machine Learning (legada)

Implementar no Azure
Este modelo de implementação especifica uma área de trabalho do Azure Machine Learning e os respetivos recursos associados, incluindo o Azure Key Vault, o Armazenamento do Azure, o Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto de recursos necessários para começar a utilizar o Azure Machine Learning numa configuração isolada de rede.

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso das áreas de trabalho pode ser implementado com operações que visam:

  • Grupos de recursos

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces@2023-08-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
    {customized property} = "string"
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      allowPublicAccessWhenBehindVnet = bool
      applicationInsights = "string"
      associatedWorkspaces = [
        "string"
      ]
      containerRegistries = [
        "string"
      ]
      containerRegistry = "string"
      description = "string"
      discoveryUrl = "string"
      enableDataIsolation = bool
      encryption = {
        cosmosDbResourceId = "string"
        identity = {
          userAssignedIdentity = "string"
        }
        keyVaultProperties = {
          identityClientId = "string"
          keyIdentifier = "string"
          keyVaultArmId = "string"
        }
        searchAccountResourceId = "string"
        status = "string"
        storageAccountResourceId = "string"
      }
      existingWorkspaces = [
        "string"
      ]
      featureStoreSettings = {
        computeRuntime = {
          sparkRuntimeVersion = "string"
        }
        offlineStoreConnectionName = "string"
        onlineStoreConnectionName = "string"
      }
      friendlyName = "string"
      hbiWorkspace = bool
      hubResourceId = "string"
      imageBuildCompute = "string"
      keyVault = "string"
      keyVaults = [
        "string"
      ]
      managedNetwork = {
        isolationMode = "string"
        outboundRules = {
          {customized property} = {
            category = "string"
            status = "string"
            type = "string"
            // For remaining properties, see OutboundRule objects
          }
        }
        status = {
          sparkReady = bool
          status = "string"
        }
      }
      primaryUserAssignedIdentity = "string"
      publicNetworkAccess = "string"
      serverlessComputeSettings = {
        serverlessComputeCustomSubnet = "string"
        serverlessComputeNoPublicIP = bool
      }
      serviceManagedResourcesSettings = {
        cosmosDb = {
          collectionsThroughput = int
        }
      }
      sharedPrivateLinkResources = [
        {
          name = "string"
          properties = {
            groupId = "string"
            privateLinkResourceId = "string"
            requestMessage = "string"
            status = "string"
          }
        }
      ]
      softDeleteRetentionInDays = int
      storageAccount = "string"
      storageAccounts = [
        "string"
      ]
      systemDatastoresAuthMode = "string"
      v1LegacyMode = bool
      workspaceHubConfig = {
        additionalWorkspaceStorageAccounts = [
          "string"
        ]
        defaultWorkspaceResourceGroup = "string"
      }
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
    kind = "string"
  })
}

Objetos OutboundRule

Defina a propriedade type para especificar o tipo de objeto.

Para FQDN, utilize:

  type = "FQDN"
  destination = "string"

Para PrivateEndpoint, utilize:

  type = "PrivateEndpoint"
  destination = {
    serviceResourceId = "string"
    sparkEnabled = bool
    sparkStatus = "string"
    subresourceTarget = "string"
  }

Para ServiceTag, utilize:

  type = "ServiceTag"
  destination = {
    action = "string"
    portRanges = "string"
    protocol = "string"
    serviceTag = "string"
  }

Valores de propriedade

áreas de trabalho

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.MachineLearningServices/workspaces@2023-08-01-preview"
name O nome do recurso cadeia (obrigatório)

Limite de carateres: 3-33

Carateres válidos:
Alfanuméricos, hífenes e carateres de sublinhado.
localização cadeia (de carateres)
parent_id Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. cadeia (obrigatório)
etiquetas Dicionário de {string} Dicionário de nomes e valores de etiquetas.
sku Opcional. Este campo tem de ser implementado pelo RP porque o AML suporta mais do que uma camada SKU
tipo string
identidade Identidade de serviço gerida (identidades atribuídas pelo sistema e/ou pelo utilizador) ManagedServiceIdentity
propriedades Atributos adicionais da entidade. WorkspaceProperties (obrigatório)

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos). "SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (obrigatório)
identity_ids O conjunto de identidades atribuídas pelo utilizador associadas ao recurso. As chaves de dicionário userAssignedIdentities serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) nos pedidos. Matriz de IDs de identidade do utilizador.

UserAssignedIdentities

Nome Descrição Valor
{customized property} UserAssignedIdentity

UserAssignedIdentity

Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.

WorkspaceProperties

Nome Descrição Valor
allowPublicAccessWhenBehindVnet O sinalizador para indicar se deve permitir o acesso público atrás da VNet. bool
applicationInsights ID do ARM das informações da aplicação associadas a esta área de trabalho. string
associatedWorkspaces cadeia[]
containerRegistries cadeia[]
containerRegistry ID arm do registo de contentor associado a esta área de trabalho. string
descrição A descrição desta área de trabalho. string
discoveryUrl URL do serviço de deteção para identificar pontos finais regionais para serviços de experimentação de machine learning string
enableDataIsolation bool
Encriptação EncryptionProperty
áreas de trabalho existentes cadeia[]
featureStoreSettings Definições para a área de trabalho do tipo arquivo de funcionalidades. FeatureStoreSettings
friendlyName O nome amigável desta área de trabalho. Este nome é mutável string
hbiWorkspace O sinalizador para sinalizar dados HBI na área de trabalho e reduzir os dados de diagnóstico recolhidos pelo serviço bool
hubResourceId string
imageBuildCompute O nome de computação da compilação de imagens string
keyVault ID do ARM do cofre de chaves associado a esta área de trabalho. Isto não pode ser alterado depois de a área de trabalho ter sido criada string
keyVaults cadeia[]
managedNetwork Definições de Rede Gerida para uma área de trabalho de machine learning. ManagedNetworkSettings
primaryUserAssignedIdentity O ID do recurso de identidade atribuído pelo utilizador que representa a identidade da área de trabalho. string
publicNetworkAccess Se os pedidos da Rede Pública são permitidos. "Desativado"
"Ativado"
serverlessComputeSettings Definições para computação sem servidor criadas na área de trabalho ServerlessComputeSettings
serviceManagedResourcesSettings As definições de recursos geridos pelo serviço. ServiceManagedResourcesSettings
sharedPrivateLinkResources A lista de recursos de ligação privada partilhados nesta área de trabalho. SharedPrivateLinkResource[]
softDeleteRetentionInDays Tempo de retenção em dias após a eliminação recuperável da área de trabalho. int
storageAccount ID do ARM da conta de armazenamento associada a esta área de trabalho. Isto não pode ser alterado depois de a área de trabalho ter sido criada string
storageAccounts cadeia[]
systemDatastoresAuthMode O modo de autenticação utilizado para aceder aos arquivos de dados do sistema da área de trabalho. string
v1LegacyMode Ativar v1_legacy_mode pode impedi-lo de utilizar as funcionalidades fornecidas pela API v2. bool
workspaceHubConfig Objeto de configuração do WorkspaceHub. WorkspaceHubConfig

EncryptionProperty

Nome Descrição Valor
cosmosDbResourceId A conta byok cosmosdb que o cliente traz para armazenar os dados do cliente
com encriptação
string
identidade Identidade a utilizar com o keyVault IdentityForCmk
keyVaultProperties Detalhes do KeyVault para efetuar a encriptação KeyVaultProperties (obrigatório)
searchAccountResourceId A conta de pesquisa byok que o cliente traz para armazenar os dados do cliente
com encriptação
string
status Indica se a encriptação está ou não ativada para a área de trabalho. "Desativado"
"Ativado" (obrigatório)
storageAccountResourceId A conta de armazenamento byok que o cliente traz para armazenar os dados do cliente
com encriptação
string

IdentityForCmk

Nome Descrição Valor
userAssignedIdentity UserAssignedIdentity a ser utilizado para obter a chave de encriptação do keyVault string

KeyVaultProperties

Nome Descrição Valor
identityClientId Atualmente, suportamos apenas a MSI SystemAssigned.
Precisamos disto quando suportamos UserAssignedIdentities
string
keyIdentifier Identificador de chave KeyVault para encriptar os dados cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm ID que contém a chave de encriptação de dados cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]

FeatureStoreSettings

Nome Descrição Valor
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nome Descrição Valor
sparkRuntimeVersion string

ManagedNetworkSettings

Nome Descrição Valor
isolationMode Modo de isolamento para a rede gerida de uma área de trabalho de machine learning. "AllowInternetOutbound"
"AllowOnlyApprovedOutbound"
"Desativado"
outboundRules Dicionário de {OutboundRule} ManagedNetworkSettingsOutboundRules
status Estado do Aprovisionamento para a rede gerida de uma área de trabalho de machine learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nome Descrição Valor
{customized property} OutboundRule

OutboundRule

Nome Descrição Valor
categoria Categoria de uma regra de saída de rede gerida de uma área de trabalho de machine learning. "Recomendado"
"Obrigatório"
"UserDefined"
status Tipo de uma regra de saída de rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"
tipo Definir o tipo de objeto FQDN
PrivateEndpoint
ServiceTag (obrigatório)

FqdnOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "FQDN" (obrigatório)
destino string

PrivateEndpointOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "PrivateEndpoint" (obrigatório)
destino Destino do Ponto Final Privado para uma Regra de Saída de Ponto Final Privado para a rede gerida de uma área de trabalho de machine learning. PrivateEndpointDestination

PrivateEndpointDestination

Nome Descrição Valor
serviceResourceId string
sparkEnabled bool
sparkStatus Tipo de uma Regra de Saída de rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"
subresourceTarget string

ServiceTagOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerida de uma área de trabalho de machine learning. "ServiceTag" (obrigatório)
destino Destino da Etiqueta de Serviço para uma Regra de Saída de Etiquetas de Serviço para a rede gerida de uma área de trabalho de machine learning. ServiceTagDestination

ServiceTagDestination

Nome Descrição Valor
action A enumeração de ação para a regra de rede. "Permitir"
"Negar"
portRanges string
protocolo string
serviceTag string

ManagedNetworkProvisionStatus

Nome Descrição Valor
sparkReady bool
status Estado da rede gerida de uma área de trabalho de machine learning. "Ativo"
"Inativo"

ServerlessComputeSettings

Nome Descrição Valor
serverlessComputeCustomSubnet O ID de recurso de uma sub-rede de rede virtual existente na qual os nós de computação sem servidor devem ser implementados string
serverlessComputeNoPublicIP O sinalizador para sinalizar se os nós de computação sem servidor implementados na vNet personalizada não teriam endereços IP públicos para uma área de trabalho com ponto final privado bool

ServiceManagedResourcesSettings

Nome Descrição Valor
cosmosDb CosmosDbSettings

CosmosDbSettings

Nome Descrição Valor
collectionsThroughput int

SharedPrivateLinkResource

Nome Descrição Valor
name Nome exclusivo da ligação privada string
propriedades Propriedades de um recurso de ligação privada partilhado. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nome Descrição Valor
groupId ID do grupo da ligação privada string
privateLinkResourceId o ID do recurso ao qual a ligação privada está ligada string
requestMessage Mensagem de pedido string
status Estado da ligação do consumidor do serviço com o fornecedor de serviços "Aprovado"
"Desligado"
"Pendente"
"Rejeitado"
"Tempo Limite"

WorkspaceHubConfig

Nome Descrição Valor
additionalWorkspaceStorageAccounts cadeia[]
defaultWorkspaceResourceGroup string

Sku

Nome Descrição Valor
capacidade Se o SKU suportar o aumento horizontal/in, o número inteiro de capacidade deve ser incluído. Se não for possível aumentar/reduzir horizontalmente o recurso, tal poderá ser omitido. int
família Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. string
name O nome do SKU. Ex - P3. Normalmente, é um código letter+number cadeia (obrigatório)
size O tamanho do SKU. Quando o campo de nome é a combinação de camada e outro valor, este seria o código autónomo. string
tier Este campo tem de ser implementado pelo Fornecedor de Recursos se o serviço tiver mais do que um escalão, mas não for necessário num PUT. "Básico"
"Gratuito"
"Premium"
"Standard"