Compartir a través de

Workspaces - Create Or Update

Servicio:
Databricks
Versión de la API:
2026-01-01

Crea una nueva área de trabajo.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}?api-version=2026-01-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId
 path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.
workspaceName
 path True

string

minLength: 3
maxLength: 64

Nombre del área de trabajo.
api-version
 query True

string

minLength: 1

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación geográfica donde reside el recurso
properties.computeMode True

ComputeMode

El modo de proceso del área de trabajo. Obligatorio en la creación, no se puede cambiar. Los valores posibles incluyen: 'Sin servidor', 'Híbrido'
properties.accessConnector

AccessConnector

Recurso de conector de acceso que se va a asociar a Databricks Workspace. No se permite en el área de trabajo Serverless ComputeMode.
properties.authorizations

WorkspaceProviderAuthorization[]

Las autorizaciones del proveedor del área de trabajo.
properties.createdBy

CreatedBy

Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que creó el área de trabajo.
properties.defaultCatalog

DefaultCatalogProperties

Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo. No se permite en el área de trabajo Serverless ComputeMode.
properties.defaultStorageFirewall

defaultStorageFirewall

Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento. No se permite en el área de trabajo Serverless ComputeMode.
properties.encryption

WorkspaceProperties.Encryption

Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.
properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.
properties.managedDiskIdentity

ManagedIdentityConfiguration

Los detalles de la identidad administrada del conjunto de cifrado de disco utilizado para el cifrado de disco administrado. Solo se devuelve en el área de trabajo Hybrid ComputeMode.
properties.managedResourceGroupId

string

Id. de grupo de recursos administrado. Requerido en el área de trabajo Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode.
properties.parameters

WorkspaceCustomParameters

Parámetros personalizados del área de trabajo.
properties.publicNetworkAccess

PublicNetworkAccess

Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link. Se utiliza para configurar un enlace privado solo front-end para el espacio de trabajo Serverless ComputeMode.
properties.requiredNsgRules

RequiredNsgRules

Obtiene o establece un valor que indica si el plano de datos (clústeres) para controlar la comunicación del plano se produce a través del punto de conexión privado. Los valores admitidos son "AllRules" y "NoAzureDatabricksRules". El valor "NoAzureServiceRules" es solo para uso interno. No se permite en el área de trabajo Serverless ComputeMode.
properties.storageAccountIdentity

ManagedIdentityConfiguration

Los detalles de la identidad administrada de la cuenta de almacenamiento. Solo se devuelve en el área de trabajo Hybrid ComputeMode.
properties.uiDefinitionUri

string

Identificador URI del blob donde se encuentra el archivo de definición de la interfaz de usuario.
properties.updatedBy

CreatedBy

Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que actualizaron por última vez el área de trabajo.
sku

Sku

SKU del recurso.
tags

object

Etiquetas de recursos.

Respuestas

Nombre Tipo Description
200 OK

Workspace

Creado: devuelve información sobre el área de trabajo, incluido el estado de aprovisionamiento.
201 Created

Workspace

Creado: devuelve información sobre el área de trabajo, incluido el estado de aprovisionamiento.
Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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"
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
200 
{
  "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
  }
}
status code:
201 
{
  "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
  }
}

Definiciones

Nombre Description
AccessConnector

Recurso de conector de acceso que se va a asociar a Databricks Workspace. No se permite en el área de trabajo Serverless ComputeMode.
AutomaticClusterUpdateDefinition

Estado de la característica de actualizaciones automatizadas del clúster.
AutomaticClusterUpdateValue
ComplianceSecurityProfileDefinition

Estado de la característica Perfil de seguridad de cumplimiento.
ComplianceSecurityProfileValue
ComputeMode

El modo de proceso del área de trabajo. Obligatorio en la creación, no se puede cambiar. Los valores posibles incluyen: 'Sin servidor', 'Híbrido'
CreatedBy

Proporciona detalles de la entidad que creó o actualizó el área de trabajo.
createdByType

