Espaces de travail Microsoft.MachineLearningServices 2023-06-01-preview

Définition de ressource Bicep

Le type de ressource des espaces de travail peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.MachineLearningServices/workspaces, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces@2023-06-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'
    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'
    }
  }
}

Objets OutboundRule

Définissez la propriété type pour spécifier le type d’objet.

Pour le nom de domaine complet, utilisez :

  type: 'FQDN'
  destination: 'string'

Pour PrivateEndpoint, utilisez :

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

Pour ServiceTag, utilisez :

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

Valeurs de propriétés

workspaces

Nom Description Valeur
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 3-33

Caractères valides :
Caractères alphanumériques, traits d’union et traits de soulignement.
location string
tags Dictionnaire de {string} Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku facultatif. Ce champ doit être implémenté par le RP, car AML prend en charge plusieurs niveaux Sku
kind string
identité Identité de service managée (identités attribuées par le système et/ou attribuées par l’utilisateur) ManagedServiceIdentity
properties Attributs supplémentaires de l’entité. WorkspaceProperties (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs du dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

UserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

WorkspaceProperties

Nom Description Valeur
allowPublicAccessWhenBehindVnet Indicateur permettant d’indiquer s’il faut autoriser l’accès public derrière le réseau virtuel. bool
applicationInsights ID ARM de l’application Insights associée à cet espace de travail. string
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry ID ARM du registre de conteneurs associé à cet espace de travail. string
description Description de cet espace de travail. string
discoveryUrl URL du service de découverte afin d’identifier les points de terminaison régionaux pour les services d’expérimentation machine learning string
enableDataIsolation bool
le chiffrement EncryptionProperty
existingWorkspaces string[]
featureStoreSettings Paramètres de l’espace de travail du type de magasin de fonctionnalités. FeatureStoreSettings
friendlyName Nom convivial de cet espace de travail. Ce nom en mutable string
hbiWorkspace Indicateur pour signaler les données HBI dans l’espace de travail et réduire les données de diagnostic collectées par le service bool
hubResourceId string
imageBuildCompute Nom de calcul pour la génération d’image string
keyVault ID ARM du coffre de clés associé à cet espace de travail. Cela ne peut pas être modifié une fois l’espace de travail créé string
keyVaults string[]
managedNetwork Paramètres réseau managés pour un espace de travail Machine Learning. ManagedNetworkSettings
primaryUserAssignedIdentity ID de ressource d’identité affectée par l’utilisateur qui représente l’identité de l’espace de travail. string
publicNetworkAccess Indique si les demandes provenant du réseau public sont autorisées. 'Désactivé'
'Enabled'
serviceManagedResourcesSettings Paramètres des ressources gérées par le service. ServiceManagedResourcesSettings
sharedPrivateLinkResources Liste des ressources de liaison privée partagées dans cet espace de travail. SharedPrivateLinkResource[]
softDeleteRetentionInDays Durée de rétention en jours après la suppression réversible de l’espace de travail. int
storageAccount ID ARM du compte de stockage associé à cet espace de travail. Cela ne peut pas être modifié une fois l’espace de travail créé string
storageAccounts string[]
systemDatastoresAuthMode Mode d’authentification utilisé pour accéder aux magasins de données système de l’espace de travail. string
v1LegacyMode L’activation de v1_legacy_mode peut vous empêcher d’utiliser les fonctionnalités fournies par l’API v2. bool
workspaceHubConfig Objet de configuration d’WorkspaceHub. WorkspaceHubConfig

EncryptionProperty

Nom Description Valeur
cosmosDbResourceId Le compte byok cosmosdb que le client apporte pour stocker les données du client
avec chiffrement
string
identité Identité à utiliser avec le coffre de clés IdentityForCmk
keyVaultProperties Détails de KeyVault pour effectuer le chiffrement KeyVaultProperties (obligatoire)
searchAccountResourceId Le compte de recherche byok que le client apporte pour stocker les données du client
avec chiffrement
string
status Indique si le chiffrement est activé pour l’espace de travail. 'Désactivé'
'Enabled' (obligatoire)
storageAccountResourceId Compte de stockage byok que le client apporte pour stocker les données du client
avec chiffrement
string

IdentityForCmk

Nom Description Valeur
userAssignedIdentity UserAssignedIdentity à utiliser pour extraire la clé de chiffrement de keyVault string

KeyVaultProperties

Nom Description Valeur
identityClientId Actuellement, nous prenons uniquement en charge msi SystemAssigned.
Nous en avons besoin lorsque nous prenons en charge UserAssignedIdentities
string
keyIdentifier Identificateur de clé KeyVault pour chiffrer les données chaîne (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm ID qui contient la clé de chiffrement des données chaîne (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]

FeatureStoreSettings

Nom Description Valeur
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nom Description Valeur
sparkRuntimeVersion string

ManagedNetworkSettings

Nom Description Valeur
isolationMode Mode d’isolation pour le réseau managé d’un espace de travail Machine Learning. 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Désactivé'
outboundRules Dictionnaire de {OutboundRule} ManagedNetworkSettingsOutboundRules
status État de l’approvisionnement pour le réseau managé d’un espace de travail Machine Learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nom Description Valeur
{propriété personnalisée} OutboundRule

OutboundRule

Nom Description Valeur
catégorie Catégorie d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'Recommandé'
'Obligatoire'
'UserDefined'
status Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'Active'
'Inactif'
type Définir le type d’objet FQDN
PrivateEndpoint
ServiceTag (obligatoire)

FqdnOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'FQDN' (obligatoire)
destination string

PrivateEndpointOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'PrivateEndpoint' (obligatoire)
destination Destination de point de terminaison privé pour une règle de trafic sortant de point de terminaison privé pour le réseau managé d’un espace de travail Machine Learning. PrivateEndpointDestination

PrivateEndpointDestination

Nom Description Valeur
serviceResourceId string
sparkEnabled bool
sparkStatus Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'Active'
'Inactif'
sous-ressourceTarget string

ServiceTagOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'ServiceTag' (obligatoire)
destination Destination d’étiquette de service pour une règle sortante d’étiquette de service pour le réseau managé d’un espace de travail Machine Learning. ServiceTagDestination

ServiceTagDestination

Nom Description Valeur
action Énumération d’action pour la règle de mise en réseau. 'Autoriser'
'Deny'
portRanges string
protocol string
serviceTag string

ManagedNetworkProvisionStatus

Nom Description Valeur
sparkReady bool
status État du réseau managé d’un espace de travail Machine Learning. 'Active'
'Inactif'

ServiceManagedResourcesSettings

Nom Description Valeur
cosmosDb CosmosDbSettings

CosmosDbSettings

Nom Description Valeur
collectionsThroughput int

SharedPrivateLinkResource

Nom Description Valeur
name Nom unique de la liaison privée string
properties Propriétés d’une ressource de liaison privée partagée. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nom Description Valeur
groupId ID de groupe de la liaison privée string
privateLinkResourceId l’ID de ressource auquel la liaison privée est liée string
requestMessage Message de requête string
status Connexion status du consommateur du service avec le fournisseur de services 'Approuvé'
'Déconnecté'
'En attente'
« Rejeté »
'Délai d’expiration'

WorkspaceHubConfig

Nom Description Valeur
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup string

Sku

Nom Description Valeur
capacité Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si un scale-out/scale-in n’est pas possible pour la ressource, cela peut être omis. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU. Ex - P3. Il s’agit généralement d’un code lettre+nombre string (obligatoire)
taille Taille de la référence SKU. Lorsque le champ name est la combinaison du niveau et d’une autre valeur, il s’agit du code autonome. string
Niveau Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas requis sur un PUT. 'De base'
'Gratuit'
'Premium'
'Standard'

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Espace de travail Azure Machine Learning

Déployer sur Azure
Ce modèle crée un espace de travail Azure Machine Learning, ainsi qu’un compte de stockage chiffré, keyVault et la journalisation Applications Insights
Créer un espace de travail AML avec plusieurs jeux de données & magasins de données

Déployer sur Azure
Ce modèle crée un espace de travail Azure Machine Learning avec plusieurs jeux de données & magasins de données.
Configuration sécurisée de bout en bout d’Azure Machine Learning

Déployer sur Azure
Cet ensemble de modèles Bicep montre comment configurer Azure Machine Learning de bout en bout dans une configuration sécurisée. Cette implémentation de référence inclut l’espace de travail, un cluster de calcul, des instance de calcul et un cluster AKS privé attaché.
Configuration sécurisée de bout en bout d’Azure Machine Learning (héritée)

Déployer sur Azure
Cet ensemble de modèles Bicep montre comment configurer Azure Machine Learning de bout en bout dans une configuration sécurisée. Cette implémentation de référence inclut l’espace de travail, un cluster de calcul, des instance de calcul et un cluster AKS privé attaché.
Créer une cible de calcul AKS avec une adresse IP privée

Déployer sur Azure
Ce modèle crée une cible de calcul AKS dans un espace de travail de service Azure Machine Learning donné avec une adresse IP privée.
Créer un espace de travail Azure Machine Learning service

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. Cette configuration décrit l’ensemble minimal de ressources dont vous avez besoin pour commencer à utiliser Azure Machine Learning.
Créer un espace de travail azure Machine Learning Service (CMK)

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. L’exemple montre comment configurer Azure Machine Learning pour le chiffrement avec une clé de chiffrement gérée par le client.
Créer un espace de travail du service Azure Machine Learning (réseau virtuel)

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. Cette configuration décrit l’ensemble des ressources dont vous avez besoin pour commencer à utiliser Azure Machine Learning dans une configuration réseau isolée.
Créer un espace de travail du service Azure Machine Learning (hérité)

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. Cette configuration décrit l’ensemble des ressources dont vous avez besoin pour commencer à utiliser Azure Machine Learning dans une configuration réseau isolée.

Définition de ressources de modèle ARM

Le type de ressource d’espaces de travail peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.MachineLearningServices/workspaces, ajoutez le JSON suivant à votre modèle.

{
  "type": "Microsoft.MachineLearningServices/workspaces",
  "apiVersion": "2023-06-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",
    "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"
    }
  }
}

