Partilhar via

Workspaces - Create Or Update

Serviço:
Databricks
Versão da API:
2026-01-01

Cria um novo espaço de trabalho.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId
 path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.
workspaceName
 path True

string

minLength: 3
maxLength: 64

O nome do espaço de trabalho.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

A geolocalização onde o recurso vive
properties.computeMode True

ComputeMode

O modo de computação do espaço de trabalho. Necessário na criação, não pode ser alterado. Os valores possíveis incluem: 'Serverless', 'Hybrid'
properties.accessConnector

AccessConnector

Recurso do Conector do Access que será associado ao Espaço de Trabalho Databricks. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.authorizations

WorkspaceProviderAuthorization[]

As autorizações do provedor de espaço de trabalho.
properties.createdBy

CreatedBy

Indica a ID do objeto, PUID e ID do aplicativo da entidade que criou o espaço de trabalho.
properties.defaultCatalog

DefaultCatalogProperties

Propriedades para configuração do Catálogo Padrão durante a criação do espaço de trabalho. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.defaultStorageFirewall

defaultStorageFirewall

Obtém ou define informações de configuração do Firewall de Armazenamento Padrão. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.encryption

WorkspaceProperties.Encryption

Propriedades de criptografia para o espaço de trabalho databricks. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.
properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

Contém configurações relacionadas ao Complemento de Segurança Reforçada e Conformidade. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.
properties.managedDiskIdentity

ManagedIdentityConfiguration

Os detalhes da Identidade Gerenciada do Conjunto de Criptografia de Disco usado para a Criptografia de Disco Gerenciado. Retornado somente no espaço de trabalho Hybrid ComputeMode.
properties.managedResourceGroupId

string

O grupo de recursos gerenciado Id. Necessário no espaço de trabalho Hybrid ComputeMode. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.parameters

WorkspaceCustomParameters

Os parâmetros personalizados do espaço de trabalho.
properties.publicNetworkAccess

PublicNetworkAccess

O tipo de acesso à rede para acessar o espaço de trabalho. Defina o valor como desativado para acessar o espaço de trabalho somente via link privado. Usado para configurar ligação privada apenas front-end para o espaço de trabalho Serverless ComputeMode.
properties.requiredNsgRules

RequiredNsgRules

Obtém ou define um valor que indica se o plano de dados (clusters) para controlar a comunicação do plano acontece no ponto de extremidade privado. Os valores suportados são 'AllRules' e 'NoAzureDatabricksRules'. O valor 'NoAzureServiceRules' é apenas para uso interno. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.storageAccountIdentity

ManagedIdentityConfiguration

Os detalhes da Identidade Gerenciada da Conta de Armazenamento. Retornado somente no espaço de trabalho Hybrid ComputeMode.
properties.uiDefinitionUri

string

O URI de blob onde o arquivo de definição da interface do usuário está localizado.
properties.updatedBy

CreatedBy

Indica a ID do objeto, PUID e ID do aplicativo da entidade que atualizou o espaço de trabalho pela última vez.
sku

Sku

O SKU do recurso.
tags

object

Tags de recursos.

Respostas

Name Tipo Description
200 OK

Workspace

Criado - Retorna informações sobre o espaço de trabalho, incluindo o status de provisionamento.
201 Created

Workspace

Criado - Retorna informações sobre o espaço de trabalho, incluindo o status de provisionamento.
Other Status Codes

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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"
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
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
  }
}

Definições

Name Description
AccessConnector

Recurso do Conector do Access que será associado ao Espaço de Trabalho Databricks. Não permitido no espaço de trabalho Serverless ComputeMode.
AutomaticClusterUpdateDefinition

Status do recurso de atualizações automatizadas de cluster.
AutomaticClusterUpdateValue
ComplianceSecurityProfileDefinition

Status do recurso Perfil de Segurança de Conformidade.
ComplianceSecurityProfileValue
ComputeMode

O modo de computação do espaço de trabalho. Necessário na criação, não pode ser alterado. Os valores possíveis incluem: 'Serverless', 'Hybrid'
CreatedBy

Fornece detalhes da entidade que criou/atualizou o espaço de trabalho.
createdByType

