Compartilhar via


Workspaces Microsoft.MachineLearningServices

Definição de recurso do Bicep

O tipo de recurso workspaces pode ser implantado com operações direcionadas:

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

Formato de recurso

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces@2023-10-01' = {
  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'
    containerRegistry: 'string'
    description: 'string'
    discoveryUrl: 'string'
    encryption: {
      identity: {
        userAssignedIdentity: 'string'
      }
      keyVaultProperties: {
        identityClientId: 'string'
        keyIdentifier: 'string'
        keyVaultArmId: 'string'
      }
      status: 'string'
    }
    featureStoreSettings: {
      computeRuntime: {
        sparkRuntimeVersion: 'string'
      }
      offlineStoreConnectionName: 'string'
      onlineStoreConnectionName: 'string'
    }
    friendlyName: 'string'
    hbiWorkspace: bool
    imageBuildCompute: 'string'
    keyVault: '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'
        }
      }
    ]
    storageAccount: 'string'
    v1LegacyMode: bool
  }
}

Objetos OutboundRule

Defina a propriedade type para especificar o tipo de objeto.

Para FQDN, use:

  type: 'FQDN'
  destination: 'string'

Para PrivateEndpoint, use:

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

Para ServiceTag, use:

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

Valores de propriedade

workspaces

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

Limite de caracteres: 3 a 33

Caracteres válidos:
Caracteres alfanuméricos, hifens e sublinhados.
local Especifica o local do recurso. string
marcas Contém marcas de recurso definidas como pares chave/valor. Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
sku O sku do workspace. Sku
kind string
identidade A identidade do recurso. ManagedServiceIdentity
properties As propriedades do workspace de machine learning. WorkspaceProperties

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

UserAssignedIdentities

Nome Descrição Valor
{propriedade personalizada} UserAssignedIdentity

UserAssignedIdentity

Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.

WorkspaceProperties

Nome Descrição Valor
allowPublicAccessWhenBehindVnet O sinalizador para indicar se deseja permitir o acesso público quando estiver atrás da VNet. bool
applicationInsights ID do ARM dos insights do aplicativo associados a esse workspace. string
containerRegistry ID do ARM do registro de contêiner associado a esse workspace. string
descrição A descrição deste workspace. string
discoveryUrl URL do serviço de descoberta para identificar pontos de extremidade regionais para serviços de experimentação de machine learning string
criptografia As configurações de criptografia do workspace do Azure ML. Encryptionproperty
featureStoreSettings Configurações para o workspace do tipo de repositório de recursos. FeatureStoreSettings
friendlyName O nome amigável para este workspace. Esse nome é mutável string
hbiWorkspace O sinalizador para sinalizar dados HBI no workspace e reduzir os dados de diagnóstico coletados pelo serviço bool
imageBuildCompute O nome da computação para build de imagem string
keyVault ID do ARM do cofre de chaves associado a esse workspace. Isso não pode ser alterado depois que o workspace for criado string
managedNetwork Configurações de Rede Gerenciada para um workspace de machine learning. ManagedNetworkSettings
primaryUserAssignedIdentity A ID de recurso de identidade atribuída pelo usuário que representa a identidade do workspace. string
publicNetworkAccess Se as solicitações da Rede Pública são permitidas. 'Desabilitado'
'Enabled'
serverlessComputeSettings Configurações para computação sem servidor criadas no workspace ServerlessComputeSettings
serviceManagedResourcesSettings As configurações de recurso gerenciado pelo serviço. ServiceManagedResourcesSettings
sharedPrivateLinkResources A lista de recursos de link privado compartilhados neste workspace. SharedPrivateLinkResource[]
storageAccount ID do ARM da conta de armazenamento associada a esse workspace. Isso não pode ser alterado depois que o workspace for criado string
v1LegacyMode Habilitar v1_legacy_mode pode impedir o uso de recursos fornecidos pela API v2. bool

Encryptionproperty

Nome Descrição Valor
identidade A identidade que será usada para acessar o cofre de chaves para criptografia em repouso. IdentityForCmk
keyVaultProperties Propriedades do cofre de chaves do cliente. EncryptionKeyVaultProperties (obrigatório)
status Indica se a criptografia está habilitada ou não para o workspace. 'Desabilitado'
'Enabled' (obrigatório)

