Partager via


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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

workspaceName
path True

string

minLength: 3
maxLength: 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

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.accessConnector

AccessConnector

Connecteur d’accès Ressource qui va être associée à Databricks Workspace. Non autorisé dans l’espace de travail Serverless ComputeMode.

properties.authorizations

WorkspaceProviderAuthorization[]

Autorisations du fournisseur d’espace de travail.

properties.createdBy

CreatedBy

Indique l’ID d’objet, PUID et l’ID d’application de l’entité qui a créé l’espace de travail.

properties.defaultCatalog

DefaultCatalogProperties

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

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

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.

properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

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

ManagedIdentityConfiguration

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

WorkspaceCustomParameters

Paramètres personnalisés de l’espace de travail.

properties.publicNetworkAccess

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

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

ManagedIdentityConfiguration

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

CreatedBy

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

Sku

Référence SKU de la ressource.

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

Workspace

Créé : renvoie des informations sur l’espace de travail, y compris l’état de l’approvisionnement.

201 Created

Workspace

Créé : renvoie des informations sur l’espace de travail, y compris l’état de l’approvisionnement.

Other Status Codes

ErrorResponse

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
Create a workspace with Customer-Managed Key (CMK) encryption for Managed Disks
Create or update a workspace with Enhanced Security & Compliance Add-On
Create or update serverless workspace
Create or update workspace
Create or update workspace with custom parameters
Enable Customer-Managed Key (CMK) encryption on a workspace which is prepared for encryption
Revert Customer-Managed Key (CMK) encryption to Microsoft Managed Keys encryption on a workspace
Update a workspace with Customer-Managed Key (CMK) encryption for Managed Disks

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
AccessConnector

Connecteur d’accès Ressource qui va être associée à Databricks Workspace. Non autorisé dans l’espace de travail Serverless ComputeMode.

AutomaticClusterUpdateDefinition

État de la fonctionnalité de mise à jour de cluster automatisée.

AutomaticClusterUpdateValue
ComplianceSecurityProfileDefinition

État de la fonctionnalité Profil de sécurité de conformité.

ComplianceSecurityProfileValue
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'

CreatedBy

Fournit des détails sur l’entité qui a créé/mis à jour l’espace de travail.

createdByType

Type d’identité qui a créé la ressource.

CustomParameterType

Le type de variable dont il s’agit

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.

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.

Encryption

Objet contenant les détails du chiffrement utilisé dans l’espace de travail.

EncryptionEntitiesDefinition

Entités de chiffrement pour la ressource d’espace de travail databricks.

EncryptionKeySource

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.

EnhancedSecurityComplianceDefinition

État des paramètres liés au module complémentaire Sécurité et conformité renforcées.

EnhancedSecurityMonitoringDefinition

État de la fonctionnalité de surveillance de la sécurité améliorée.

EnhancedSecurityMonitoringValue
ErrorDetail

Détails de l’erreur.

ErrorInfo

Le code et le message d’erreur.

ErrorResponse

Réponse d’erreur.

IdentityType

Type d’identité de la ressource Access Connector.

initialType

Définit le type initial du catalogue par défaut. Valeurs possibles (sans respect de la casse) : HiveMetastore, UnityCatalog

KeySource

KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Par défaut, Microsoft.Keyvault

KeyVaultProperties

Propriétés d’entrée Key Vault pour le chiffrement.

ManagedDiskEncryption

Objet contenant les détails du chiffrement utilisé dans l’espace de travail.

ManagedIdentityConfiguration

Détails de l’identité managée pour le compte de stockage.

PrivateEndpoint

Propriété de point de terminaison privé d’une connexion de point de terminaison privé.

PrivateEndpointConnection

Connexion de point de terminaison privé d’un espace de travail.

PrivateEndpointConnectionProperties

Propriétés d’une connexion de point de terminaison privé.

PrivateEndpointConnectionProvisioningState

État d’approvisionnement actuel.

PrivateLinkServiceConnectionState

État actuel d’une connexion de point de terminaison privé.

PrivateLinkServiceConnectionStatus

État d’une connexion de point de terminaison privé

ProvisioningState

État de provisionnement de l’espace de travail.

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.

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.

Sku

Référence SKU pour la ressource.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Workspace

Informations sur l’espace de travail.

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.

WorkspaceCustomBooleanParameter