Tipo de identidad que creó el recurso.
CustomParameterType

El tipo de variable que es
DefaultCatalogProperties

Estas propiedades permiten al usuario especificar las propiedades predeterminadas del catálogo durante la creación del espacio de trabajo. No se permite en el área de trabajo Serverless ComputeMode.
defaultStorageFirewall

Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento. No se permite en el área de trabajo Serverless ComputeMode.
Encryption

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.
EncryptionEntitiesDefinition

Entidades de cifrado para el recurso del área de trabajo de Databricks.
EncryptionKeySource

KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault
EncryptionV2

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.
EnhancedSecurityComplianceDefinition

Estado de la configuración relacionada con el complemento de seguridad y cumplimiento mejorado.
EnhancedSecurityMonitoringDefinition

Estado de la característica Supervisión de seguridad mejorada.
EnhancedSecurityMonitoringValue
ErrorDetail

Detalles del error.
ErrorInfo

El código y el mensaje de un error.
ErrorResponse

Respuesta de error.
IdentityType

Tipo de identidad del recurso del conector de Access.
initialType

Define el tipo inicial del catálogo predeterminado. Valores posibles (sin distinción entre mayúsculas y minúsculas): HiveMetastore, UnityCatalog
KeySource

KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Predeterminado, Microsoft.Keyvault
KeyVaultProperties

Propiedades de entrada de Key Vault para el cifrado.
ManagedDiskEncryption

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.
ManagedIdentityConfiguration

Los detalles de identidad administrada para la cuenta de almacenamiento.
PrivateEndpoint

La propiedad de punto de conexión privado de una conexión de punto de conexión privada.
PrivateEndpointConnection

La conexión de punto de conexión privado de un área de trabajo.
PrivateEndpointConnectionProperties

Propiedades de una conexión de punto de conexión privado.
PrivateEndpointConnectionProvisioningState

Estado de aprovisionamiento actual.
PrivateLinkServiceConnectionState

El estado actual de una conexión de punto de conexión privado.
PrivateLinkServiceConnectionStatus

Estado de una conexión de punto de conexión privado
ProvisioningState

Estado de aprovisionamiento del espacio de trabajo.
PublicNetworkAccess

Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link. Se utiliza para configurar un enlace privado solo front-end para el espacio de trabajo Serverless ComputeMode.
RequiredNsgRules

Obtiene o establece un valor que indica si el plano de datos (clústeres) para controlar la comunicación del plano se produce a través del punto de conexión privado. Los valores admitidos son "AllRules" y "NoAzureDatabricksRules". El valor "NoAzureServiceRules" es solo para uso interno. No se permite en el área de trabajo Serverless ComputeMode.
Sku

SKU del recurso.
systemData

Metadatos relativos a la creación y última modificación del recurso.
Workspace

Información sobre el espacio de trabajo.
Workspace.WorkspaceProperties.Encryption

Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.
WorkspaceCustomBooleanParameter

Valor que se debe usar para este campo.
WorkspaceCustomObjectParameter

Valor que se debe usar para este campo.
WorkspaceCustomParameters

Parámetros personalizados usados para la creación de espacios de trabajo. No se permite en el área de trabajo Serverless ComputeMode.
WorkspaceCustomStringParameter

El valor.
WorkspaceEncryptionParameter

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.
WorkspaceNoPublicIPBooleanParameter

Valor que se debe usar para este campo.
WorkspaceProperties.Encryption

Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.
WorkspaceProviderAuthorization

La autorización del proveedor del área de trabajo.

AccessConnector

Objeto

Recurso de conector de acceso que se va a asociar a Databricks Workspace. No se permite en el área de trabajo Serverless ComputeMode.

Nombre Tipo Description
id

string (arm-id)

El identificador de recurso del recurso del conector de Azure Databricks Access.
identityType

IdentityType

Tipo de identidad del recurso del conector de Access.
userAssignedIdentityId

string (arm-id)