Objets OutboundRule

Définissez la propriété type pour spécifier le type d’objet.

Pour FQDN, utilisez :

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

Pour PrivateEndpoint, utilisez :

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

Pour ServiceTag, utilisez :

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

Valeurs de propriétés

workspaces

Nom Description Valeur
type Type de ressource « Microsoft.MachineLearningServices/workspaces »
apiVersion Version de l’API de ressource '2023-06-01-preview'
name Nom de la ressource string (obligatoire)

Limite de caractères : 3-33

Caractères valides :
Caractères alphanumériques, traits d’union et traits de soulignement.
location string
tags Dictionnaire de {string} Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku facultatif. Ce champ doit être implémenté par le fournisseur de ressources, car AML prend en charge plusieurs niveaux Sku
kind string
identité Identité de service managée (identités affectées par le système et/ou par l’utilisateur) ManagedServiceIdentity
properties Attributs supplémentaires de l’entité. WorkspaceProperties (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities sont des ID de ressource ARM au format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs du dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

UserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

WorkspaceProperties

Nom Description Valeur
allowPublicAccessWhenBehindVnet Indicateur permettant d’indiquer s’il faut autoriser l’accès public derrière le réseau virtuel. bool
applicationInsights ID ARM de l’application Insights associée à cet espace de travail. string
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry ID ARM du registre de conteneurs associé à cet espace de travail. string
description Description de cet espace de travail. string
discoveryUrl URL du service de découverte afin d’identifier les points de terminaison régionaux pour les services d’expérimentation machine learning string
enableDataIsolation bool
le chiffrement EncryptionProperty
existingWorkspaces string[]
featureStoreSettings Paramètres de l’espace de travail du type de magasin de fonctionnalités. FeatureStoreSettings
friendlyName Nom convivial de cet espace de travail. Ce nom en mutable string
hbiWorkspace Indicateur pour signaler les données HBI dans l’espace de travail et réduire les données de diagnostic collectées par le service bool
hubResourceId string
imageBuildCompute Nom de calcul pour la génération d’image string
keyVault ID ARM du coffre de clés associé à cet espace de travail. Cela ne peut pas être modifié une fois l’espace de travail créé string
keyVaults string[]
managedNetwork Paramètres réseau managés pour un espace de travail Machine Learning. ManagedNetworkSettings
primaryUserAssignedIdentity ID de ressource d’identité affectée par l’utilisateur qui représente l’identité de l’espace de travail. string
publicNetworkAccess Indique si les demandes provenant du réseau public sont autorisées. 'Désactivé'
'Enabled'
serviceManagedResourcesSettings Paramètres des ressources gérées par le service. ServiceManagedResourcesSettings
sharedPrivateLinkResources Liste des ressources de liaison privée partagées dans cet espace de travail. SharedPrivateLinkResource[]
softDeleteRetentionInDays Durée de rétention en jours après la suppression réversible de l’espace de travail. int
storageAccount ID ARM du compte de stockage associé à cet espace de travail. Cela ne peut pas être modifié une fois l’espace de travail créé string
storageAccounts string[]
systemDatastoresAuthMode Mode d’authentification utilisé pour accéder aux magasins de données système de l’espace de travail. string
v1LegacyMode L’activation de v1_legacy_mode peut vous empêcher d’utiliser les fonctionnalités fournies par l’API v2. bool
workspaceHubConfig Objet de configuration d’WorkspaceHub. WorkspaceHubConfig

EncryptionProperty

Nom Description Valeur
cosmosDbResourceId Compte byok cosmosdb que le client apporte pour stocker les données du client
avec chiffrement
string
identité Identité à utiliser avec le keyVault IdentityForCmk
keyVaultProperties Détails de KeyVault pour effectuer le chiffrement KeyVaultProperties (obligatoire)
searchAccountResourceId Compte de recherche byok que le client apporte pour stocker les données du client
avec chiffrement
string
status Indique si le chiffrement est activé pour l’espace de travail. 'Désactivé'
'Enabled' (obligatoire)
storageAccountResourceId Compte de stockage byok que le client apporte pour stocker les données du client
avec chiffrement
string

IdentityForCmk

Nom Description Valeur
userAssignedIdentity UserAssignedIdentity à utiliser pour extraire la clé de chiffrement de keyVault string

KeyVaultProperties

Nom Description Valeur
identityClientId Actuellement, nous prenons uniquement en charge msi SystemAssigned.
Nous en avons besoin lorsque nous prenons en charge UserAssignedIdentities
string
keyIdentifier Identificateur de clé KeyVault pour chiffrer les données chaîne (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm ID qui contient la clé de chiffrement des données chaîne (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]

FeatureStoreSettings

Nom Description Valeur
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nom Description Valeur
sparkRuntimeVersion string

ManagedNetworkSettings

Nom Description Valeur
isolationMode Mode d’isolation pour le réseau managé d’un espace de travail Machine Learning. 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Désactivé'
outboundRules Dictionnaire de {OutboundRule} ManagedNetworkSettingsOutboundRules
status État de l’approvisionnement pour le réseau managé d’un espace de travail Machine Learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nom Description Valeur
{propriété personnalisée} OutboundRule

OutboundRule

Nom Description Valeur
catégorie Catégorie d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'Recommandé'
'Obligatoire'
'UserDefined'
status Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'Active'
'Inactif'
type Définir le type d’objet FQDN
PrivateEndpoint
ServiceTag (obligatoire)

FqdnOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'FQDN' (obligatoire)
destination string

PrivateEndpointOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'PrivateEndpoint' (obligatoire)
destination Destination de point de terminaison privé pour une règle de trafic sortant de point de terminaison privé pour le réseau managé d’un espace de travail Machine Learning. PrivateEndpointDestination

PrivateEndpointDestination

Nom Description Valeur
serviceResourceId string
sparkEnabled bool
sparkStatus Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'Active'
'Inactif'
sous-ressourceTarget string

ServiceTagOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. 'ServiceTag' (obligatoire)
destination Destination d’étiquette de service pour une règle sortante d’étiquette de service pour le réseau managé d’un espace de travail Machine Learning. ServiceTagDestination

ServiceTagDestination

Nom Description Valeur
action Énumération d’action pour la règle de mise en réseau. 'Autoriser'
'Deny'
portRanges string
protocol string
serviceTag string

ManagedNetworkProvisionStatus

Nom Description Valeur
sparkReady bool
status État du réseau managé d’un espace de travail Machine Learning. 'Active'
'Inactif'

ServiceManagedResourcesSettings

Nom Description Valeur
cosmosDb CosmosDbSettings

CosmosDbSettings

Nom Description Valeur
collectionsThroughput int

SharedPrivateLinkResource

Nom Description Valeur
name Nom unique de la liaison privée string
properties Propriétés d’une ressource de liaison privée partagée. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nom Description Valeur
groupId ID de groupe de la liaison privée string
privateLinkResourceId ID de ressource auquel la liaison privée est liée string
requestMessage Message de requête string
status Connexion status du consommateur de services avec le fournisseur de services 'Approuvé'
'Déconnecté'
'En attente'
« Rejeté »
'Délai d’expiration'

WorkspaceHubConfig

Nom Description Valeur
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup string

Sku

Nom Description Valeur
capacité Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si un scale-out/scale-in n’est pas possible pour la ressource, cela peut être omis. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU. Ex - P3. Il s’agit généralement d’un code lettre+nombre string (obligatoire)
taille Taille de la référence SKU. Lorsque le champ name est la combinaison du niveau et d’une autre valeur, il s’agit du code autonome. string
Niveau Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas requis sur un PUT. 'De base'
'Gratuit'
'Premium'
'Standard'

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Espace de travail Azure Machine Learning

Déployer sur Azure
Ce modèle crée un espace de travail Azure Machine Learning, ainsi qu’un compte de stockage chiffré, keyVault et la journalisation Applications Insights
Créer un espace de travail AML avec plusieurs jeux de données & magasins de données

Déployer sur Azure
Ce modèle crée un espace de travail Azure Machine Learning avec plusieurs jeux de données & magasins de données.
Configuration sécurisée de bout en bout d’Azure Machine Learning

Déployer sur Azure
Cet ensemble de modèles Bicep montre comment configurer Azure Machine Learning de bout en bout dans une configuration sécurisée. Cette implémentation de référence inclut l’espace de travail, un cluster de calcul, des instance de calcul et un cluster AKS privé attaché.
Configuration sécurisée de bout en bout d’Azure Machine Learning (héritée)

Déployer sur Azure
Cet ensemble de modèles Bicep montre comment configurer Azure Machine Learning de bout en bout dans une configuration sécurisée. Cette implémentation de référence inclut l’espace de travail, un cluster de calcul, des instance de calcul et un cluster AKS privé attaché.
Créer une cible de calcul AKS avec une adresse IP privée

Déployer sur Azure
Ce modèle crée une cible de calcul AKS dans un espace de travail de service Azure Machine Learning donné avec une adresse IP privée.
Créer un espace de travail Azure Machine Learning service

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. Cette configuration décrit l’ensemble minimal de ressources dont vous avez besoin pour commencer à utiliser Azure Machine Learning.
Créer un espace de travail azure Machine Learning Service (CMK)

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. L’exemple montre comment configurer Azure Machine Learning pour le chiffrement avec une clé de chiffrement gérée par le client.
Créer un espace de travail du service Azure Machine Learning (réseau virtuel)

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. Cette configuration décrit l’ensemble des ressources dont vous avez besoin pour commencer à utiliser Azure Machine Learning dans une configuration réseau isolée.
Créer un espace de travail du service Azure Machine Learning (hérité)

Déployer sur Azure
Ce modèle de déploiement spécifie un espace de travail Azure Machine Learning et ses ressources associées, notamment Azure Key Vault, Stockage Azure, Azure Application Insights et Azure Container Registry. Cette configuration décrit l’ensemble des ressources dont vous avez besoin pour commencer à utiliser Azure Machine Learning dans une configuration réseau isolée.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource d’espaces de travail peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.MachineLearningServices/workspaces, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces@2023-06-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"
      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"
  })
}