Valeur qui doit être utilisée pour ce champ.

WorkspaceCustomObjectParameter

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.

WorkspaceCustomStringParameter

La valeur.

WorkspaceEncryptionParameter

Objet contenant les détails du chiffrement utilisé dans l’espace de travail.

WorkspaceNoPublicIPBooleanParameter

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.

WorkspaceProviderAuthorization

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

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

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

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

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

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

ManagedDiskEncryption

Propriétés de chiffrement pour les disques managés databricks. Non autorisé dans l’espace de travail Serverless ComputeMode.

managedServices

EncryptionV2

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

EncryptionKeySource

KeySource de chiffrement (fournisseur). Valeurs possibles (sans respect de la casse) : Microsoft.Keyvault

keyVaultProperties

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

AutomaticClusterUpdateDefinition

État de la fonctionnalité de mise à jour de cluster automatisée.

complianceSecurityProfile

ComplianceSecurityProfileDefinition

État de la fonctionnalité Profil de sécurité de conformité.

enhancedSecurityMonitoring

EnhancedSecurityMonitoringDefinition

É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

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

ErrorDetail[]

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

ErrorInfo

Le code et le message d’erreur.
Détails de l’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

EncryptionKeySource

KeySource de chiffrement (fournisseur). Valeurs possibles (insensibles à la casse) : Microsoft.Keyvault. Non autorisé dans l’espace de travail Serverless ComputeMode.

keyVaultProperties

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

PrivateEndpointConnectionProperties

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

PrivateEndpoint

Point de terminaison privé
Point de terminaison privé

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

État de la connexion du service de liaison privée
État de connexion de point de terminaison privé

provisioningState

PrivateEndpointConnectionProvisioningState

É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

PrivateLinkServiceConnectionStatus

É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

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

createdByType

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

AccessConnector

Connecteur d’accès Ressource qui va être associée à Databricks Workspace. Non autorisé dans l’espace de travail Serverless ComputeMode.

properties.authorizations

WorkspaceProviderAuthorization[]

Autorisations du fournisseur d’espace de travail.

properties.computeMode

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

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

DefaultCatalogProperties

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

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

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.

properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

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

ManagedIdentityConfiguration

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

WorkspaceCustomParameters

Paramètres personnalisés de l’espace de travail.

properties.privateEndpointConnections

PrivateEndpointConnection[]

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

ProvisioningState

État de provisionnement de l’espace de travail.

properties.publicNetworkAccess

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

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

ManagedIdentityConfiguration

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

CreatedBy

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

Sku

Référence SKU de la ressource.

systemData

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

EncryptionEntitiesDefinition

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

CustomParameterType

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

CustomParameterType

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

WorkspaceCustomStringParameter

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

WorkspaceCustomStringParameter

Nom du sous-réseau privé au sein du réseau virtuel. Non autorisé dans l’espace de travail Serverless ComputeMode.

customPublicSubnetName

WorkspaceCustomStringParameter

Nom d’un sous-réseau public au sein du réseau virtuel. Non autorisé dans l’espace de travail Serverless ComputeMode.

customVirtualNetworkId

WorkspaceCustomStringParameter

ID d’un réseau virtuel sur lequel ce cluster Databricks doit être créé. Non autorisé dans l’espace de travail Serverless ComputeMode.

enableNoPublicIp

WorkspaceNoPublicIPBooleanParameter

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

WorkspaceEncryptionParameter

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

WorkspaceCustomStringParameter

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

WorkspaceCustomStringParameter

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

WorkspaceCustomStringParameter

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

WorkspaceCustomBooleanParameter

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

WorkspaceCustomStringParameter

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

WorkspaceCustomBooleanParameter

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

WorkspaceCustomObjectParameter

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

WorkspaceCustomStringParameter

Nom du compte de stockage DBFS par défaut. Non autorisé dans l’espace de travail Serverless ComputeMode.

storageAccountSkuName

WorkspaceCustomStringParameter

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

WorkspaceCustomStringParameter

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

CustomParameterType

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

CustomParameterType

Le type de variable dont il s’agit

value

Encryption

Valeur qui doit être utilisée pour ce champ.

WorkspaceNoPublicIPBooleanParameter

Valeur qui doit être utilisée pour ce champ.

Nom Type Description
type

CustomParameterType

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

EncryptionEntitiesDefinition

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.