Identificador de recurso de la identidad asignada por el usuario asociada al recurso del conector de Access. Esto es necesario para el tipo "UserAssigned" y no es válido para el tipo "SystemAssigned".

AutomaticClusterUpdateDefinition

Objeto

Estado de la característica de actualizaciones automatizadas del clúster.

Nombre Tipo Description
value

AutomaticClusterUpdateValue

AutomaticClusterUpdateValue

Enumeración
Valor Description
Enabled
Disabled

ComplianceSecurityProfileDefinition

Objeto

Estado de la característica Perfil de seguridad de cumplimiento.

Nombre Tipo Description
complianceStandards

string[]

Estándares de cumplimiento asociados al área de trabajo.
value

ComplianceSecurityProfileValue

ComplianceSecurityProfileValue

Enumeración
Valor Description
Enabled
Disabled

ComputeMode

Enumeración

El modo de proceso del área de trabajo. Obligatorio en la creación, no se puede cambiar. Los valores posibles incluyen: 'Sin servidor', 'Híbrido'

Valor Description
Serverless
Hybrid

CreatedBy

Objeto

Proporciona detalles de la entidad que creó o actualizó el área de trabajo.

Nombre Tipo Description
applicationId

string (uuid)

El identificador de aplicación de la aplicación que inició la creación del área de trabajo. Por ejemplo, Azure Portal.
oid

string (uuid)

El ID de objeto que creó el espacio de trabajo.
puid

string

El ID de objeto personal correspondiente al ID de objeto anterior

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

CustomParameterType

Enumeración

El tipo de variable que es

Valor Description
Bool
Object
String

DefaultCatalogProperties

Objeto

Estas propiedades permiten al usuario especificar las propiedades predeterminadas del catálogo durante la creación del espacio de trabajo. No se permite en el área de trabajo Serverless ComputeMode.

Nombre Tipo Valor predeterminado Description
initialName

string

Especifica el nombre inicial del catálogo predeterminado. Si no se especifica, se usará el nombre del área de trabajo.
initialType

initialType

HiveMetastore

Define el tipo inicial del catálogo predeterminado. Valores posibles (sin distinción entre mayúsculas y minúsculas): HiveMetastore, UnityCatalog

defaultStorageFirewall

Enumeración

Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento. No se permite en el área de trabajo Serverless ComputeMode.

Valor Description
Disabled
Enabled

Encryption

Objeto

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.

Nombre Tipo Valor predeterminado Description
KeyName

string

Nombre de la clave KeyVault.
keySource

KeySource

Default

KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Predeterminado, Microsoft.Keyvault
keyvaulturi

string

Uri de KeyVault.
keyversion

string

Versión de la clave KeyVault.

EncryptionEntitiesDefinition

Objeto

Entidades de cifrado para el recurso del área de trabajo de Databricks.

Nombre Tipo Description
managedDisk

ManagedDiskEncryption

Propiedades de cifrado de los discos administrados de Databricks. No se permite en el área de trabajo Serverless ComputeMode.
managedServices

EncryptionV2

Propiedades de cifrado para los servicios administrados de Databricks. Compatible con ComputeMode híbrido y sin servidor.

EncryptionKeySource

Enumeración

KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault

Valor Description
Microsoft.Keyvault

EncryptionV2

Objeto

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.

Nombre Tipo Description
keySource

EncryptionKeySource

KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault
keyVaultProperties

KeyVaultProperties

Propiedades de entrada de Key Vault para el cifrado.

EnhancedSecurityComplianceDefinition

Objeto

Estado de la configuración relacionada con el complemento de seguridad y cumplimiento mejorado.

Nombre Tipo Description
automaticClusterUpdate

AutomaticClusterUpdateDefinition

Estado de la característica de actualizaciones automatizadas del clúster.
complianceSecurityProfile

ComplianceSecurityProfileDefinition

Estado de la característica Perfil de seguridad de cumplimiento.
enhancedSecurityMonitoring