IdentityForCmk

Nome Descrição Valor
userAssignedIdentity O ArmId da identidade atribuída pelo usuário que será usada para acessar o cofre de chaves gerenciado pelo cliente string

EncryptionKeyVaultProperties

Nome Descrição Valor
identityClientId Para uso futuro – a ID do cliente da identidade que será usada para acessar o cofre de chaves. string
keyIdentifier URI do cofre de chaves para acessar a chave de criptografia. cadeia de caracteres (obrigatório)
keyVaultArmId O ArmId do keyVault em que a chave de criptografia de propriedade do cliente está presente. cadeia de caracteres (obrigatório)

FeatureStoreSettings

Nome Descrição Valor
computeRuntime Configuração de runtime de computação para o workspace do tipo de repositório de recursos. ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nome Descrição Valor
sparkRuntimeVersion string

ManagedNetworkSettings

Nome Descrição Valor
isolationMode Modo de isolamento para a rede gerenciada de um workspace de machine learning. 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Desabilitado'
outboundRules Dicionário de {OutboundRule} ManagedNetworkSettingsOutboundRules
status Status do Provisionamento para a rede gerenciada de um workspace de machine learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nome Descrição Valor
{propriedade personalizada} OutboundRule

OutboundRule

Nome Descrição Valor
category Categoria de uma regra de saída de rede gerenciada de um workspace de machine learning. 'Recomendado'
'Obrigatório'
'UserDefined'
status Tipo de regra de saída de rede gerenciada de um workspace 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 gerenciada de um workspace de machine learning. 'FQDN' (obrigatório)
destino string

PrivateEndpointOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerenciada de um workspace de machine learning. 'PrivateEndpoint' (obrigatório)
destino Destino do ponto de extremidade privado para uma regra de saída de ponto de extremidade privado para a rede gerenciada de um workspace de machine learning. PrivateEndpointDestination

PrivateEndpointDestination

Nome Descrição Valor
serviceResourceId string
sparkEnabled bool
sparkStatus Tipo de regra de saída de rede gerenciada de um workspace de machine learning. 'Ativo'
'Inativo'
subresourceTarget string

ServiceTagOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerenciada de um workspace de machine learning. 'ServiceTag' (obrigatório)
destino Destino da Marca de Serviço para uma Regra de Saída da Marca de Serviço para a rede gerenciada de um workspace de machine learning. ServiceTagDestination

ServiceTagDestination

Nome Descrição Valor
ação A enumeração de ação para a regra de rede. 'Allow'
'Deny'
portRanges string
protocolo string
serviceTag string

ManagedNetworkProvisionStatus

Nome Descrição Valor
sparkReady bool
status Status da rede gerenciada de um workspace de machine learning. 'Ativo'
'Inativo'

ServerlessComputeSettings

Nome Descrição Valor
serverlessComputeCustomSubnet A ID de recurso de uma sub-rede de rede virtual existente na qual os nós de computação sem servidor devem ser implantados string
serverlessComputeNoPublicIP O sinalizador a ser sinalizado se nós de computação sem servidor implantados na vNet personalizada não tiverem endereços IP públicos para um workspace com ponto de extremidade privado bool

ServiceManagedResourcesSettings

Nome Descrição Valor
cosmosDb As configurações para a conta do cosmosdb gerenciada pelo serviço. CosmosDbSettings

CosmosDbSettings

Nome Descrição Valor
collectionsThroughput A taxa de transferência das coleções no banco de dados cosmosdb INT

SharedPrivateLinkResource

Nome Descrição Valor
name Nome exclusivo do link privado. string
properties Propriedades do recurso. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nome Descrição Valor
groupId A ID do grupo de recursos do link privado. string
privateLinkResourceId A ID do recurso à qual o link privado se vincula. string
requestMessage Mensagem de solicitação. string
status Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço. 'Aprovado'
'Desconectado'
'Pendente'
'Rejeitado'
'Timeout'

Sku

Nome Descrição Valor
ALOCADA Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se expansão/redução não for possível para o recurso, isso poderá ser omitido. INT
família Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome da SKU. Ex - P3. Normalmente, é um código de letra+número cadeia de caracteres (obrigatório)
tamanho O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo. string
Camada Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. 'Básico'
'Gratuito'
'Premium'
'Standard'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Azure Machine Learning Workspace

