Workspaces - Create Or Update
Crée un espace de travail.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}?api-version=2026-01-01
Paramètres d’URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
workspace
|
path | True |
string minLength: 3maxLength: 64 |
Nom de l’espace de travail. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Corps de la requête
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| location | True |
string |
Emplacement géographique où réside la ressource |
| properties.computeMode | True |
Mode de calcul de l’espace de travail. Obligatoire lors de la création, ne peut pas être modifié. Les valeurs possibles sont les suivantes : 'Serverless', 'Hybrid' |
|
| properties.accessConnector |
Connecteur d’accès Ressource qui va être associée à Databricks Workspace. Non autorisé dans l’espace de travail Serverless ComputeMode. |
||
| properties.authorizations |
Autorisations du fournisseur d’espace de travail. |
||
| properties.createdBy |
Indique l’ID d’objet, PUID et l’ID d’application de l’entité qui a créé l’espace de travail. |
||
| properties.defaultCatalog |
Propriétés de la configuration du catalogue par défaut lors de la création de l’espace de travail. Non autorisé dans l’espace de travail Serverless ComputeMode. |
||
| properties.defaultStorageFirewall |
Obtient ou définit les informations de configuration du pare-feu de stockage par défaut. Non autorisé dans l’espace de travail Serverless ComputeMode. |
||
| properties.encryption |
Propriétés de chiffrement pour l’espace de travail databricks. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode. |
||
| properties.enhancedSecurityCompliance |
Contient les paramètres liés au module complémentaire de sécurité et de conformité améliorés. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode. |
||
| properties.managedDiskIdentity |
Détails de l’identité managée de l’ensemble de chiffrement de disque utilisé pour le chiffrement de disque managé. Renvoyé uniquement dans l’espace de travail Hybrid ComputeMode. |
||
| properties.managedResourceGroupId |
string |
ID du groupe de ressources managé Requis dans l’espace de travail Hybrid ComputeMode. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| properties.parameters |
Paramètres personnalisés de l’espace de travail. |
||
| properties.publicNetworkAccess |
Type d’accès réseau pour accéder à l’espace de travail. Définissez la valeur sur désactivée pour accéder à l’espace de travail uniquement via une liaison privée. Utilisé pour configurer un lien privé uniquement front-end pour un espace de travail ComputeMode sans serveur. |
||
| properties.requiredNsgRules |
Obtient ou définit une valeur indiquant si le plan de données (clusters) pour contrôler la communication du plan se produit sur un point de terminaison privé. Les valeurs prises en charge sont « AllRules » et « NoAzureDatabricksRules ». La valeur « NoAzureServiceRules » est uniquement utilisée en interne. Non autorisé dans l’espace de travail Serverless ComputeMode. |
||
| properties.storageAccountIdentity |
Les détails de l’identité managée du compte de stockage. Renvoyé uniquement dans l’espace de travail Hybrid ComputeMode. |
||
| properties.uiDefinitionUri |
string |
URI d’objet blob où se trouve le fichier de définition d’interface utilisateur. |
|
| properties.updatedBy |
Indique l’ID d’objet, PUID et l’ID d’application de l’entité qui ont mis à jour l’espace de travail pour la dernière fois. |
||
| sku |
Référence SKU de la ressource. |
||
| tags |
object |
Balises de ressource. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Créé : renvoie des informations sur l’espace de travail, y compris l’état de l’approvisionnement. |
|
| 201 Created |
Créé : renvoie des informations sur l’espace de travail, y compris l’état de l’approvisionnement. |
|
| Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Couler:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Create a workspace which is ready for Customer-Managed Key (CMK) encryption
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"prepareEncryption": {
"value": true
}
}
},
"location": "westus",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"sku": {
"name": "premium"
},
"location": "East US 2",
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": null,
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net"
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z"
}
}
Create a workspace with Customer-Managed Key (CMK) encryption for Managed Disks
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
}
},
"location": "westus",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update a workspace with Enhanced Security & Compliance Add-On
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"enhancedSecurityCompliance": {
"automaticClusterUpdate": {
"value": "Enabled"
},
"complianceSecurityProfile": {
"value": "Enabled",
"complianceStandards": [
"PCI_DSS",
"HIPAA"
]
},
"enhancedSecurityMonitoring": {
"value": "Enabled"
}
}
},
"location": "eastus2",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"enhancedSecurityCompliance": {
"automaticClusterUpdate": {
"value": "Enabled"
},
"complianceSecurityProfile": {
"value": "Enabled",
"complianceStandards": [
"PCI_DSS",
"HIPAA"
]
},
"enhancedSecurityMonitoring": {
"value": "Enabled"
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2023-08-24T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"enhancedSecurityCompliance": {
"automaticClusterUpdate": {
"value": "Enabled"
},
"complianceSecurityProfile": {
"value": "Enabled",
"complianceStandards": [
"PCI_DSS",
"HIPAA"
]
},
"enhancedSecurityMonitoring": {
"value": "Enabled"
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2023-08-24T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update serverless workspace
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Serverless"
},
"location": "westus",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Serverless",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"defaultCatalog": {
"initialType": "UnityCatalog",
"initialName": ""
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Serverless",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update workspace
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"defaultCatalog": {
"initialType": "UnityCatalog",
"initialName": ""
},
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "SystemAssigned"
},
"defaultStorageFirewall": "Enabled"
},
"location": "westus",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "SystemAssigned"
},
"defaultStorageFirewall": "Enabled",
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"defaultCatalog": {
"initialType": "UnityCatalog",
"initialName": ""
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": null,
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "SystemAssigned"
},
"defaultStorageFirewall": "Enabled",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update workspace with custom parameters
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"defaultCatalog": {
"initialType": "HiveMetastore",
"initialName": ""
},
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "UserAssigned",
"userAssignedIdentityId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"
},
"defaultStorageFirewall": "Enabled",
"parameters": {
"customVirtualNetworkId": {
"value": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myNetwork"
},
"customPublicSubnetName": {
"value": "myPublicSubnet"
},
"customPrivateSubnetName": {
"value": "myPrivateSubnet"
}
}
},
"location": "westus",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"customPrivateSubnetName": {
"type": "String",
"value": "myPrivateSubnet"
},
"customPublicSubnetName": {
"type": "String",
"value": "myPublicSubnet"
},
"customVirtualNetworkId": {
"type": "String",
"value": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myNetwork"
}
},
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "UserAssigned",
"userAssignedIdentityId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"
},
"defaultStorageFirewall": "Enabled",
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"defaultCatalog": {
"initialType": "HiveMetastore",
"initialName": ""
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true,
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "UserAssigned",
"userAssignedIdentityId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"
},
"defaultStorageFirewall": "Enabled",
"defaultCatalog": {
"initialType": "HiveMetastore",
"initialName": ""
}
}
}
Enable Customer-Managed Key (CMK) encryption on a workspace which is prepared for encryption
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"prepareEncryption": {
"value": true
},
"encryption": {
"value": {
"keySource": "Microsoft.Keyvault",
"keyvaulturi": "https://myKeyVault.vault.azure.net/",
"KeyName": "myKeyName",
"keyversion": "00000000000000000000000000000000"
}
}
}
},
"location": "westus",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"sku": {
"name": "premium"
},
"location": "East US 2",
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"customPrivateSubnetName": {
"type": "String",
"value": "PrivateBob"
},
"customPublicSubnetName": {
"type": "String",
"value": "PublicSarah"
},
"customVirtualNetworkId": {
"type": "String",
"value": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myNetwork"
},
"prepareEncryption": {
"type": "Bool",
"value": true
},
"encryption": {
"type": "Object",
"value": {
"keySource": "Microsoft.Keyvault",
"keyvaulturi": "https://myKeyVault.vault.azure.net/",
"KeyName": "myKeyName",
"keyversion": "00000000000000000000000000000000"
}
}
},
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"isUcEnabled": true
}
}
Revert Customer-Managed Key (CMK) encryption to Microsoft Managed Keys encryption on a workspace
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"encryption": {
"value": {
"keySource": "Default"
}
}
}
},
"location": "westus",
"sku": {
"name": "premium"
}
}
Exemple de réponse
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"sku": {
"name": "premium"
},
"location": "East US 2",
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"customPrivateSubnetName": {
"type": "String",
"value": "PrivateBob"
},
"customPublicSubnetName": {
"type": "String",
"value": "PublicSarah"
},
"customVirtualNetworkId": {
"type": "String",
"value": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myNetwork"
},
"prepareEncryption": {
"type": "Bool",
"value": true
},
"encryption": {
"type": "Object",
"value": {
"keySource": "Default"
}
}
},
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"isUcEnabled": true
}
}
Update a workspace with Customer-Managed Key (CMK) encryption for Managed Disks
Demande d’échantillon
PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2026-01-01
{
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
}
},
"location": "westus",
"sku": {
"name": "premium"
},
"tags": {
"mytag1": "myvalue1"
}
}
Exemple de réponse
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"mytag1": "myvalue1"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "6666666666666666",
"workspaceUrl": "adb-6666666666666666.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"mytag1": "myvalue1"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "6666666666666666",
"workspaceUrl": "adb-6666666666666666.19.azuredatabricks.net",
"isUcEnabled": true
}
}
Définitions
| Nom | Description |
|---|---|
|
Access |
Connecteur d’accès Ressource qui va être associée à Databricks Workspace. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
Automatic |
État de la fonctionnalité de mise à jour de cluster automatisée. |
|
Automatic |
|
|
Compliance |
État de la fonctionnalité Profil de sécurité de conformité. |
|
Compliance |
|
|
Compute |
Mode de calcul de l’espace de travail. Obligatoire lors de la création, ne peut pas être modifié. Les valeurs possibles sont les suivantes : 'Serverless', 'Hybrid' |
|
Created |
Fournit des détails sur l’entité qui a créé/mis à jour l’espace de travail. |
|
created |
Type d’identité qui a créé la ressource. |
|
Custom |
Le type de variable dont il s’agit |
|
Default |
Ces propriétés permettent à l’utilisateur de spécifier les propriétés de catalogue par défaut lors de la création de l’espace de travail. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
default |
Obtient ou définit les informations de configuration du pare-feu de stockage par défaut. Non autorisé dans l’espace de travail Serverless ComputeMode. |
| Encryption |
Objet contenant les détails du chiffrement utilisé dans l’espace de travail. |
|
Encryption |
Entités de chiffrement pour la ressource d’espace de travail databricks. |
|
Encryption |
KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Microsoft.Keyvault |
| EncryptionV2 |
Objet contenant les détails du chiffrement utilisé dans l’espace de travail. |
|
Enhanced |
État des paramètres liés au module complémentaire Sécurité et conformité renforcées. |
|
Enhanced |
État de la fonctionnalité de surveillance de la sécurité améliorée. |
|
Enhanced |
|
|
Error |
Détails de l’erreur. |
|
Error |
Le code et le message d’erreur. |
|
Error |
Réponse d’erreur. |
|
Identity |
Type d’identité de la ressource Access Connector. |
|
initial |
Définit le type initial du catalogue par défaut. Valeurs possibles (sans respect de la casse) : HiveMetastore, UnityCatalog |
|
Key |
KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Par défaut, Microsoft.Keyvault |
|
Key |
Propriétés d’entrée Key Vault pour le chiffrement. |
|
Managed |
Objet contenant les détails du chiffrement utilisé dans l’espace de travail. |
|
Managed |
Détails de l’identité managée pour le compte de stockage. |
|
Private |
Propriété de point de terminaison privé d’une connexion de point de terminaison privé. |
|
Private |
Connexion de point de terminaison privé d’un espace de travail. |
|
Private |
Propriétés d’une connexion de point de terminaison privé. |
|
Private |
État d’approvisionnement actuel. |
|
Private |
État actuel d’une connexion de point de terminaison privé. |
|
Private |
État d’une connexion de point de terminaison privé |
|
Provisioning |
État de provisionnement de l’espace de travail. |
|
Public |
Type d’accès réseau pour accéder à l’espace de travail. Définissez la valeur sur désactivée pour accéder à l’espace de travail uniquement via une liaison privée. Utilisé pour configurer un lien privé uniquement front-end pour un espace de travail ComputeMode sans serveur. |
|
Required |
Obtient ou définit une valeur indiquant si le plan de données (clusters) pour contrôler la communication du plan se produit sur un point de terminaison privé. Les valeurs prises en charge sont « AllRules » et « NoAzureDatabricksRules ». La valeur « NoAzureServiceRules » est uniquement utilisée en interne. Non autorisé dans l’espace de travail Serverless ComputeMode. |
| Sku |
Référence SKU pour la ressource. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
| Workspace |
Informations sur l’espace de travail. |
|
Workspace. |
Propriétés de chiffrement pour l’espace de travail databricks. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode. |
|
Workspace |
Valeur qui doit être utilisée pour ce champ. |
|
Workspace |
Valeur qui doit être utilisée pour ce champ. |
|
Workspace |
Paramètres personnalisés utilisés pour la création d’espaces de travail. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
Workspace |
La valeur. |
|
Workspace |
Objet contenant les détails du chiffrement utilisé dans l’espace de travail. |
|
Workspace |
Valeur qui doit être utilisée pour ce champ. |
|
Workspace |
Propriétés de chiffrement pour l’espace de travail databricks. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode. |
|
Workspace |
L’autorisation du fournisseur d’espace de travail. |
AccessConnector
Connecteur d’accès Ressource qui va être associée à Databricks Workspace. Non autorisé dans l’espace de travail Serverless ComputeMode.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource de la ressource du connecteur d’accès Azure Databricks. |
| identityType |
Type d’identité de la ressource Access Connector. |
|
| userAssignedIdentityId |
string (arm-id) |
ID de ressource de l’identité affectée par l’utilisateur associée à la ressource Access Connector. Cela est requis pour le type « UserAssigned » et non valide pour le type « SystemAssigned ». |
AutomaticClusterUpdateDefinition
État de la fonctionnalité de mise à jour de cluster automatisée.
| Nom | Type | Description |
|---|---|---|
| value |
AutomaticClusterUpdateValue
| Valeur | Description |
|---|---|
| Enabled | |
| Disabled |
ComplianceSecurityProfileDefinition
État de la fonctionnalité Profil de sécurité de conformité.
| Nom | Type | Description |
|---|---|---|
| complianceStandards |
string[] |
Normes de conformité associées à l’espace de travail. |
| value |
ComplianceSecurityProfileValue
| Valeur | Description |
|---|---|
| Enabled | |
| Disabled |
ComputeMode
Mode de calcul de l’espace de travail. Obligatoire lors de la création, ne peut pas être modifié. Les valeurs possibles sont les suivantes : 'Serverless', 'Hybrid'
| Valeur | Description |
|---|---|
| Serverless | |
| Hybrid |
CreatedBy
Fournit des détails sur l’entité qui a créé/mis à jour l’espace de travail.
| Nom | Type | Description |
|---|---|---|
| applicationId |
string (uuid) |
ID d’application de l’application qui a lancé la création de l’espace de travail. Par exemple, le portail Azure. |
| oid |
string (uuid) |
ID d’objet qui a créé l’espace de travail. |
| puid |
string |
L’ID d’objet personnel correspondant à l’ID d’objet ci-dessus |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CustomParameterType
Le type de variable dont il s’agit
| Valeur | Description |
|---|---|
| Bool | |
| Object | |
| String |
DefaultCatalogProperties
Ces propriétés permettent à l’utilisateur de spécifier les propriétés de catalogue par défaut lors de la création de l’espace de travail. Non autorisé dans l’espace de travail Serverless ComputeMode.
| Nom | Type | Valeur par défaut | Description |
|---|---|---|---|
| initialName |
string |
Spécifie le nom initial du catalogue par défaut. S’il n’est pas spécifié, le nom de l’espace de travail sera utilisé. |
|
| initialType | HiveMetastore |
Définit le type initial du catalogue par défaut. Valeurs possibles (sans respect de la casse) : HiveMetastore, UnityCatalog |
defaultStorageFirewall
Obtient ou définit les informations de configuration du pare-feu de stockage par défaut. Non autorisé dans l’espace de travail Serverless ComputeMode.
| Valeur | Description |
|---|---|
| Disabled | |
| Enabled |
Encryption
Objet contenant les détails du chiffrement utilisé dans l’espace de travail.
| Nom | Type | Valeur par défaut | Description |
|---|---|---|---|
| KeyName |
string |
Nom de la clé KeyVault. |
|
| keySource | Default |
KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Par défaut, Microsoft.Keyvault |
|
| keyvaulturi |
string |
URI de KeyVault. |
|
| keyversion |
string |
Version de la clé KeyVault. |
EncryptionEntitiesDefinition
Entités de chiffrement pour la ressource d’espace de travail databricks.
| Nom | Type | Description |
|---|---|---|
| managedDisk |
Propriétés de chiffrement pour les disques managés databricks. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| managedServices |
Propriétés de chiffrement pour les services managés databricks. Pris en charge dans les modes de calcul sans serveur et hybride. |
EncryptionKeySource
KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Microsoft.Keyvault
| Valeur | Description |
|---|---|
| Microsoft.Keyvault |
EncryptionV2
Objet contenant les détails du chiffrement utilisé dans l’espace de travail.
| Nom | Type | Description |
|---|---|---|
| keySource |
KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Microsoft.Keyvault |
|
| keyVaultProperties |
Propriétés d’entrée Key Vault pour le chiffrement. |
EnhancedSecurityComplianceDefinition
État des paramètres liés au module complémentaire Sécurité et conformité renforcées.
| Nom | Type | Description |
|---|---|---|
| automaticClusterUpdate |
État de la fonctionnalité de mise à jour de cluster automatisée. |
|
| complianceSecurityProfile |
État de la fonctionnalité Profil de sécurité de conformité. |
|
| enhancedSecurityMonitoring |
État de la fonctionnalité de surveillance de la sécurité améliorée. |
EnhancedSecurityMonitoringDefinition
État de la fonctionnalité de surveillance de la sécurité améliorée.
| Nom | Type | Description |
|---|---|---|
| value |
EnhancedSecurityMonitoringValue
| Valeur | Description |
|---|---|
| Enabled | |
| Disabled |
ErrorDetail
Détails de l’erreur.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Le code de l’erreur. |
| message |
string |
Un message d’erreur lisible par l’homme. |
| target |
string |
Indique quelle propriété de la demande est responsable de l’erreur. |
ErrorInfo
Le code et le message d’erreur.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Code d’erreur lisible par machine. |
| details |
Détails de l’erreur. |
|
| innererror |
string |
Détails de l’erreur interne s’ils existent. |
| message |
string |
Un message d’erreur lisible par l’homme. |
ErrorResponse
Réponse d’erreur.
| Nom | Type | Description |
|---|---|---|
| error |
Le code et le message d’erreur. |
IdentityType
Type d’identité de la ressource Access Connector.
| Valeur | Description |
|---|---|
| SystemAssigned | |
| UserAssigned |
initialType
Définit le type initial du catalogue par défaut. Valeurs possibles (sans respect de la casse) : HiveMetastore, UnityCatalog
| Valeur | Description |
|---|---|
| HiveMetastore | |
| UnityCatalog |
KeySource
KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Par défaut, Microsoft.Keyvault
| Valeur | Description |
|---|---|
| Default | |
| Microsoft.Keyvault |
KeyVaultProperties
Propriétés d’entrée Key Vault pour le chiffrement.
| Nom | Type | Description |
|---|---|---|
| keyName |
string |
Nom de la clé KeyVault. |
| keyVaultUri |
string |
URI de KeyVault. |
| keyVersion |
string |
Version de la clé KeyVault. |
ManagedDiskEncryption
Objet contenant les détails du chiffrement utilisé dans l’espace de travail.
| Nom | Type | Description |
|---|---|---|
| keySource |
KeySource de chiffrement (fournisseur). Valeurs possibles (insensibles à la casse) : Microsoft.Keyvault. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| keyVaultProperties |
Propriétés d’entrée Key Vault pour le chiffrement. |
|
| rotationToLatestKeyVersionEnabled |
boolean |
Indiquez si la dernière version de la clé doit être utilisée automatiquement pour Managed Disk Encryption. |
ManagedIdentityConfiguration
Détails de l’identité managée pour le compte de stockage.
| Nom | Type | Description |
|---|---|---|
| principalId |
string (uuid) |
objectId de l’identité managée liée au compte de stockage managé. |
| tenantId |
string (uuid) |
ID de locataire dans lequel l’identité managée est créée. |
| type |
string |
Type d’identité créé. Il peut s’agir de SystemAssigned ou de UserAssigned. |
PrivateEndpoint
Propriété de point de terminaison privé d’une connexion de point de terminaison privé.
| Nom | Type | Description |
|---|---|---|
| id |
string |
Identificateur de ressource. |
PrivateEndpointConnection
Connexion de point de terminaison privé d’un espace de travail.
| Nom | Type | Description |
|---|---|---|
| id |
string |
Identificateur de ressource. |
| name |
string |
Nom de la ressource. |
| properties |
Propriétés de connexion de point de terminaison privé. |
|
| type |
string |
Type de ressource. |
PrivateEndpointConnectionProperties
Propriétés d’une connexion de point de terminaison privé.
| Nom | Type | Description |
|---|---|---|
| groupIds |
string[] |
GroupIds de la ressource de service private link. |
| privateEndpoint |
Point de terminaison privé |
|
| privateLinkServiceConnectionState |
État de la connexion du service de liaison privée |
|
| provisioningState |
État d’approvisionnement de la connexion de point de terminaison privé. |
PrivateEndpointConnectionProvisioningState
État d’approvisionnement actuel.
| Valeur | Description |
|---|---|
| Succeeded | |
| Creating | |
| Updating | |
| Deleting | |
| Failed |
PrivateLinkServiceConnectionState
État actuel d’une connexion de point de terminaison privé.
| Nom | Type | Description |
|---|---|---|
| actionsRequired |
string |
Actions requises pour une connexion de point de terminaison privé |
| description |
string |
Description de l’état actuel d’une connexion de point de terminaison privé |
| status |
État d’une connexion de point de terminaison privé |
PrivateLinkServiceConnectionStatus
État d’une connexion de point de terminaison privé
| Valeur | Description |
|---|---|
| Pending | |
| Approved | |
| Rejected | |
| Disconnected |
ProvisioningState
État de provisionnement de l’espace de travail.
| Valeur | Description |
|---|---|
| Accepted | |
| Running | |
| Ready | |
| Creating | |
| Created | |
| Deleting | |
| Deleted | |
| Canceled | |
| Failed | |
| Succeeded | |
| Updating |
PublicNetworkAccess
Type d’accès réseau pour accéder à l’espace de travail. Définissez la valeur sur désactivée pour accéder à l’espace de travail uniquement via une liaison privée. Utilisé pour configurer un lien privé uniquement front-end pour un espace de travail ComputeMode sans serveur.
| Valeur | Description |
|---|---|
| Enabled | |
| Disabled |
RequiredNsgRules
Obtient ou définit une valeur indiquant si le plan de données (clusters) pour contrôler la communication du plan se produit sur un point de terminaison privé. Les valeurs prises en charge sont « AllRules » et « NoAzureDatabricksRules ». La valeur « NoAzureServiceRules » est uniquement utilisée en interne. Non autorisé dans l’espace de travail Serverless ComputeMode.
| Valeur | Description |
|---|---|
| AllRules | |
| NoAzureDatabricksRules | |
| NoAzureServiceRules |
Sku
Référence SKU pour la ressource.
| Nom | Type | Description |
|---|---|---|
| name |
string |
Nom de la référence SKU. |
| tier |
string |
Niveau de référence SKU. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |
Workspace
Informations sur l’espace de travail.
| Nom | Type | Description |
|---|---|---|
| id |
string |
ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Emplacement géographique où réside la ressource |
| name |
string |
Nom de la ressource |
| properties.accessConnector |
Connecteur d’accès Ressource qui va être associée à Databricks Workspace. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| properties.authorizations |
Autorisations du fournisseur d’espace de travail. |
|
| properties.computeMode |
Mode de calcul de l’espace de travail. Obligatoire lors de la création, ne peut pas être modifié. Les valeurs possibles sont les suivantes : 'Serverless', 'Hybrid' |
|
| properties.createdBy |
Indique l’ID d’objet, PUID et l’ID d’application de l’entité qui a créé l’espace de travail. |
|
| properties.createdDateTime |
string (date-time) |
Spécifie la date et l’heure de création de l’espace de travail. |
| properties.defaultCatalog |
Propriétés de la configuration du catalogue par défaut lors de la création de l’espace de travail. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| properties.defaultStorageFirewall |
Obtient ou définit les informations de configuration du pare-feu de stockage par défaut. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| properties.diskEncryptionSetId |
string |
ID de ressource du jeu de chiffrement de disque managé. Non autorisé dans l’espace de travail Serverless ComputeMode. |
| properties.encryption |
Propriétés de chiffrement pour l’espace de travail databricks. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode. |
|
| properties.enhancedSecurityCompliance |
Contient les paramètres liés au module complémentaire de sécurité et de conformité améliorés. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode. |
|
| properties.isUcEnabled |
boolean |
Indique si le catalogue Unity est activé ou non pour l’espace de travail. Défini sur true dans l’espace de travail Serverless ComputeMode. |
| properties.managedDiskIdentity |
Détails de l’identité managée de l’ensemble de chiffrement de disque utilisé pour le chiffrement de disque managé. Renvoyé uniquement dans l’espace de travail Hybrid ComputeMode. |
|
| properties.managedResourceGroupId |
string |
ID du groupe de ressources managé Requis dans l’espace de travail Hybrid ComputeMode. Non autorisé dans l’espace de travail Serverless ComputeMode. |
| properties.parameters |
Paramètres personnalisés de l’espace de travail. |
|
| properties.privateEndpointConnections |
Connexions de point de terminaison privées créées sur l’espace de travail. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode. |
|
| properties.provisioningState |
État de provisionnement de l’espace de travail. |
|
| properties.publicNetworkAccess |
Type d’accès réseau pour accéder à l’espace de travail. Définissez la valeur sur désactivée pour accéder à l’espace de travail uniquement via une liaison privée. Utilisé pour configurer un lien privé uniquement front-end pour un espace de travail ComputeMode sans serveur. |
|
| properties.requiredNsgRules |
Obtient ou définit une valeur indiquant si le plan de données (clusters) pour contrôler la communication du plan se produit sur un point de terminaison privé. Les valeurs prises en charge sont « AllRules » et « NoAzureDatabricksRules ». La valeur « NoAzureServiceRules » est uniquement utilisée en interne. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| properties.storageAccountIdentity |
Les détails de l’identité managée du compte de stockage. Renvoyé uniquement dans l’espace de travail Hybrid ComputeMode. |
|
| properties.uiDefinitionUri |
string |
URI d’objet blob où se trouve le fichier de définition d’interface utilisateur. |
| properties.updatedBy |
Indique l’ID d’objet, PUID et l’ID d’application de l’entité qui ont mis à jour l’espace de travail pour la dernière fois. |
|
| properties.workspaceId |
string |
Identificateur unique de l’espace de travail databricks dans le plan de contrôle databricks. |
| properties.workspaceUrl |
string |
L’URL de l’espace de travail, au format 'adb-{workspaceId}. {aléatoire}.azuredatabricks.net' |
| sku |
Référence SKU de la ressource. |
|
| systemData |
Les métadonnées système relatives à cette ressource |
|
| tags |
object |
Balises de ressource. |
| type |
string |
Type de la ressource. Ex. Microsoft.Compute/virtualMachines ou Microsoft.Storage/storageAccounts. |
Workspace.WorkspaceProperties.Encryption
Propriétés de chiffrement pour l’espace de travail databricks. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode.
| Nom | Type | Description |
|---|---|---|
| entities |
Définition des entités de chiffrement pour l’espace de travail. |
WorkspaceCustomBooleanParameter
Valeur qui doit être utilisée pour ce champ.
| Nom | Type | Description |
|---|---|---|
| type |
Le type de variable dont il s’agit |
|
| value |
boolean |
Valeur qui doit être utilisée pour ce champ. |
WorkspaceCustomObjectParameter
Valeur qui doit être utilisée pour ce champ.
| Nom | Type | Description |
|---|---|---|
| type |
Le type de variable dont il s’agit |
|
| value |
object |
Valeur qui doit être utilisée pour ce champ. |
WorkspaceCustomParameters
Paramètres personnalisés utilisés pour la création d’espaces de travail. Non autorisé dans l’espace de travail Serverless ComputeMode.
| Nom | Type | Description |
|---|---|---|
| amlWorkspaceId |
ID d’un espace de travail Azure Machine Learning à lier à l’espace de travail Databricks. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| customPrivateSubnetName |
Nom du sous-réseau privé au sein du réseau virtuel. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| customPublicSubnetName |
Nom d’un sous-réseau public au sein du réseau virtuel. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| customVirtualNetworkId |
ID d’un réseau virtuel sur lequel ce cluster Databricks doit être créé. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| enableNoPublicIp |
Boolean indiquant si l’adresse IP publique doit être désactivée. La valeur par défaut est true. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| encryption |
Contient les détails de chiffrement de l’espace de travail activé pour la clé Customer-Managed (CMK). Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| loadBalancerBackendPoolName |
Nom du pool principal d’équilibreur de charge sortant pour la connectivité sécurisée du cluster (aucune adresse IP publique). Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| loadBalancerId |
URI de ressource de l’équilibreur de charge sortant pour l’espace de travail Connectivité de cluster sécurisé (aucune adresse IP publique). Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| natGatewayName |
Nom de la passerelle NAT pour les sous-réseaux d’espace de travail De connectivité de cluster sécurisé (aucune adresse IP publique). Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| prepareEncryption |
Préparez l’espace de travail pour le chiffrement. Active l’identité managée pour le compte de stockage managé. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| publicIpName |
Nom de l’adresse IP publique pour aucun espace de travail IP publique avec réseau virtuel managé. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| requireInfrastructureEncryption |
Valeur booléenne indiquant si le système de fichiers racine DBFS sera activé avec la couche secondaire de chiffrement avec des clés gérées par la plateforme pour les données au repos. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| resourceTags |
Balises appliquées aux ressources sous Groupe de ressources géré. Celles-ci peuvent être mises à jour en mettant à jour les balises au niveau de l’espace de travail. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| storageAccountName |
Nom du compte de stockage DBFS par défaut. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| storageAccountSkuName |
Nom de la référence SKU du compte de stockage, par exemple : Standard_GRS, Standard_LRS. Reportez-vous https://aka.ms/storageskus aux entrées valides. Non autorisé dans l’espace de travail Serverless ComputeMode. |
|
| vnetAddressPrefix |
Préfixe d’adresse pour le réseau virtuel managé. La valeur par défaut de cette entrée est 10.139. Non autorisé dans l’espace de travail Serverless ComputeMode. |
WorkspaceCustomStringParameter
La valeur.
| Nom | Type | Description |
|---|---|---|
| type |
Le type de variable dont il s’agit |
|
| value |
string |
Valeur qui doit être utilisée pour ce champ. |
WorkspaceEncryptionParameter
Objet contenant les détails du chiffrement utilisé dans l’espace de travail.
| Nom | Type | Description |
|---|---|---|
| type |
Le type de variable dont il s’agit |
|
| value |
Valeur qui doit être utilisée pour ce champ. |
WorkspaceNoPublicIPBooleanParameter
Valeur qui doit être utilisée pour ce champ.
| Nom | Type | Description |
|---|---|---|
| type |
Le type de variable dont il s’agit |
|
| value |
boolean |
Valeur qui doit être utilisée pour ce champ. |
WorkspaceProperties.Encryption
Propriétés de chiffrement pour l’espace de travail databricks. Pris en charge dans l’espace de travail Serverless et Hybrid ComputeMode.
| Nom | Type | Description |
|---|---|---|
| entities |
Définition des entités de chiffrement pour l’espace de travail. |
WorkspaceProviderAuthorization
L’autorisation du fournisseur d’espace de travail.
| Nom | Type | Description |
|---|---|---|
| principalId |
string (uuid) |
Identificateur principal du fournisseur. Il s’agit de l’identité que le fournisseur utilisera pour appeler ARM pour gérer les ressources de l’espace de travail. |
| roleDefinitionId |
string (uuid) |
Identificateur de définition de rôle du fournisseur. Ce rôle définit toutes les autorisations dont le fournisseur doit disposer sur le groupe de ressources conteneur de l’espace de travail. Cette définition de rôle ne peut pas avoir l’autorisation de supprimer le groupe de ressources. |