O tipo de identidade que criou o recurso.
CustomParameterType

O tipo de variável que é
DefaultCatalogProperties

Essas propriedades permitem que o usuário especifique as propriedades padrão do catálogo durante a criação do espaço de trabalho. Não permitido no espaço de trabalho Serverless ComputeMode.
defaultStorageFirewall

Obtém ou define informações de configuração do Firewall de Armazenamento Padrão. Não permitido no espaço de trabalho Serverless ComputeMode.
Encryption

O objeto que contém detalhes de criptografia usados no espaço de trabalho.
EncryptionEntitiesDefinition

Entidades de criptografia para recurso de espaço de trabalho databricks.
EncryptionKeySource

A chave de criptografiaSource (provedor). Valores possíveis (sem distinção entre maiúsculas e minúsculas): Microsoft.Keyvault
EncryptionV2

O objeto que contém detalhes de criptografia usados no espaço de trabalho.
EnhancedSecurityComplianceDefinition

Status das configurações relacionadas ao complemento de conformidade e segurança reforçadas.
EnhancedSecurityMonitoringDefinition

Status do recurso de Monitoramento de Segurança Reforçada.
EnhancedSecurityMonitoringValue
ErrorDetail

Detalhes do erro.
ErrorInfo

O código e a mensagem para um erro.
ErrorResponse

Resposta de erro.
IdentityType

O tipo de identidade do recurso do Access Connector.
initialType

Define o tipo inicial do catálogo padrão. Valores possíveis (sem distinção entre maiúsculas e minúsculas): HiveMetastore, UnityCatalog
KeySource

A chave de criptografiaSource (provedor). Valores possíveis (sem distinção entre maiúsculas e minúsculas): Padrão, Microsoft.Keyvault
KeyVaultProperties

Propriedades de entrada do Cofre da Chave para criptografia.
ManagedDiskEncryption

O objeto que contém detalhes de criptografia usados no espaço de trabalho.
ManagedIdentityConfiguration

Os detalhes da Identidade Gerenciada para a conta de armazenamento.
PrivateEndpoint

A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privada.
PrivateEndpointConnection

A conexão de ponto de extremidade privado de um espaço de trabalho.
PrivateEndpointConnectionProperties

As propriedades de uma conexão de ponto de extremidade privada.
PrivateEndpointConnectionProvisioningState

O estado de provisionamento atual.
PrivateLinkServiceConnectionState

O estado atual de uma conexão de ponto de extremidade privado.
PrivateLinkServiceConnectionStatus

O status de uma conexão de ponto de extremidade privada
ProvisioningState

Status de provisionamento do espaço de trabalho.
PublicNetworkAccess

O tipo de acesso à rede para acessar o espaço de trabalho. Defina o valor como desativado para acessar o espaço de trabalho somente via link privado. Usado para configurar ligação privada apenas front-end para o espaço de trabalho Serverless ComputeMode.
RequiredNsgRules

Obtém ou define um valor que indica se o plano de dados (clusters) para controlar a comunicação do plano acontece no ponto de extremidade privado. Os valores suportados são 'AllRules' e 'NoAzureDatabricksRules'. O valor 'NoAzureServiceRules' é apenas para uso interno. Não permitido no espaço de trabalho Serverless ComputeMode.
Sku

SKU para o recurso.
systemData

Metadados referentes à criação e última modificação do recurso.
Workspace

Informações sobre o espaço de trabalho.
Workspace.WorkspaceProperties.Encryption

Propriedades de criptografia para o espaço de trabalho databricks. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.
WorkspaceCustomBooleanParameter

O valor que deve ser usado para este campo.
WorkspaceCustomObjectParameter

O valor que deve ser usado para este campo.
WorkspaceCustomParameters

Parâmetros personalizados usados para a criação de espaços de trabalho. Não permitido no espaço de trabalho Serverless ComputeMode.
WorkspaceCustomStringParameter

O valor.
WorkspaceEncryptionParameter

O objeto que contém detalhes de criptografia usados no espaço de trabalho.
WorkspaceNoPublicIPBooleanParameter

O valor que deve ser usado para este campo.
WorkspaceProperties.Encryption

Propriedades de criptografia para o espaço de trabalho databricks. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.
WorkspaceProviderAuthorization