Implantar no Azure
Este modelo cria um novo workspace do Azure Machine Learning, juntamente com uma conta de armazenamento criptografada, o KeyVault e o log do Application Insights
Criar workspace do AML com vários conjuntos de dados & Datastores

Implantar no Azure
Este modelo cria o workspace do Azure Machine Learning com vários conjuntos de dados & armazenamentos de dados.
Configuração segura de ponta a ponta do Azure Machine Learning

Implantar no Azure
Esse conjunto de modelos do Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta em uma configuração segura. Essa implementação de referência inclui o Workspace, um cluster de computação, uma instância de computação e um cluster do AKS privado anexado.
Configuração segura de ponta a ponta do Azure Machine Learning (herdada)

Implantar no Azure
Esse conjunto de modelos do Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta em uma configuração segura. Essa implementação de referência inclui o Workspace, 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

Implantar no Azure
Esse modelo cria um destino de computação do AKS em determinado workspace do serviço do Azure Machine Learning com um endereço IP privado.
Criar um workspace do serviço do Azure Machine Learning

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. Essa configuração descreve o conjunto mínimo de recursos necessários para começar a usar o Azure Machine Learning.
Criar um workspace do serviço do Azure Machine Learning (CMK)

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. O exemplo mostra como configurar o Azure Machine Learning para criptografia com uma chave de criptografia gerenciada pelo cliente.
Criar um workspace do serviço do Azure Machine Learning (vnet)

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. Essa configuração descreve o conjunto de recursos necessários para começar a usar o Azure Machine Learning em uma configuração isolada de rede.
Criar um workspace do serviço do Azure Machine Learning (herdado)

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. Essa configuração descreve o conjunto de recursos necessários para começar a usar o Azure Machine Learning em uma configuração isolada de rede.

Definição de recurso de modelo do ARM

O tipo de recurso workspaces pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.MachineLearningServices/workspaces",
  "apiVersion": "2023-10-01",
  "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",
    "containerRegistry": "string",
    "description": "string",
    "discoveryUrl": "string",
    "encryption": {
      "identity": {
        "userAssignedIdentity": "string"
      },
      "keyVaultProperties": {
        "identityClientId": "string",
        "keyIdentifier": "string",
        "keyVaultArmId": "string"
      },
      "status": "string"
    },
    "featureStoreSettings": {
      "computeRuntime": {
        "sparkRuntimeVersion": "string"
      },
      "offlineStoreConnectionName": "string",
      "onlineStoreConnectionName": "string"
    },
    "friendlyName": "string",
    "hbiWorkspace": "bool",
    "imageBuildCompute": "string",
    "keyVault": "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"
        }
      }
    ],
    "storageAccount": "string",
    "v1LegacyMode": "bool"
  }
}

Objetos OutboundRule

Defina a propriedade type para especificar o tipo de objeto.

Para FQDN, use:

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

Para PrivateEndpoint, use:

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

Para ServiceTag, use:

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

Valores de propriedade

workspaces

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

Limite de caracteres: 3 a 33

Caracteres válidos:
Caracteres alfanuméricos, hifens e sublinhados.
local Especifica o local do recurso. string
marcas Contém marcas de recurso definidas como pares chave/valor. Dicionário de nomes e valores de marcas. Confira Marcas em modelos
sku A SKU do workspace. Sku
kind string
identidade A identidade do recurso. ManagedServiceIdentity
properties As propriedades do workspace de machine learning. WorkspaceProperties

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

UserAssignedIdentities

Nome Descrição Valor
{propriedade personalizada} UserAssignedIdentity

UserAssignedIdentity

Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.

WorkspaceProperties