EnhancedSecurityMonitoringDefinition

Estado de la característica Supervisión de seguridad mejorada.

EnhancedSecurityMonitoringDefinition

Objeto

Estado de la característica Supervisión de seguridad mejorada.

Nombre Tipo Description
value

EnhancedSecurityMonitoringValue

EnhancedSecurityMonitoringValue

Enumeración
Valor Description
Enabled
Disabled

ErrorDetail

Objeto

Detalles del error.

Nombre Tipo Description
code

string

El código del error.
message

string

Un mensaje de error legible por humanos.
target

string

Indica qué propiedad de la solicitud es responsable del error.

ErrorInfo

Objeto

El código y el mensaje de un error.

Nombre Tipo Description
code

string

Un código de error legible por máquina.
details

ErrorDetail[]

Detalles del error.
innererror

string

Detalles de error interno si existen.
message

string

Un mensaje de error legible por humanos.

ErrorResponse

Objeto

Respuesta de error.

Nombre Tipo Description
error

ErrorInfo

El código y el mensaje de un error.
Detalles del error.

IdentityType

Enumeración

Tipo de identidad del recurso del conector de Access.

Valor Description
SystemAssigned
UserAssigned

initialType

Enumeración

Define el tipo inicial del catálogo predeterminado. Valores posibles (sin distinción entre mayúsculas y minúsculas): HiveMetastore, UnityCatalog

Valor Description
HiveMetastore
UnityCatalog

KeySource

Enumeración

KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Predeterminado, Microsoft.Keyvault

Valor Description
Default
Microsoft.Keyvault

KeyVaultProperties

Objeto

Propiedades de entrada de Key Vault para el cifrado.

Nombre Tipo Description
keyName

string

Nombre de la clave KeyVault.
keyVaultUri

string

Uri de KeyVault.
keyVersion

string

Versión de la clave KeyVault.

ManagedDiskEncryption

Objeto

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.

Nombre Tipo Description
keySource

EncryptionKeySource

KeySource (proveedor) de cifrado. Valores posibles (sin distinción entre mayúsculas y minúsculas): Microsoft.Keyvault. No se permite en el área de trabajo Serverless ComputeMode.
keyVaultProperties

KeyVaultProperties

Propiedades de entrada de Key Vault para el cifrado.
rotationToLatestKeyVersionEnabled

boolean

Indique si la versión de clave más reciente se debe usar automáticamente para Managed Disk Encryption.

ManagedIdentityConfiguration

Objeto

Los detalles de identidad administrada para la cuenta de almacenamiento.

Nombre Tipo Description
principalId

string (uuid)

objectId de la identidad administrada vinculada a la cuenta de almacenamiento administrado.
tenantId

string (uuid)

El identificador de inquilino donde se crea la identidad administrada.
type

string

El tipo de identidad creada. Puede ser SystemAssigned o UserAssigned.

PrivateEndpoint

Objeto

La propiedad de punto de conexión privado de una conexión de punto de conexión privada.

Nombre Tipo Description
id

string

Identificador de recurso.

PrivateEndpointConnection

Objeto

La conexión de punto de conexión privado de un área de trabajo.

Nombre Tipo Description
id

string

Identificador de recurso.
name

string

Nombre del recurso.
properties

PrivateEndpointConnectionProperties

Las propiedades de conexión del punto de conexión privado.
type

string

Tipo de recurso.

PrivateEndpointConnectionProperties

Objeto

Propiedades de una conexión de punto de conexión privado.

Nombre Tipo Description
groupIds

string[]

GroupIds del recurso del servicio private link.
privateEndpoint

PrivateEndpoint

Punto de conexión privado
Punto de conexión privado
privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Estado de conexión del servicio de enlace privado
Estado de conexión del punto de conexión privado
provisioningState

PrivateEndpointConnectionProvisioningState

Estado de aprovisionamiento de la conexión de punto de conexión privado.

PrivateEndpointConnectionProvisioningState

Enumeración