A autorização do provedor de espaço de trabalho.

AccessConnector

Object

Recurso do Conector do Access que será associado ao Espaço de Trabalho Databricks. Não permitido no espaço de trabalho Serverless ComputeMode.

Name Tipo Description
id

string (arm-id)

A ID do recurso do Azure Databricks Access Connector Resource.
identityType

IdentityType

O tipo de identidade do recurso do Access Connector.
userAssignedIdentityId

string (arm-id)

A ID do recurso da Identidade Atribuída ao Usuário associada ao Recurso do Conector de Acesso. Isso é necessário para o tipo 'UserAssigned' e não é válido para o tipo 'SystemAssigned'.

AutomaticClusterUpdateDefinition

Object

Status do recurso de atualizações automatizadas de cluster.

Name Tipo Description
value

AutomaticClusterUpdateValue

AutomaticClusterUpdateValue

Enumeração
Valor Description
Enabled
Disabled

ComplianceSecurityProfileDefinition

Object

Status do recurso Perfil de Segurança de Conformidade.

Name Tipo Description
complianceStandards

string[]

Padrões de conformidade associados ao espaço de trabalho.
value

ComplianceSecurityProfileValue

ComplianceSecurityProfileValue

Enumeração
Valor Description
Enabled
Disabled

ComputeMode

Enumeração

O modo de computação do espaço de trabalho. Necessário na criação, não pode ser alterado. Os valores possíveis incluem: 'Serverless', 'Hybrid'

Valor Description
Serverless
Hybrid

CreatedBy

Object

Fornece detalhes da entidade que criou/atualizou o espaço de trabalho.

Name Tipo Description
applicationId

string (uuid)

A ID do aplicativo que iniciou a criação do espaço de trabalho. Por exemplo, Portal do Azure.
oid

string (uuid)

A ID do objeto que criou o espaço de trabalho.
puid

string

O ID do objeto pessoal correspondente ao ID do objeto acima

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

CustomParameterType

Enumeração

O tipo de variável que é

Valor Description
Bool
Object
String

DefaultCatalogProperties

Object

Essas propriedades permitem que o usuário especifique as propriedades padrão do catálogo durante a criação do espaço de trabalho. Não permitido no espaço de trabalho Serverless ComputeMode.

Name Tipo Default value Description
initialName

string

Especifica o Nome inicial do catálogo padrão. Se não for especificado, o nome do espaço de trabalho será usado.
initialType

initialType

HiveMetastore

Define o tipo inicial do catálogo padrão. Valores possíveis (sem distinção entre maiúsculas e minúsculas): HiveMetastore, UnityCatalog

defaultStorageFirewall

Enumeração

Obtém ou define informações de configuração do Firewall de Armazenamento Padrão. Não permitido no espaço de trabalho Serverless ComputeMode.

Valor Description
Disabled
Enabled

Encryption

Object

O objeto que contém detalhes de criptografia usados no espaço de trabalho.

Name Tipo Default value Description
KeyName

string

O nome da chave KeyVault.
keySource

KeySource

Default

A chave de criptografiaSource (provedor). Valores possíveis (sem distinção entre maiúsculas e minúsculas): Padrão, Microsoft.Keyvault
keyvaulturi

string

O Uri do KeyVault.
keyversion

string

A versão da chave KeyVault.

EncryptionEntitiesDefinition

Object

Entidades de criptografia para recurso de espaço de trabalho databricks.

Name Tipo Description
managedDisk

ManagedDiskEncryption

Propriedades de criptografia para os discos gerenciados databricks. Não permitido no espaço de trabalho Serverless ComputeMode.
managedServices

EncryptionV2

Propriedades de criptografia para os serviços gerenciados databricks. Suportado em Serverless e Hybrid ComputeMode.

EncryptionKeySource

Enumeração

A chave de criptografiaSource (provedor). Valores possíveis (sem distinção entre maiúsculas e minúsculas): Microsoft.Keyvault

Valor Description
Microsoft.Keyvault

EncryptionV2

Object

O objeto que contém detalhes de criptografia usados no espaço de trabalho.

Name Tipo Description
keySource

EncryptionKeySource