Nome Descrição Valor
allowPublicAccessWhenBehindVnet O sinalizador para indicar se o acesso público deve ser permitido quando estiver atrás da VNet. bool
applicationInsights ID do ARM dos insights do aplicativo associados a esse workspace. string
containerRegistry ID do ARM do registro de contêiner associado a esse workspace. string
descrição A descrição desse workspace. string
discoveryUrl URL do serviço de descoberta para identificar pontos de extremidade regionais para serviços de experimentação de machine learning string
criptografia As configurações de criptografia do workspace do Azure ML. Encryptionproperty
featureStoreSettings Configurações para o workspace do tipo de repositório de recursos. FeatureStoreSettings
friendlyName O nome amigável para este workspace. Este nome em mutável string
hbiWorkspace O sinalizador para sinalizar dados HBI no workspace e reduzir os dados de diagnóstico coletados pelo serviço bool
imageBuildCompute O nome da computação para compilação de imagem string
keyVault ID do ARM do cofre de chaves associado a esse workspace. Isso não pode ser alterado depois que o workspace tiver sido criado string
managedNetwork Configurações de Rede Gerenciada para um workspace de machine learning. ManagedNetworkSettings
primaryUserAssignedIdentity A ID de recurso de identidade atribuída pelo usuário que representa a identidade do workspace. string
publicNetworkAccess Se as solicitações da Rede Pública são permitidas. 'Desabilitado'
'Enabled'
serverlessComputeSettings Configurações para computação sem servidor criadas no workspace ServerlessComputeSettings
serviceManagedResourcesSettings As configurações de recurso gerenciado pelo serviço. ServiceManagedResourcesSettings
sharedPrivateLinkResources A lista de recursos de link privado compartilhados neste workspace. SharedPrivateLinkResource[]
storageAccount ID do ARM da conta de armazenamento associada a esse workspace. Isso não pode ser alterado depois que o workspace tiver sido criado string
v1LegacyMode Habilitar v1_legacy_mode pode impedir o uso de recursos fornecidos pela API v2. bool

Encryptionproperty

Nome Descrição Valor
identidade A identidade que será usada para acessar o cofre de chaves para criptografia em repouso. IdentityForCmk
keyVaultProperties Propriedades do cofre de chaves do cliente. EncryptionKeyVaultProperties (obrigatório)
status Indica se a criptografia está habilitada ou não para o workspace. 'Desabilitado'
'Enabled' (obrigatório)

IdentityForCmk

Nome Descrição Valor
userAssignedIdentity O ArmId da identidade atribuída pelo usuário que será usada para acessar o cofre de chaves gerenciado pelo cliente string

EncryptionKeyVaultProperties

Nome Descrição Valor
identityClientId Para uso futuro – a ID do cliente da identidade que será usada para acessar o cofre de chaves. string
keyIdentifier URI do cofre de chaves para acessar a chave de criptografia. cadeia de caracteres (obrigatório)
keyVaultArmId O ArmId do keyVault em que a chave de criptografia de propriedade do cliente está presente. cadeia de caracteres (obrigatório)

FeatureStoreSettings

Nome Descrição Valor
computeRuntime Configuração de runtime de computação para o workspace do tipo de repositório de recursos. ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nome Descrição Valor
sparkRuntimeVersion string

ManagedNetworkSettings

Nome Descrição Valor
isolationMode Modo de isolamento para a rede gerenciada de um workspace de machine learning. 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Desabilitado'
outboundRules Dicionário de {OutboundRule} ManagedNetworkSettingsOutboundRules
status Status do Provisionamento para a rede gerenciada de um workspace de machine learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nome Descrição Valor
{propriedade personalizada} OutboundRule

OutboundRule

Nome Descrição Valor
category Categoria de uma regra de saída de rede gerenciada de um workspace de machine learning. 'Recomendado'
'Obrigatório'
'UserDefined'
status Tipo de regra de saída de rede gerenciada de um workspace 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 gerenciada de um workspace de machine learning. 'FQDN' (obrigatório)
destino string

PrivateEndpointOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerenciada de um workspace de machine learning. 'PrivateEndpoint' (obrigatório)
destino Destino do ponto de extremidade privado para uma regra de saída de ponto de extremidade privado para a rede gerenciada de um workspace de machine learning. PrivateEndpointDestination

PrivateEndpointDestination

Nome Descrição Valor
serviceResourceId string
sparkEnabled bool
sparkStatus Tipo de regra de saída de rede gerenciada de um workspace de machine learning. 'Ativo'
'Inativo'
subresourceTarget string

ServiceTagOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerenciada de um workspace de machine learning. 'ServiceTag' (obrigatório)
destino Destino da Marca de Serviço para uma Regra de Saída da Marca de Serviço para a rede gerenciada de um workspace de machine learning. ServiceTagDestination

ServiceTagDestination

Nome Descrição Valor
ação A enumeração de ação para a regra de rede. 'Allow'
'Deny'
portRanges string
protocolo string
serviceTag string

ManagedNetworkProvisionStatus

Nome Descrição Valor
sparkReady bool
status Status da rede gerenciada de um workspace de machine learning. 'Ativo'
'Inativo'

ServerlessComputeSettings

Nome Descrição Valor
serverlessComputeCustomSubnet A ID de recurso de uma sub-rede de rede virtual existente na qual os nós de computação sem servidor devem ser implantados string
serverlessComputeNoPublicIP O sinalizador a ser sinalizado se nós de computação sem servidor implantados na vNet personalizada não tiverem endereços IP públicos para um workspace com ponto de extremidade privado bool

ServiceManagedResourcesSettings

Nome Descrição Valor
cosmosDb As configurações para a conta do cosmosdb gerenciada pelo serviço. CosmosDbSettings

CosmosDbSettings

Nome Descrição Valor
collectionsThroughput A taxa de transferência das coleções no banco de dados cosmosdb INT

SharedPrivateLinkResource

Nome Descrição Valor
name Nome exclusivo do link privado. string
properties Propriedades do recurso. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nome Descrição Valor
groupId A ID do grupo de recursos do link privado. string
privateLinkResourceId A ID do recurso à qual o link privado se vincula. string
requestMessage Mensagem de solicitação. string
status Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço. 'Aprovado'
'Desconectado'
'Pendente'
'Rejeitado'
'Timeout'

Sku

Nome Descrição Valor
ALOCADA Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se expansão/redução não for possível para o recurso, isso poderá ser omitido. INT
família Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome da SKU. Ex - P3. Normalmente, é um código de letra+número cadeia de caracteres (obrigatório)
tamanho O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo. string
Camada Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. 'Básico'
'Gratuito'
'Premium'
'Standard'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Azure Machine Learning Workspace

Implantar no Azure
Este modelo cria um novo workspace do Azure Machine Learning, juntamente com uma conta de armazenamento criptografada, o KeyVault e o log do Application Insights
Criar workspace do AML com vários conjuntos de dados & Datastores

Implantar no Azure
Este modelo cria o workspace do Azure Machine Learning com vários conjuntos de dados & armazenamentos de dados.
Configuração segura de ponta a ponta do Azure Machine Learning

Implantar no Azure
Esse conjunto de modelos do Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta em uma configuração segura. Essa implementação de referência inclui o Workspace, um cluster de computação, uma instância de computação e um cluster do AKS privado anexado.
Configuração segura de ponta a ponta do Azure Machine Learning (herdada)

Implantar no Azure
Esse conjunto de modelos do Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta em uma configuração segura. Essa implementação de referência inclui o Workspace, 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

Implantar no Azure
Esse modelo cria um destino de computação do AKS em determinado workspace do serviço do Azure Machine Learning com um endereço IP privado.
Criar um workspace do serviço do Azure Machine Learning

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. Essa configuração descreve o conjunto mínimo de recursos necessários para começar a usar o Azure Machine Learning.
Criar um workspace do serviço do Azure Machine Learning (CMK)

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. O exemplo mostra como configurar o Azure Machine Learning para criptografia com uma chave de criptografia gerenciada pelo cliente.
Criar um workspace do serviço do Azure Machine Learning (vnet)

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. Essa configuração descreve o conjunto de recursos necessários para começar a usar o Azure Machine Learning em uma configuração isolada de rede.
Criar um workspace do serviço do Azure Machine Learning (herdado)