Estado de aprovisionamiento actual.

Valor Description
Succeeded
Creating
Updating
Deleting
Failed

PrivateLinkServiceConnectionState

Objeto

El estado actual de una conexión de punto de conexión privado.

Nombre Tipo Description
actionsRequired

string

Acciones necesarias para una conexión de punto de conexión privado
description

string

Descripción del estado actual de una conexión de punto de conexión privado
status

PrivateLinkServiceConnectionStatus

Estado de una conexión de punto de conexión privado

PrivateLinkServiceConnectionStatus

Enumeración

Estado de una conexión de punto de conexión privado

Valor Description
Pending
Approved
Rejected
Disconnected

ProvisioningState

Enumeración

Estado de aprovisionamiento del espacio de trabajo.

Valor Description
Accepted
Running
Ready
Creating
Created
Deleting
Deleted
Canceled
Failed
Succeeded
Updating

PublicNetworkAccess

Enumeración

Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link. Se utiliza para configurar un enlace privado solo front-end para el espacio de trabajo Serverless ComputeMode.

Valor Description
Enabled
Disabled

RequiredNsgRules

Enumeración

Obtiene o establece un valor que indica si el plano de datos (clústeres) para controlar la comunicación del plano se produce a través del punto de conexión privado. Los valores admitidos son "AllRules" y "NoAzureDatabricksRules". El valor "NoAzureServiceRules" es solo para uso interno. No se permite en el área de trabajo Serverless ComputeMode.

Valor Description
AllRules
NoAzureDatabricksRules
NoAzureServiceRules

Sku

Objeto

SKU del recurso.

Nombre Tipo Description
name

string

Nombre de la SKU.
tier

string

Nivel de SKU.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).
createdBy

string

Identidad que creó el recurso.
createdByType

createdByType

Tipo de identidad que creó el recurso.
lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy

string

Identidad que modificó por última vez el recurso.
lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

Workspace

Objeto

Información sobre el espacio de trabajo.

Nombre Tipo Description
id

string

Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Ubicación geográfica donde reside el recurso
name

string

Nombre del recurso
properties.accessConnector

AccessConnector

Recurso de conector de acceso que se va a asociar a Databricks Workspace. No se permite en el área de trabajo Serverless ComputeMode.
properties.authorizations

WorkspaceProviderAuthorization[]

Las autorizaciones del proveedor del área de trabajo.
properties.computeMode

ComputeMode

El modo de proceso del área de trabajo. Obligatorio en la creación, no se puede cambiar. Los valores posibles incluyen: 'Sin servidor', 'Híbrido'
properties.createdBy

CreatedBy

Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que creó el área de trabajo.
properties.createdDateTime

string (date-time)

Especifica la fecha y la hora en que se crea el espacio de trabajo.
properties.defaultCatalog

DefaultCatalogProperties

Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo. No se permite en el área de trabajo Serverless ComputeMode.
properties.defaultStorageFirewall

defaultStorageFirewall

Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento. No se permite en el área de trabajo Serverless ComputeMode.
properties.diskEncryptionSetId

string

Identificador de recurso del conjunto de cifrado de disco administrado. No se permite en el área de trabajo Serverless ComputeMode.
properties.encryption

WorkspaceProperties.Encryption

Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.
properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.
properties.isUcEnabled

boolean

Indica si el catálogo de Unity está habilitado para el área de trabajo o no. Establézcalo como true en el área de trabajo Serverless ComputeMode.
properties.managedDiskIdentity

ManagedIdentityConfiguration

Los detalles de la identidad administrada del conjunto de cifrado de disco utilizado para el cifrado de disco administrado. Solo se devuelve en el área de trabajo Hybrid ComputeMode.
properties.managedResourceGroupId

string

Id. de grupo de recursos administrado. Requerido en el área de trabajo Hybrid ComputeMode. No se permite en el área de trabajo Serverless ComputeMode.
properties.parameters

WorkspaceCustomParameters