A chave de criptografiaSource (provedor). Valores possíveis (sem distinção entre maiúsculas e minúsculas): Microsoft.Keyvault
keyVaultProperties

KeyVaultProperties

Propriedades de entrada do Cofre da Chave para criptografia.

EnhancedSecurityComplianceDefinition

Object

Status das configurações relacionadas ao complemento de conformidade e segurança reforçadas.

Name Tipo Description
automaticClusterUpdate

AutomaticClusterUpdateDefinition

Status do recurso de atualizações automatizadas de cluster.
complianceSecurityProfile

ComplianceSecurityProfileDefinition

Status do recurso Perfil de Segurança de Conformidade.
enhancedSecurityMonitoring

EnhancedSecurityMonitoringDefinition

Status do recurso de Monitoramento de Segurança Reforçada.

EnhancedSecurityMonitoringDefinition

Object

Status do recurso de Monitoramento de Segurança Reforçada.

Name Tipo Description
value

EnhancedSecurityMonitoringValue

EnhancedSecurityMonitoringValue

Enumeração
Valor Description
Enabled
Disabled

ErrorDetail

Object

Detalhes do erro.

Name Tipo Description
code

string

O código do erro.
message

string

Uma mensagem de erro legível por humanos.
target

string

Indica qual propriedade na solicitação é responsável pelo erro.

ErrorInfo

Object

O código e a mensagem para um erro.

Name Tipo Description
code

string

Um código de erro legível por máquina.
details

ErrorDetail[]

detalhes do erro.
innererror

string

Detalhes do erro interno, se existirem.
message

string

Uma mensagem de erro legível por humanos.

ErrorResponse

Object

Resposta de erro.

Name Tipo Description
error

ErrorInfo

O código e a mensagem para um erro.
Os detalhes do erro.

IdentityType

Enumeração

O tipo de identidade do recurso do Access Connector.

Valor Description
SystemAssigned
UserAssigned

initialType

Enumeração

Define o tipo inicial do catálogo padrão. Valores possíveis (sem distinção entre maiúsculas e minúsculas): HiveMetastore, UnityCatalog

Valor Description
HiveMetastore
UnityCatalog

KeySource

Enumeração

A chave de criptografiaSource (provedor). Valores possíveis (sem distinção entre maiúsculas e minúsculas): Padrão, Microsoft.Keyvault

Valor Description
Default
Microsoft.Keyvault

KeyVaultProperties

Object

Propriedades de entrada do Cofre da Chave para criptografia.

Name Tipo Description
keyName

string

O nome da chave KeyVault.
keyVaultUri

string

O Uri do KeyVault.
keyVersion

string

A versão da chave KeyVault.

ManagedDiskEncryption

Object

O objeto que contém detalhes de criptografia usados no espaço de trabalho.

Name Tipo Description
keySource

EncryptionKeySource

A chave de criptografiaSource (provedor). Valores possíveis (sem distinção entre maiúsculas e minúsculas): Microsoft.Keyvault. Não permitido no espaço de trabalho Serverless ComputeMode.
keyVaultProperties

KeyVaultProperties

Propriedades de entrada do Cofre da Chave para criptografia.
rotationToLatestKeyVersionEnabled

boolean

Indique se a versão de chave mais recente deve ser usada automaticamente para criptografia de disco gerenciado.

ManagedIdentityConfiguration

Object

Os detalhes da Identidade Gerenciada para a conta de armazenamento.

Name Tipo Description
principalId

string (uuid)

O objectId da Identidade Gerenciada vinculada à conta do Armazenamento Gerenciado.
tenantId

string (uuid)

A ID do locatário onde a Identidade Gerenciada é criada.
type

string

O tipo de Identidade criada. Ele pode ser SystemAssigned ou UserAssigned.

PrivateEndpoint

Object

A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privada.

Name Tipo Description
id

string

O identificador de recurso.

PrivateEndpointConnection

Object

A conexão de ponto de extremidade privado de um espaço de trabalho.

Name Tipo Description
id

string

O identificador de recurso.
name

string

O nome do recurso.
properties

PrivateEndpointConnectionProperties

As propriedades de conexão de ponto de extremidade privado.
type

string

