Compartir a través de

Workspaces - Create Or Update

  • Referencia
Servicio:
Databricks
Versión de la API:
2024-05-01

Crea una nueva área de trabajo.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}?api-version=2024-05-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 no 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 la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

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

string

Identificador del grupo de recursos administrado.
properties.accessConnector

AccessConnector

Acceso al recurso del conector que se va a asociar al área de trabajo de Databricks
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.
properties.defaultStorageFirewall

defaultStorageFirewall

Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento.
properties.encryption

WorkspaceProperties.Encryption

Propiedades de cifrado para el área de trabajo de Databricks
properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados.
properties.managedDiskIdentity

ManagedIdentityConfiguration

Detalles de la identidad administrada del conjunto de cifrado de disco usado para el cifrado de disco administrado
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.
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.
properties.storageAccountIdentity

ManagedIdentityConfiguration

Detalles de la identidad administrada de la cuenta de almacenamiento
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 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=2024-05-01

{
  "properties": {
    "managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
    "parameters": {
      "prepareEncryption": {
        "value": true
      }
    }
  },
  "location": "westus"
}

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": {
    "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": {
    "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=2024-05-01

{
  "properties": {
    "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"
}

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": {
    "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": {
    "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=2024-05-01

{
  "properties": {
    "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"
}

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": {
    "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": {
    "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 workspace

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace?api-version=2024-05-01

{
  "properties": {
    "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"
}

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": {
    "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": {
    "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=2024-05-01

{
  "properties": {
    "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"
}

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": {
    "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": {
    "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=2024-05-01

{
  "properties": {
    "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"
}

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": {
    "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": {
    "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=2024-05-01

{
  "properties": {
    "managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
    "parameters": {
      "encryption": {
        "value": {
          "keySource": "Default"
        }
      }
    }
  },
  "location": "westus"
}

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": {
    "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": {
    "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=2024-05-01

{
  "properties": {
    "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",
  "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": {
    "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": {
    "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

Acceso al recurso del conector que se va a asociar al área de trabajo de Databricks
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
ComplianceStandard

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

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

Tipo de identidad que creó el recurso.
CustomParameterType

Tipo de variable que se trata
DefaultCatalogProperties

Estas propiedades permiten al usuario especificar propiedades de catálogo predeterminadas durante la creación del área de trabajo.
defaultStorageFirewall

Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento.
Encryption

Objeto que contiene detalles del cifrado usado 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 usado en el área de trabajo.
EnhancedSecurityComplianceDefinition

Estado de la configuración relacionada con el Complemento de seguridad y cumplimiento mejorados.
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 usado en el área de trabajo.
ManagedIdentityConfiguration

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

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

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

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 área 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.
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.
Sku

SKU del recurso.
systemData

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

Información sobre el área de trabajo.
Workspace.WorkspaceProperties.Encryption

Propiedades de cifrado para el área de trabajo de Databricks
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 clústeres.
WorkspaceCustomStringParameter

Valor.
WorkspaceEncryptionParameter

Objeto que contiene detalles del cifrado usado 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
WorkspaceProviderAuthorization

Autorización del proveedor del área de trabajo.

AccessConnector

Object

Acceso al recurso del conector que se va a asociar al área de trabajo de Databricks

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

Object

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

Nombre Tipo Description
value

AutomaticClusterUpdateValue

AutomaticClusterUpdateValue

Enumeración
Valor Description
Disabled
Enabled

ComplianceSecurityProfileDefinition

Object

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

Nombre Tipo Description
complianceStandards

ComplianceStandard[]

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

ComplianceSecurityProfileValue

ComplianceSecurityProfileValue

Enumeración
Valor Description
Disabled
Enabled

ComplianceStandard

Enumeración

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

Valor Description
HIPAA
NONE
PCI_DSS

CreatedBy

Object

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

Nombre Tipo Description
applicationId

string (uuid)

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

string (uuid)

Identificador de objeto que creó el área de trabajo.
puid

string

Identificador de objeto personal correspondiente al identificador de objeto anterior

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

CustomParameterType

Enumeración

Tipo de variable que se trata

Valor Description
Bool
Object
String

DefaultCatalogProperties

Object

Estas propiedades permiten al usuario especificar propiedades de catálogo predeterminadas durante la creación del área de trabajo.

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.

Valor Description
Disabled
Enabled

Encryption

Object

Objeto que contiene detalles del cifrado usado 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

Object

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

EncryptionV2

Propiedades de cifrado para los servicios administrados de Databricks.

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

Object

Objeto que contiene detalles del cifrado usado 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

Object

Estado de la configuración relacionada con el Complemento de seguridad y cumplimiento mejorados.

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

Object

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

Nombre Tipo Description
value

EnhancedSecurityMonitoringValue

EnhancedSecurityMonitoringValue

Enumeración
Valor Description
Disabled
Enabled

ErrorDetail

Object

Detalles del error.

Nombre Tipo Description
code

string

Código del error.
message

string

Mensaje de error legible para personas.
target

string

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

ErrorInfo

Object

El código y el mensaje de un error.

Nombre Tipo Description
code

string

Código de error legible de la máquina.
details

ErrorDetail[]

detalles del error.
innererror

string

Detalles del error interno si existen.
message

string

Mensaje de error legible para personas.

ErrorResponse

Object

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

Object

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

Object

Objeto que contiene detalles del cifrado usado 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.
rotationToLatestKeyVersionEnabled

boolean

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

ManagedIdentityConfiguration

Object

Los detalles de identidad administrada de la cuenta de almacenamiento.

Nombre Tipo Description
principalId

string (uuid)

ObjectId de la identidad administrada que está vinculada a la cuenta de Almacenamiento administrado.
tenantId

string (uuid)

Identificador de inquilino donde se crea la identidad administrada.
type

string

Tipo de Identidad creada. Puede ser SystemAssigned o UserAssigned.

PrivateEndpoint

Object

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

Nombre Tipo Description
id

string

Identificador de recurso.

PrivateEndpointConnection

Object

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

Object

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 Private Link
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
Creating
Deleting
Failed
Succeeded
Updating

PrivateLinkServiceConnectionState

Object

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
Approved
Disconnected
Pending
Rejected

ProvisioningState

Enumeración

Estado de aprovisionamiento del área de trabajo.

Valor Description
Accepted
Canceled
Created
Creating
Deleted
Deleting
Failed
Ready
Running
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.

Valor Description
Disabled
Enabled

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.

Valor Description
AllRules
NoAzureDatabricksRules
NoAzureServiceRules

Sku

Object

SKU del recurso.

Nombre Tipo Description
name

string

Nombre de la SKU.
tier

string

Nivel de SKU.

systemData

Object

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

Object

Información sobre el área 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

Acceso al recurso del conector que se va a asociar al área de trabajo de Databricks
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.createdDateTime

string (date-time)

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

DefaultCatalogProperties

Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo.
properties.defaultStorageFirewall

defaultStorageFirewall

Obtiene o establece la información de configuración predeterminada del firewall de almacenamiento.
properties.diskEncryptionSetId

string

Identificador de recurso del conjunto de cifrado de disco administrado.
properties.encryption

WorkspaceProperties.Encryption

Propiedades de cifrado para el área de trabajo de Databricks
properties.enhancedSecurityCompliance

EnhancedSecurityComplianceDefinition

Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados.
properties.isUcEnabled

boolean

Indica si el catálogo de Unity está habilitado para el área de trabajo o no.
properties.managedDiskIdentity

ManagedIdentityConfiguration

Detalles de la identidad administrada del conjunto de cifrado de disco usado para el cifrado de disco administrado
properties.managedResourceGroupId

string

Identificador del grupo de recursos administrado.
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
properties.provisioningState

ProvisioningState

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.
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.
properties.storageAccountIdentity

ManagedIdentityConfiguration

Detalles de la identidad administrada de la cuenta de almacenamiento
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

Dirección URL del área de trabajo con el formato "adb-{workspaceId}. {random}.azuredatabricks.net'
sku

Sku

SKU del recurso.
systemData

systemData

Metadatos del sistema relacionados con este recurso
tags

object

Etiquetas de recursos.
type

string

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

Workspace.WorkspaceProperties.Encryption

Object

Propiedades de cifrado para el área de trabajo de Databricks

Nombre Tipo Description
entities

EncryptionEntitiesDefinition

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

WorkspaceCustomBooleanParameter

Object

Valor que se debe usar para este campo.

Nombre Tipo Description
type

CustomParameterType

Tipo de variable que se trata
value

boolean

Valor que se debe usar para este campo.

WorkspaceCustomObjectParameter

Object

Valor que se debe usar para este campo.

Nombre Tipo Description
type

CustomParameterType

Tipo de variable que se trata
value

object

Valor que se debe usar para este campo.

WorkspaceCustomParameters

Object

Parámetros personalizados usados para la creación de clústeres.

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
customPrivateSubnetName

WorkspaceCustomStringParameter

Nombre de la subred privada dentro de la red virtual
customPublicSubnetName

WorkspaceCustomStringParameter

Nombre de una subred pública dentro de la red virtual
customVirtualNetworkId

WorkspaceCustomStringParameter

El identificador de una red virtual donde se debe crear este clúster de Databricks
enableNoPublicIp

WorkspaceNoPublicIPBooleanParameter

Boolean que indica si se debe deshabilitar la dirección IP pública. El valor predeterminado es true
encryption

WorkspaceEncryptionParameter

Contiene los detalles de cifrado del área de trabajo habilitada para Customer-Managed Clave (CMK).
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).
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).
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).
prepareEncryption

WorkspaceCustomBooleanParameter

Prepare el área de trabajo para el cifrado. Habilita la identidad administrada para la cuenta de almacenamiento administrada.
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.
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.
resourceTags

WorkspaceCustomObjectParameter

Etiquetas aplicadas a los recursos en grupo de recursos administrados. Estas se pueden actualizar actualizando etiquetas en el nivel del área de trabajo.
storageAccountName

WorkspaceCustomStringParameter

Nombre predeterminado de la cuenta de almacenamiento de DBFS.
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.
vnetAddressPrefix

WorkspaceCustomStringParameter

Prefijo de dirección de la red virtual administrada. El valor predeterminado de esta entrada es 10.139.

WorkspaceCustomStringParameter

Object

Valor.

Nombre Tipo Description
type

CustomParameterType

Tipo de variable que se trata
value

string

Valor que se debe usar para este campo.

WorkspaceEncryptionParameter

Object

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

Nombre Tipo Description
type

CustomParameterType

Tipo de variable que se trata
value

Encryption

Valor que se debe usar para este campo.

WorkspaceNoPublicIPBooleanParameter

Object

Valor que se debe usar para este campo.

Nombre Tipo Description
type

CustomParameterType

Tipo de variable que se trata
value

boolean

Valor que se debe usar para este campo.

WorkspaceProperties.Encryption

Object

Propiedades de cifrado para el área de trabajo de Databricks

Nombre Tipo Description
entities

EncryptionEntitiesDefinition

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

WorkspaceProviderAuthorization

Object

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.