Parámetros personalizados del área de trabajo.
properties.privateEndpointConnections

PrivateEndpointConnection[]

Conexiones de punto de conexión privado creadas en el área de trabajo. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.
properties.provisioningState

ProvisioningState

El estado de aprovisionamiento del área de trabajo.
properties.publicNetworkAccess

PublicNetworkAccess

Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link. Se utiliza para configurar un enlace privado solo front-end para el espacio de trabajo Serverless ComputeMode.
properties.requiredNsgRules

RequiredNsgRules

Obtiene o establece un valor que indica si el plano de datos (clústeres) para controlar la comunicación del plano se produce a través del punto de conexión privado. Los valores admitidos son "AllRules" y "NoAzureDatabricksRules". El valor "NoAzureServiceRules" es solo para uso interno. No se permite en el área de trabajo Serverless ComputeMode.
properties.storageAccountIdentity

ManagedIdentityConfiguration

Los detalles de la identidad administrada de la cuenta de almacenamiento. Solo se devuelve en el área de trabajo Hybrid ComputeMode.
properties.uiDefinitionUri

string

Identificador URI del blob donde se encuentra el archivo de definición de la interfaz de usuario.
properties.updatedBy

CreatedBy

Indica el identificador de objeto, el PUID y el identificador de aplicación de la entidad que actualizaron por última vez el área de trabajo.
properties.workspaceId

string

Identificador único del área de trabajo de Databricks en el plano de control de Databricks.
properties.workspaceUrl

string

La URL del espacio de trabajo que tiene el formato 'adb-{workspaceId}. {aleatorio}.azuredatabricks.net'
sku

Sku

SKU del recurso.
systemData

systemData

Los metadatos del sistema relacionados con este recurso
tags

object

Etiquetas de recursos.
type

string

Tipo de recurso. Por ejemplo, Microsoft.Compute/virtualMachines o Microsoft.Storage/storageAccounts.

Workspace.WorkspaceProperties.Encryption

Objeto

Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.

Nombre Tipo Description
entities

EncryptionEntitiesDefinition

Definición de entidades de cifrado para el área de trabajo.

WorkspaceCustomBooleanParameter

Objeto

Valor que se debe usar para este campo.

Nombre Tipo Description
type

CustomParameterType

El tipo de variable que es
value

boolean

Valor que se debe usar para este campo.

WorkspaceCustomObjectParameter

Objeto

Valor que se debe usar para este campo.

Nombre Tipo Description
type

CustomParameterType

El tipo de variable que es
value

object

Valor que se debe usar para este campo.

WorkspaceCustomParameters

Objeto

Parámetros personalizados usados para la creación de espacios de trabajo. No se permite en el área de trabajo Serverless ComputeMode.

Nombre Tipo Description
amlWorkspaceId

WorkspaceCustomStringParameter

Identificador de un área de trabajo de Azure Machine Learning que se va a vincular con el área de trabajo de Databricks. No se permite en el área de trabajo Serverless ComputeMode.
customPrivateSubnetName

WorkspaceCustomStringParameter

Nombre de la subred privada dentro de la red virtual. No se permite en el área de trabajo Serverless ComputeMode.
customPublicSubnetName

WorkspaceCustomStringParameter

Nombre de una subred pública dentro de la red virtual. No se permite en el área de trabajo Serverless ComputeMode.
customVirtualNetworkId

WorkspaceCustomStringParameter

Identificador de una red virtual en la que se debe crear este clúster de Databricks. No se permite en el área de trabajo Serverless ComputeMode.
enableNoPublicIp

WorkspaceNoPublicIPBooleanParameter

Boolean que indica si se debe deshabilitar la dirección IP pública. El valor predeterminado es true. No se permite en el área de trabajo Serverless ComputeMode.
encryption

WorkspaceEncryptionParameter

Contiene los detalles de cifrado del área de trabajo habilitada para Customer-Managed Key (CMK). No se permite en el área de trabajo Serverless ComputeMode.
loadBalancerBackendPoolName