O tipo do recurso.

PrivateEndpointConnectionProperties

Object

As propriedades de uma conexão de ponto de extremidade privada.

Name Tipo Description
groupIds

string[]

GroupIds do recurso de serviço de link privado.
privateEndpoint

PrivateEndpoint

Ponto final privado
Ponto final privado
privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Estado da conexão do serviço de link privado
Estado de conexão de ponto de extremidade privado
provisioningState

PrivateEndpointConnectionProvisioningState

Estado de provisionamento da conexão de ponto de extremidade privado.

PrivateEndpointConnectionProvisioningState

Enumeração

O estado de provisionamento atual.

Valor Description
Succeeded
Creating
Updating
Deleting
Failed

PrivateLinkServiceConnectionState

Object

O estado atual de uma conexão de ponto de extremidade privado.

Name Tipo Description
actionsRequired

string

Ações necessárias para uma conexão de ponto de extremidade privada
description

string

A descrição do estado atual de uma conexão de ponto de extremidade privada
status

PrivateLinkServiceConnectionStatus

O status de uma conexão de ponto de extremidade privada

PrivateLinkServiceConnectionStatus

Enumeração

O status de uma conexão de ponto de extremidade privada

Valor Description
Pending
Approved
Rejected
Disconnected

ProvisioningState

Enumeração

Status de provisionamento do espaço de trabalho.

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

PublicNetworkAccess

Enumeração

O tipo de acesso à rede para acessar o espaço de trabalho. Defina o valor como desativado para acessar o espaço de trabalho somente via link privado. Usado para configurar ligação privada apenas front-end para o espaço de trabalho Serverless ComputeMode.

Valor Description
Enabled
Disabled

RequiredNsgRules

Enumeração

Obtém ou define um valor que indica se o plano de dados (clusters) para controlar a comunicação do plano acontece no ponto de extremidade privado. Os valores suportados são 'AllRules' e 'NoAzureDatabricksRules'. O valor 'NoAzureServiceRules' é apenas para uso interno. Não permitido no espaço de trabalho Serverless ComputeMode.

Valor Description
AllRules
NoAzureDatabricksRules
NoAzureServiceRules

Sku

Object

SKU para o recurso.

Name Tipo Description
name

string

O nome SKU.
tier

string

O nível de SKU.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

Workspace

Object

Informações sobre o espaço de trabalho.

Name Tipo Description
id

string

ID do recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

A geolocalização onde o recurso vive
name

string

O nome do recurso
properties.accessConnector

AccessConnector

Recurso do Conector do Access que será associado ao Espaço de Trabalho Databricks. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.authorizations

WorkspaceProviderAuthorization[]

As autorizações do provedor de espaço de trabalho.
properties.computeMode

ComputeMode

O modo de computação do espaço de trabalho. Necessário na criação, não pode ser alterado. Os valores possíveis incluem: 'Serverless', 'Hybrid'
properties.createdBy

CreatedBy

Indica a ID do objeto, PUID e ID do aplicativo da entidade que criou o espaço de trabalho.
properties.createdDateTime

string (date-time)

Especifica a data e a hora em que o espaço de trabalho é criado.
properties.defaultCatalog

DefaultCatalogProperties

Propriedades para configuração do Catálogo Padrão durante a criação do espaço de trabalho. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.defaultStorageFirewall

defaultStorageFirewall

Obtém ou define informações de configuração do Firewall de Armazenamento Padrão. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.diskEncryptionSetId

string

A ID do recurso do conjunto de criptografia de disco gerenciado. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.encryption

WorkspaceProperties.Encryption

Propriedades de criptografia para o espaço de trabalho databricks. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.
properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

Contém configurações relacionadas ao Complemento de Segurança Reforçada e Conformidade. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.
properties.isUcEnabled

boolean

Indica se o catálogo de unidades está habilitado para o espaço de trabalho ou não. Defina como true no espaço de trabalho Serverless ComputeMode.
properties.managedDiskIdentity

ManagedIdentityConfiguration

Os detalhes da Identidade Gerenciada do Conjunto de Criptografia de Disco usado para a Criptografia de Disco Gerenciado. Retornado somente no espaço de trabalho Hybrid ComputeMode.
properties.managedResourceGroupId