Objets OutboundRule

Définissez la propriété type pour spécifier le type d’objet.

Pour FQDN, utilisez :

  type = "FQDN"
  destination = "string"

Pour PrivateEndpoint, utilisez :

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

Pour ServiceTag, utilisez :

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

Valeurs de propriétés

workspaces

Nom Description Valeur
type Type de ressource « Microsoft.MachineLearningServices/workspaces@2023-06-01-preview »
name Nom de la ressource string (obligatoire)

Limite de caractères : 3-33

Caractères valides :
Caractères alphanumériques, traits d’union et traits de soulignement.
location string
parent_id Pour effectuer un déploiement dans un groupe de ressources, utilisez l’ID de ce groupe de ressources. string (obligatoire)
tags Dictionnaire de {string} Dictionnaire de noms et de valeurs d’étiquettes.
sku facultatif. Ce champ doit être implémenté par le fournisseur de ressources, car AML prend en charge plusieurs niveaux Sku
kind string
identité Identité de service managée (identités affectées par le système et/ou par l’utilisateur) ManagedServiceIdentity
properties Attributs supplémentaires de l’entité. WorkspaceProperties (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « SystemAssigned »
« SystemAssigned,UserAssigned »
« UserAssigned » (obligatoire)
identity_ids Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities sont des ID de ressource ARM au format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs du dictionnaire peuvent être des objets vides ({}) dans les requêtes. Tableau d’ID d’identité utilisateur.

UserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

WorkspaceProperties

Nom Description Valeur
allowPublicAccessWhenBehindVnet Indicateur permettant d’indiquer s’il faut autoriser l’accès public derrière le réseau virtuel. bool
applicationInsights ID ARM de l’application Insights associée à cet espace de travail. string
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry ID ARM du registre de conteneurs associé à cet espace de travail. string
description Description de cet espace de travail. string
discoveryUrl URL du service de découverte afin d’identifier les points de terminaison régionaux pour les services d’expérimentation machine learning string
enableDataIsolation bool
le chiffrement EncryptionProperty
existingWorkspaces string[]
featureStoreSettings Paramètres de l’espace de travail du type de magasin de fonctionnalités. FeatureStoreSettings
friendlyName Nom convivial de cet espace de travail. Ce nom en mutable string
hbiWorkspace Indicateur pour signaler les données HBI dans l’espace de travail et réduire les données de diagnostic collectées par le service bool
hubResourceId string
imageBuildCompute Nom de calcul pour la génération d’image string
keyVault ID ARM du coffre de clés associé à cet espace de travail. Cela ne peut pas être modifié une fois l’espace de travail créé string
keyVaults string[]
managedNetwork Paramètres réseau managés pour un espace de travail Machine Learning. ManagedNetworkSettings
primaryUserAssignedIdentity ID de ressource d’identité affectée par l’utilisateur qui représente l’identité de l’espace de travail. string
publicNetworkAccess Indique si les demandes provenant du réseau public sont autorisées. « Désactivé »
« Activé »
serviceManagedResourcesSettings Paramètres des ressources gérées par le service. ServiceManagedResourcesSettings
sharedPrivateLinkResources Liste des ressources de liaison privée partagées dans cet espace de travail. SharedPrivateLinkResource[]
softDeleteRetentionInDays Durée de rétention en jours après la suppression réversible de l’espace de travail. int
storageAccount ID ARM du compte de stockage associé à cet espace de travail. Cela ne peut pas être modifié une fois l’espace de travail créé string
storageAccounts string[]
systemDatastoresAuthMode Mode d’authentification utilisé pour accéder aux magasins de données système de l’espace de travail. string
v1LegacyMode L’activation de v1_legacy_mode peut vous empêcher d’utiliser les fonctionnalités fournies par l’API v2. bool
workspaceHubConfig Objet de configuration d’WorkspaceHub. WorkspaceHubConfig

EncryptionProperty

Nom Description Valeur
cosmosDbResourceId Le compte byok cosmosdb que le client apporte pour stocker les données du client
avec chiffrement
string
identité Identité à utiliser avec le coffre de clés IdentityForCmk
keyVaultProperties Détails de KeyVault pour effectuer le chiffrement KeyVaultProperties (obligatoire)
searchAccountResourceId Le compte de recherche byok que le client apporte pour stocker les données du client
avec chiffrement
string
status Indique si le chiffrement est activé pour l’espace de travail. « Désactivé »
« Activé » (obligatoire)
storageAccountResourceId Compte de stockage byok que le client apporte pour stocker les données du client
avec chiffrement
string

IdentityForCmk

Nom Description Valeur
userAssignedIdentity UserAssignedIdentity à utiliser pour extraire la clé de chiffrement à partir de KeyVault string

KeyVaultProperties

Nom Description Valeur
identityClientId Actuellement, nous prenons en charge uniquement SystemAssigned MSI.
Nous en avons besoin quand nous prenons en charge UserAssignedIdentities
string
keyIdentifier Identificateur de clé KeyVault pour chiffrer les données string (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm ID qui contient la clé de chiffrement des données string (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]

FeatureStoreSettings

Nom Description Valeur
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

ComputeRuntimeDto

Nom Description Valeur
sparkRuntimeVersion string

ManagedNetworkSettings

Nom Description Valeur
isolationMode Mode d’isolation pour le réseau managé d’un espace de travail Machine Learning. « AllowInternetOutbound »
« AllowOnlyApprovedOutbound »
« Désactivé »
outboundRules Dictionnaire de {OutboundRule} ManagedNetworkSettingsOutboundRules
status État de l’approvisionnement pour le réseau managé d’un espace de travail Machine Learning. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Nom Description Valeur
{propriété personnalisée} OutboundRule

OutboundRule

Nom Description Valeur
catégorie Catégorie d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. « Recommandé »
« Obligatoire »
« UserDefined »
status Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. « Actif »
« Inactif »
type Définir le type d’objet FQDN
PrivateEndpoint
ServiceTag (obligatoire)

FqdnOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. « FQDN » (obligatoire)
destination string

PrivateEndpointOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. « PrivateEndpoint » (obligatoire)
destination Destination de point de terminaison privé pour une règle de trafic sortant de point de terminaison privé pour le réseau managé d’un espace de travail Machine Learning. PrivateEndpointDestination

PrivateEndpointDestination

Nom Description Valeur
serviceResourceId string
sparkEnabled bool
sparkStatus Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. « Actif »
« Inactif »
sous-ressourceTarget string

ServiceTagOutboundRule

Nom Description Valeur
type Type d’une règle de trafic sortant de réseau managé d’un espace de travail Machine Learning. « ServiceTag » (obligatoire)
destination Destination d’étiquette de service pour une règle sortante d’étiquette de service pour le réseau managé d’un espace de travail Machine Learning. ServiceTagDestination

ServiceTagDestination

Nom Description Valeur
action Énumération d’action pour la règle de mise en réseau. « Autoriser »
« Refuser »
portRanges string
protocol string
serviceTag string

ManagedNetworkProvisionStatus

Nom Description Valeur
sparkReady bool
status État du réseau managé d’un espace de travail Machine Learning. « Actif »
« Inactif »

ServiceManagedResourcesSettings

Nom Description Valeur
cosmosDb CosmosDbSettings

CosmosDbSettings

Nom Description Valeur
collectionsThroughput int

SharedPrivateLinkResource

Nom Description Valeur
name Nom unique de la liaison privée string
properties Propriétés d’une ressource de liaison privée partagée. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Nom Description Valeur
groupId ID de groupe de la liaison privée string
privateLinkResourceId l’ID de ressource auquel la liaison privée est liée string
requestMessage Message de requête string
status Connexion status du consommateur du service avec le fournisseur de services « Approuvé »
« Déconnecté »
« En attente »
« Rejeté »
« Délai d’expiration »

WorkspaceHubConfig

Nom Description Valeur
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup string

Sku

Nom Description Valeur
capacité Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si le scale-out/in n’est pas possible pour la ressource, cela peut être omis. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU. Ex - P3. Il s’agit généralement d’un code lettre+nombre chaîne (obligatoire)
taille Taille de la référence SKU. Lorsque le champ de nom est la combinaison du niveau et d’une autre valeur, il s’agit du code autonome. string
Niveau Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT. "Basic"
« Gratuit »
« Premium »
« Standard »