Implantar no Azure
Esse modelo de implantação especifica um workspace do Azure Machine Learning e seus recursos associados, incluindo Key Vault do Azure, Armazenamento do Azure, insights Aplicativo Azure e Registro de Contêiner do Azure. Essa configuração descreve o conjunto de recursos necessários para começar a usar o Azure Machine Learning em uma configuração isolada de rede.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso workspaces pode ser implantado com operações direcionadas:

  • Grupos de recursos

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

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces@2023-10-01"
  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"
      containerRegistry = "string"
      description = "string"
      discoveryUrl = "string"
      encryption = {
        identity = {
          userAssignedIdentity = "string"
        }
        keyVaultProperties = {
          identityClientId = "string"
          keyIdentifier = "string"
          keyVaultArmId = "string"
        }
        status = "string"
      }
      featureStoreSettings = {
        computeRuntime = {
          sparkRuntimeVersion = "string"
        }
        offlineStoreConnectionName = "string"
        onlineStoreConnectionName = "string"
      }
      friendlyName = "string"
      hbiWorkspace = bool
      imageBuildCompute = "string"
      keyVault = "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"
          }
        }
      ]
      storageAccount = "string"
      v1LegacyMode = bool
    }
    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, use:

  type = "FQDN"
  destination = "string"

Para PrivateEndpoint, use:

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

Para ServiceTag, use:

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

Valores de propriedade

workspaces

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

Limite de caracteres: 3 a 33

Caracteres válidos:
Caracteres alfanuméricos, hifens e sublinhados.
local Especifica o local do recurso. string
parent_id Para implantar em um grupo de recursos, use a ID desse grupo de recursos. cadeia de caracteres (obrigatório)
marcas Contém marcas de recurso definidas como pares chave/valor. Dicionário de nomes e valores de marcas.
sku A SKU do workspace. Sku
kind string
identidade A identidade do recurso. ManagedServiceIdentity
properties As propriedades do workspace de machine learning. WorkspaceProperties

ManagedServiceIdentity

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

UserAssignedIdentities

Nome Descrição Valor
{propriedade personalizada} UserAssignedIdentity

UserAssignedIdentity

Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.

WorkspaceProperties

Nome Descrição Valor
allowPublicAccessWhenBehindVnet O sinalizador para indicar se deseja permitir o acesso público quando estiver atrás da VNet. bool
applicationInsights ID do ARM dos insights do aplicativo associados a esse workspace. string
containerRegistry ID do ARM do registro de contêiner associado a esse workspace. string
descrição A descrição deste workspace. string
discoveryUrl URL do serviço de descoberta para identificar pontos de extremidade regionais para serviços de experimentação de machine learning string
criptografia As configurações de criptografia do workspace do Azure ML. Encryptionproperty
featureStoreSettings Configurações para o workspace do tipo de repositório de recursos. FeatureStoreSettings
friendlyName O nome amigável para este workspace. Esse nome é mutável string
hbiWorkspace O sinalizador para sinalizar dados HBI no workspace e reduzir os dados de diagnóstico coletados pelo serviço bool
imageBuildCompute O nome da computação para build de imagem string
keyVault ID do ARM do cofre de chaves associado a esse workspace. Isso não pode ser alterado depois que o workspace for criado string
managedNetwork Configurações de Rede Gerenciada para um workspace de machine learning. ManagedNetworkSettings
primaryUserAssignedIdentity A ID de recurso de identidade atribuída pelo usuário que representa a identidade do workspace. string
publicNetworkAccess Se as solicitações da Rede Pública são permitidas. "Desabilitado"
"Habilitado"
serverlessComputeSettings Configurações para computação sem servidor criadas no workspace ServerlessComputeSettings
serviceManagedResourcesSettings As configurações de recurso gerenciado pelo serviço. ServiceManagedResourcesSettings
sharedPrivateLinkResources A lista de recursos de link privado compartilhados neste workspace. SharedPrivateLinkResource[]
storageAccount ID do ARM da conta de armazenamento associada a esse workspace. Isso não pode ser alterado depois que o workspace for criado string
v1LegacyMode Habilitar v1_legacy_mode pode impedir o uso de recursos fornecidos pela API v2. bool

Encryptionproperty

Nome Descrição Valor
identidade A identidade que será usada para acessar o cofre de chaves para criptografia em repouso. IdentityForCmk
keyVaultProperties Propriedades do cofre de chaves do cliente. EncryptionKeyVaultProperties (obrigatório)
status Indica se a criptografia está habilitada ou não para o workspace. "Desabilitado"
"Habilitado" (obrigatório)

IdentityForCmk