string

O grupo de recursos gerenciado Id. Necessário no espaço de trabalho Hybrid ComputeMode. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.parameters

WorkspaceCustomParameters

Os parâmetros personalizados do espaço de trabalho.
properties.privateEndpointConnections

PrivateEndpointConnection[]

Conexões de ponto de extremidade privadas criadas no espaço de trabalho. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.
properties.provisioningState

ProvisioningState

O estado de provisionamento do espaço de trabalho.
properties.publicNetworkAccess

PublicNetworkAccess

O tipo de acesso à rede para acessar o espaço de trabalho. Defina o valor como desativado para acessar o espaço de trabalho somente via link privado. Usado para configurar ligação privada apenas front-end para o espaço de trabalho Serverless ComputeMode.
properties.requiredNsgRules

RequiredNsgRules

Obtém ou define um valor que indica se o plano de dados (clusters) para controlar a comunicação do plano acontece no ponto de extremidade privado. Os valores suportados são 'AllRules' e 'NoAzureDatabricksRules'. O valor 'NoAzureServiceRules' é apenas para uso interno. Não permitido no espaço de trabalho Serverless ComputeMode.
properties.storageAccountIdentity

ManagedIdentityConfiguration

Os detalhes da Identidade Gerenciada da Conta de Armazenamento. Retornado somente no espaço de trabalho Hybrid ComputeMode.
properties.uiDefinitionUri

string

O URI de blob onde o arquivo de definição da interface do usuário está localizado.
properties.updatedBy

CreatedBy

Indica a ID do objeto, PUID e ID do aplicativo da entidade que atualizou o espaço de trabalho pela última vez.
properties.workspaceId

string

O identificador exclusivo do espaço de trabalho databricks no plano de controle databricks.
properties.workspaceUrl

string

A URL do espaço de trabalho que é do formato 'adb-{workspaceId}. {aleatório}.azuredatabricks.net'
sku

Sku

O SKU do recurso.
systemData

systemData

Os metadados do sistema relativos a este recurso
tags

object

Tags de recursos.
type

string

O tipo do recurso. Ex- Microsoft.Compute/virtualMachines ou Microsoft.Storage/storageAccounts.

Workspace.WorkspaceProperties.Encryption

Object

Propriedades de criptografia para o espaço de trabalho databricks. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.

Name Tipo Description
entities

EncryptionEntitiesDefinition

Definição de entidades de criptografia para o espaço de trabalho.

WorkspaceCustomBooleanParameter

Object

O valor que deve ser usado para este campo.

Name Tipo Description
type

CustomParameterType

O tipo de variável que é
value

boolean

O valor que deve ser usado para este campo.

WorkspaceCustomObjectParameter

Object

O valor que deve ser usado para este campo.

Name Tipo Description
type

CustomParameterType

O tipo de variável que é
value

object

O valor que deve ser usado para este campo.

WorkspaceCustomParameters

Object

Parâmetros personalizados usados para a criação de espaços de trabalho. Não permitido no espaço de trabalho Serverless ComputeMode.

Name Tipo Description
amlWorkspaceId

WorkspaceCustomStringParameter

A ID de um espaço de trabalho do Azure Machine Learning para vincular ao espaço de trabalho Databricks. Não permitido no espaço de trabalho Serverless ComputeMode.
customPrivateSubnetName

WorkspaceCustomStringParameter

O nome da sub-rede privada dentro da rede virtual. Não permitido no espaço de trabalho Serverless ComputeMode.
customPublicSubnetName

WorkspaceCustomStringParameter

O nome de uma Sub-rede Pública dentro da Rede Virtual. Não permitido no espaço de trabalho Serverless ComputeMode.
customVirtualNetworkId

WorkspaceCustomStringParameter

A ID de uma Rede Virtual onde este Cluster Databricks deve ser criado. Não permitido no espaço de trabalho Serverless ComputeMode.
enableNoPublicIp

WorkspaceNoPublicIPBooleanParameter

Booleano indicando se o IP público deve ser desativado. O valor predefinido é verdadeiro. Não permitido no espaço de trabalho Serverless ComputeMode.
encryption