WorkspaceCustomStringParameter

Nombre del grupo de back-end del equilibrador de carga saliente para la conectividad segura del clúster (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode.
loadBalancerId

WorkspaceCustomStringParameter

URI de recursos del equilibrador de carga saliente para el área de trabajo Conectividad de clúster segura (sin dirección IP pública). No se permite en el área de trabajo Serverless ComputeMode.
natGatewayName

WorkspaceCustomStringParameter

Nombre de la puerta de enlace NAT para las subredes del área de trabajo conectividad de clúster segura (sin ip pública). No se permite en el área de trabajo Serverless ComputeMode.
prepareEncryption

WorkspaceCustomBooleanParameter

Prepare el área de trabajo para el cifrado. Habilita la identidad administrada para la cuenta de almacenamiento administrada. No se permite en el área de trabajo Serverless ComputeMode.
publicIpName

WorkspaceCustomStringParameter

Nombre de la dirección IP pública para el área de trabajo Sin dirección IP pública con red virtual administrada. No se permite en el área de trabajo Serverless ComputeMode.
requireInfrastructureEncryption

WorkspaceCustomBooleanParameter

Valor booleano que indica si el sistema de archivos raíz de DBFS se habilitará o no con la capa secundaria de cifrado con claves administradas por la plataforma para los datos en reposo. No se permite en el área de trabajo Serverless ComputeMode.
resourceTags

WorkspaceCustomObjectParameter

Etiquetas aplicadas a los recursos en Grupo de recursos administrados. Estos se pueden actualizar actualizando las etiquetas en el nivel de espacio de trabajo. No se permite en el área de trabajo Serverless ComputeMode.
storageAccountName

WorkspaceCustomStringParameter

Nombre predeterminado de la cuenta de almacenamiento de DBFS. No se permite en el área de trabajo Serverless ComputeMode.
storageAccountSkuName

WorkspaceCustomStringParameter

Nombre de la SKU de la cuenta de almacenamiento, por ejemplo: Standard_GRS, Standard_LRS. Consulte https://aka.ms/storageskus para obtener entradas válidas. No se permite en el área de trabajo Serverless ComputeMode.
vnetAddressPrefix

WorkspaceCustomStringParameter

Prefijo de dirección de la red virtual administrada. El valor predeterminado de esta entrada es 10.139. No se permite en el área de trabajo Serverless ComputeMode.

WorkspaceCustomStringParameter

Objeto

El valor.

Nombre Tipo Description
type

CustomParameterType

El tipo de variable que es
value

string

Valor que se debe usar para este campo.

WorkspaceEncryptionParameter

Objeto

Objeto que contiene detalles del cifrado utilizado en el área de trabajo.

Nombre Tipo Description
type

CustomParameterType

El tipo de variable que es
value

Encryption

Valor que se debe usar para este campo.

WorkspaceNoPublicIPBooleanParameter

Objeto

Valor que se debe usar para este campo.

Nombre Tipo Description
type

CustomParameterType

El tipo de variable que es
value

boolean

Valor que se debe usar para este campo.

WorkspaceProperties.Encryption

Objeto

Propiedades de cifrado para el área de trabajo de Databricks. Compatible con el área de trabajo sin servidor y Hybrid ComputeMode.

Nombre Tipo Description
entities

EncryptionEntitiesDefinition

Definición de entidades de cifrado para el área de trabajo.

WorkspaceProviderAuthorization

Objeto

La autorización del proveedor del área de trabajo.

Nombre Tipo Description
principalId

string (uuid)

Identificador principal del proveedor. Esta es la identidad que usará el proveedor para llamar a ARM para administrar los recursos del área de trabajo.
roleDefinitionId

string (uuid)

Identificador de definición de rol del proveedor. Este rol definirá todos los permisos que el proveedor debe tener en el grupo de recursos de contenedor del área de trabajo. Esta definición de rol no puede tener permiso para eliminar el grupo de recursos.