Nome Descrição Valor
userAssignedIdentity O ArmId da identidade atribuída pelo usuário que será usada para acessar o cofre de chaves gerenciado pelo cliente string

EncryptionKeyVaultProperties

Nome Descrição Valor
identityClientId Para uso futuro – a ID do cliente da identidade que será usada para acessar o cofre de chaves. string
keyIdentifier URI do cofre de chaves para acessar a chave de criptografia. cadeia de caracteres (obrigatório)
keyVaultArmId O ArmId do keyVault em que a chave de criptografia de propriedade do cliente está presente. cadeia de caracteres (obrigatório)

FeatureStoreSettings

Nome Descrição Valor
computeRuntime Configuração de runtime de computação para o workspace do tipo de repositório de recursos. ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nome Descrição Valor
sparkRuntimeVersion string

ManagedNetworkSettings

Nome Descrição Valor
isolationMode Modo de isolamento para a rede gerenciada de um workspace de machine learning. "AllowInternetOutbound"
"AllowOnlyApprovedOutbound"
"Desabilitado"
outboundRules Dicionário de {OutboundRule} ManagedNetworkSettingsOutboundRules
status Status do Provisionamento para a rede gerenciada de um workspace de machine learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nome Descrição Valor
{propriedade personalizada} OutboundRule

OutboundRule

Nome Descrição Valor
category Categoria de uma regra de saída de rede gerenciada de um workspace de machine learning. "Recomendado"
"Obrigatório"
"UserDefined"
status Tipo de regra de saída de rede gerenciada de um workspace 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 gerenciada de um workspace de machine learning. "FQDN" (obrigatório)
destino string

PrivateEndpointOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerenciada de um workspace de machine learning. "PrivateEndpoint" (obrigatório)
destino Destino do ponto de extremidade privado para uma regra de saída de ponto de extremidade privado para a rede gerenciada de um workspace de machine learning. PrivateEndpointDestination

PrivateEndpointDestination

Nome Descrição Valor
serviceResourceId string
sparkEnabled bool
sparkStatus Tipo de regra de saída de rede gerenciada de um workspace de machine learning. "Ativo"
"Inativo"
subresourceTarget string

ServiceTagOutboundRule

Nome Descrição Valor
tipo Tipo de regra de saída de rede gerenciada de um workspace de machine learning. "ServiceTag" (obrigatório)
destino Destino da Marca de Serviço para uma Regra de Saída da Marca de Serviço para a rede gerenciada de um workspace de machine learning. ServiceTagDestination

ServiceTagDestination

Nome Descrição Valor
ação 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 Status da rede gerenciada de um workspace de machine learning. "Ativo"
"Inativo"

ServerlessComputeSettings

Nome Descrição Valor
serverlessComputeCustomSubnet A ID de recurso de uma sub-rede de rede virtual existente na qual os nós de computação sem servidor devem ser implantados string
serverlessComputeNoPublicIP O sinalizador a ser sinalizado se nós de computação sem servidor implantados na vNet personalizada não tiverem endereços IP públicos para um workspace com ponto de extremidade privado bool

ServiceManagedResourcesSettings

Nome Descrição Valor
cosmosDb As configurações para a conta do cosmosdb gerenciada pelo serviço. CosmosDbSettings

CosmosDbSettings

Nome Descrição Valor
collectionsThroughput A taxa de transferência das coleções no banco de dados cosmosdb INT

SharedPrivateLinkResource

Nome Descrição Valor
name Nome exclusivo do link privado. string
properties Propriedades do recurso. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nome Descrição Valor
groupId A ID do grupo de recursos do link privado. string
privateLinkResourceId A ID do recurso à qual o link privado se vincula. string
requestMessage Mensagem de solicitação. string
status Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço. "Aprovado"
"Desconectado"
"Pendente"
"Rejeitado"
"Tempo limite"

Sku

Nome Descrição Valor
ALOCADA Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se expansão/redução não for possível para o recurso, isso poderá ser omitido. INT
família Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome da SKU. Ex - P3. Normalmente, é um código de letra+número cadeia de caracteres (obrigatório)
tamanho O tamanho do SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo. string
Camada Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. “Basic”
"Free"
"Premium"
"Standard"