WorkspaceEncryptionParameter

Contém os detalhes de criptografia para o espaço de trabalho habilitado para Chave Customer-Managed (CMK). Não permitido no espaço de trabalho Serverless ComputeMode.
loadBalancerBackendPoolName

WorkspaceCustomStringParameter

Nome do Pool de Back-end do Balanceador de Carga de saída para Conectividade de Cluster Seguro (Sem IP Público). Não permitido no espaço de trabalho Serverless ComputeMode.
loadBalancerId

WorkspaceCustomStringParameter

URI de recurso do balanceador de carga de saída para espaço de trabalho de conectividade de cluster seguro (sem IP público). Não permitido no espaço de trabalho Serverless ComputeMode.
natGatewayName

WorkspaceCustomStringParameter

Nome do gateway NAT para sub-redes de espaço de trabalho de Conectividade de Cluster Seguro (Sem IP Público). Não permitido no espaço de trabalho Serverless ComputeMode.
prepareEncryption

WorkspaceCustomBooleanParameter

Prepare o espaço de trabalho para criptografia. Habilita a Identidade Gerenciada para conta de armazenamento gerenciado. Não permitido no espaço de trabalho Serverless ComputeMode.
publicIpName

WorkspaceCustomStringParameter

Nome do IP público para nenhum espaço de trabalho IP público com vNet gerenciado. Não permitido no espaço de trabalho Serverless ComputeMode.
requireInfrastructureEncryption

WorkspaceCustomBooleanParameter

Um booleano que indica se o sistema de arquivos raiz DBFS será habilitado ou não com camada secundária de criptografia com chaves gerenciadas pela plataforma para dados em repouso. Não permitido no espaço de trabalho Serverless ComputeMode.
resourceTags

WorkspaceCustomObjectParameter

Tags aplicadas a recursos em Grupo de recursos gerenciados. Eles podem ser atualizados atualizando as tags no nível do espaço de trabalho. Não permitido no espaço de trabalho Serverless ComputeMode.
storageAccountName

WorkspaceCustomStringParameter

Nome da conta de armazenamento DBFS padrão. Não permitido no espaço de trabalho Serverless ComputeMode.
storageAccountSkuName

WorkspaceCustomStringParameter

Nome da SKU da conta de armazenamento, por exemplo: Standard_GRS, Standard_LRS. Consulte https://aka.ms/storageskus para obter entradas válidas. Não permitido no espaço de trabalho Serverless ComputeMode.
vnetAddressPrefix

WorkspaceCustomStringParameter

Prefixo de endereço para rede virtual gerenciada. O valor padrão para essa entrada é 10.139. Não permitido no espaço de trabalho Serverless ComputeMode.

WorkspaceCustomStringParameter

Object

O valor.

Name Tipo Description
type

CustomParameterType

O tipo de variável que é
value

string

O valor que deve ser usado para este campo.

WorkspaceEncryptionParameter

Object

O objeto que contém detalhes de criptografia usados no espaço de trabalho.

Name Tipo Description
type

CustomParameterType

O tipo de variável que é
value

Encryption

O valor que deve ser usado para este campo.

WorkspaceNoPublicIPBooleanParameter

Object

O valor que deve ser usado para este campo.

Name Tipo Description
type

CustomParameterType

O tipo de variável que é
value

boolean

O valor que deve ser usado para este campo.

WorkspaceProperties.Encryption

Object

Propriedades de criptografia para o espaço de trabalho databricks. Suportado no espaço de trabalho Serverless e Hybrid ComputeMode.

Name Tipo Description
entities

EncryptionEntitiesDefinition

Definição de entidades de criptografia para o espaço de trabalho.

WorkspaceProviderAuthorization

Object

A autorização do provedor de espaço de trabalho.

Name Tipo Description
principalId

string (uuid)

O identificador principal do provedor. Essa é a identidade que o provedor usará para chamar o ARM para gerenciar os recursos do espaço de trabalho.
roleDefinitionId

string (uuid)

O identificador de definição de função do provedor. Essa função definirá todas as permissões que o provedor deve ter no grupo de recursos de contêiner do espaço de trabalho. Essa definição de função não pode ter permissão para excluir o grupo de recursos.