Workspaces - Create Or Update
새 작업 영역을 만듭니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}?api-version=2026-01-01
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
|
workspace
|
path | True |
string minLength: 3maxLength: 64 |
작업 영역의 이름입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 본문
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| location | True |
string |
리소스가 있는 지리적 위치 |
| properties.computeMode | True |
작업 영역 컴퓨팅 모드입니다. 만들 때 필요하며 변경할 수 없습니다. 가능한 값은 'Serverless', 'Hybrid'입니다. |
|
| properties.accessConnector |
Databricks 작업 영역과 연결될 커넥터 리소스에 액세스합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
||
| properties.authorizations |
작업 영역 공급자 권한 부여입니다. |
||
| properties.createdBy |
작업 영역을 만든 엔터티의 개체 ID, PUID 및 애플리케이션 ID를 나타냅니다. |
||
| properties.defaultCatalog |
작업 영역을 만드는 동안 기본 카탈로그 구성에 대한 속성입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
||
| properties.defaultStorageFirewall |
기본 스토리지 방화벽 구성 정보를 가져오거나 설정합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
||
| properties.encryption |
databricks 작업 영역에 대한 암호화 속성입니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다. |
||
| properties.enhancedSecurityCompliance |
향상된 보안 및 규정 준수 추가 기능과 관련된 설정을 포함합니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다. |
||
| properties.managedDiskIdentity |
Managed Disk Encryption에 사용되는 디스크 암호화 집합의 관리 ID에 대한 세부 정보입니다. 하이브리드 ComputeMode 작업 영역에서만 반환됩니다. |
||
| properties.managedResourceGroupId |
string |
관리되는 리소스 그룹 ID입니다. 하이브리드 ComputeMode 작업 영역에 필요합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| properties.parameters |
작업 영역의 사용자 지정 매개 변수입니다. |
||
| properties.publicNetworkAccess |
작업 영역에 액세스하기 위한 네트워크 액세스 유형입니다. 프라이빗 링크를 통해서만 작업 영역에 액세스하도록 값을 사용하지 않도록 설정합니다. Serverless ComputeMode 작업 공간에서 프론트엔드 전용 프라이빗 링크를 구성할 때 사용되었습니다. |
||
| properties.requiredNsgRules |
프라이빗 엔드포인트를 통해 평면 통신을 제어하는 데이터 평면(클러스터)이 발생하는지 여부를 나타내는 값을 가져오거나 설정합니다. 지원되는 값은 'AllRules' 및 'NoAzureDatabricksRules'입니다. 'NoAzureServiceRules' 값은 내부 전용입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
||
| properties.storageAccountIdentity |
스토리지 계정의 관리 ID에 대한 세부 정보입니다. 하이브리드 ComputeMode 작업 영역에서만 반환됩니다. |
||
| properties.uiDefinitionUri |
string |
UI 정의 파일이 있는 Blob URI입니다. |
|
| properties.updatedBy |
작업 영역을 마지막으로 업데이트한 엔터티의 개체 ID, PUID 및 애플리케이션 ID를 나타냅니다. |
||
| sku |
리소스의 SKU입니다. |
||
| tags |
object |
리소스 태그. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
생성됨 - 프로비전 상태를 포함하여 작업 영역에 대한 정보를 반환합니다. |
|
| 201 Created |
생성됨 - 프로비전 상태를 포함하여 작업 영역에 대한 정보를 반환합니다. |
|
| Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
Create a workspace which is ready for Customer-Managed Key (CMK) encryption
샘플 요청
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"
}
}
샘플 응답
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"sku": {
"name": "premium"
},
"location": "East US 2",
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": null,
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net"
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z"
}
}
Create a workspace with Customer-Managed Key (CMK) encryption for Managed Disks
샘플 요청
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"
}
}
샘플 응답
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update a workspace with Enhanced Security & Compliance Add-On
샘플 요청
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"
}
}
샘플 응답
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"enhancedSecurityCompliance": {
"automaticClusterUpdate": {
"value": "Enabled"
},
"complianceSecurityProfile": {
"value": "Enabled",
"complianceStandards": [
"PCI_DSS",
"HIPAA"
]
},
"enhancedSecurityMonitoring": {
"value": "Enabled"
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2023-08-24T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"enhancedSecurityCompliance": {
"automaticClusterUpdate": {
"value": "Enabled"
},
"complianceSecurityProfile": {
"value": "Enabled",
"complianceStandards": [
"PCI_DSS",
"HIPAA"
]
},
"enhancedSecurityMonitoring": {
"value": "Enabled"
}
},
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2023-08-24T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update serverless workspace
샘플 요청
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"
}
}
샘플 응답
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Serverless",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"defaultCatalog": {
"initialType": "UnityCatalog",
"initialName": ""
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Serverless",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update workspace
샘플 요청
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"
}
}
샘플 응답
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "SystemAssigned"
},
"defaultStorageFirewall": "Enabled",
"parameters": null,
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"defaultCatalog": {
"initialType": "UnityCatalog",
"initialName": ""
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": null,
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "SystemAssigned"
},
"defaultStorageFirewall": "Enabled",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true
}
}
Create or update workspace with custom parameters
샘플 요청
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"
}
}
샘플 응답
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": null,
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"customPrivateSubnetName": {
"type": "String",
"value": "myPrivateSubnet"
},
"customPublicSubnetName": {
"type": "String",
"value": "myPublicSubnet"
},
"customVirtualNetworkId": {
"type": "String",
"value": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myNetwork"
}
},
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "UserAssigned",
"userAssignedIdentityId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"
},
"defaultStorageFirewall": "Enabled",
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"defaultCatalog": {
"initialType": "HiveMetastore",
"initialName": ""
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"isUcEnabled": true,
"accessConnector": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/adbrg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector",
"identityType": "UserAssigned",
"userAssignedIdentityId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"
},
"defaultStorageFirewall": "Enabled",
"defaultCatalog": {
"initialType": "HiveMetastore",
"initialName": ""
}
}
}
Enable Customer-Managed Key (CMK) encryption on a workspace which is prepared for encryption
샘플 요청
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"
}
}
샘플 응답
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"sku": {
"name": "premium"
},
"location": "East US 2",
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"customPrivateSubnetName": {
"type": "String",
"value": "PrivateBob"
},
"customPublicSubnetName": {
"type": "String",
"value": "PublicSarah"
},
"customVirtualNetworkId": {
"type": "String",
"value": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myNetwork"
},
"prepareEncryption": {
"type": "Bool",
"value": true
},
"encryption": {
"type": "Object",
"value": {
"keySource": "Microsoft.Keyvault",
"keyvaulturi": "https://myKeyVault.vault.azure.net/",
"KeyName": "myKeyName",
"keyversion": "00000000000000000000000000000000"
}
}
},
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"isUcEnabled": true
}
}
Revert Customer-Managed Key (CMK) encryption to Microsoft Managed Keys encryption on a workspace
샘플 요청
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"
}
}
샘플 응답
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"sku": {
"name": "premium"
},
"location": "East US 2",
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"parameters": {
"customPrivateSubnetName": {
"type": "String",
"value": "PrivateBob"
},
"customPublicSubnetName": {
"type": "String",
"value": "PublicSarah"
},
"customVirtualNetworkId": {
"type": "String",
"value": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myNetwork"
},
"prepareEncryption": {
"type": "Bool",
"value": true
},
"encryption": {
"type": "Object",
"value": {
"keySource": "Default"
}
}
},
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "5555555555555555",
"workspaceUrl": "adb-5555555555555555.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"name": "myWorkspace",
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"environment": "dev"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"provisioningState": "Accepted",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"storageAccountIdentity": {
"principalId": "55555555-5555-5555-5555-555555555555",
"tenantId": "66666666-6666-6666-6666-666666666666",
"type": "SystemAssigned"
},
"isUcEnabled": true
}
}
Update a workspace with Customer-Managed Key (CMK) encryption for Managed Disks
샘플 요청
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"
}
}
샘플 응답
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"mytag1": "myvalue1"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "6666666666666666",
"workspaceUrl": "adb-6666666666666666.19.azuredatabricks.net",
"isUcEnabled": true
}
}
{
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/workspaces/myWorkspace",
"type": "Microsoft.Databricks/workspaces",
"location": "East US 2",
"tags": {
"mytag1": "myvalue1"
},
"sku": {
"name": "premium"
},
"properties": {
"computeMode": "Hybrid",
"managedResourceGroupId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG",
"diskEncryptionSetId": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myManagedRG/providers/Microsoft.Compute/diskEncryptionSets/myDiskEncryptionSet",
"encryption": {
"entities": {
"managedDisk": {
"keySource": "Microsoft.Keyvault",
"keyVaultProperties": {
"keyVaultUri": "https://test-vault-name.vault.azure.net/",
"keyName": "test-cmk-key",
"keyVersion": "00000000000000000000000000000000"
},
"rotationToLatestKeyVersionEnabled": true
}
}
},
"parameters": null,
"provisioningState": "Succeeded",
"uiDefinitionUri": "https://path/to/workspaceCreateUiDefinition.json",
"authorizations": [
{
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "11111111-1111-1111-1111-111111111111"
}
],
"createdBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"updatedBy": {
"oid": "22222222-2222-2222-2222-222222222222",
"puid": "33333333",
"applicationId": "44444444-4444-4444-4444-444444444444"
},
"managedDiskIdentity": {
"principalId": "22222222-2222-2222-2222-222222222222",
"tenantId": "44444444-4444-4444-4444-444444444444",
"type": "SystemAssigned"
},
"createdDateTime": "2020-02-20T00:10:29.2858439Z",
"workspaceId": "6666666666666666",
"workspaceUrl": "adb-6666666666666666.19.azuredatabricks.net",
"isUcEnabled": true
}
}
정의
| Name | Description |
|---|---|
|
Access |
Databricks 작업 영역과 연결될 커넥터 리소스에 액세스합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
Automatic |
자동화된 클러스터 업데이트 기능의 상태입니다. |
|
Automatic |
|
|
Compliance |
준수 보안 프로필 기능의 상태입니다. |
|
Compliance |
|
|
Compute |
작업 영역 컴퓨팅 모드입니다. 만들 때 필요하며 변경할 수 없습니다. 가능한 값은 'Serverless', 'Hybrid'입니다. |
|
Created |
작업 영역을 생성/업데이트한 엔터티에 대한 세부 정보를 제공합니다. |
|
created |
리소스를 만든 ID의 형식입니다. |
|
Custom |
변수의 유형입니다. |
|
Default |
이러한 속성을 사용하면 작업 영역을 만드는 동안 기본 카탈로그 속성을 지정할 수 있습니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
default |
기본 스토리지 방화벽 구성 정보를 가져오거나 설정합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
| Encryption |
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다. |
|
Encryption |
databricks 작업 영역 리소스에 대한 암호화 엔터티입니다. |
|
Encryption |
암호화 keySource(공급자)입니다. 가능한 값(대/소문자를 구분하지 않습니다): Microsoft.Keyvault |
| EncryptionV2 |
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다. |
|
Enhanced |
향상된 보안 및 규정 준수 추가 기능과 관련된 설정의 상태입니다. |
|
Enhanced |
향상된 보안 모니터링 기능의 상태입니다. |
|
Enhanced |
|
|
Error |
오류 세부 정보입니다. |
|
Error |
오류에 대한 코드 및 메시지입니다. |
|
Error |
오류 응답입니다. |
|
Identity |
Access Connector 리소스의 ID 형식입니다. |
|
initial |
기본 카탈로그의 초기 형식을 정의합니다. 가능한 값(대/소문자를 구분하지 않습니다): HiveMetastore, UnityCatalog |
|
Key |
암호화 keySource(공급자)입니다. 가능한 값(대/소문자를 구분하지 않습니다): 기본값, Microsoft.Keyvault |
|
Key |
암호화에 대한 Key Vault 입력 속성입니다. |
|
Managed |
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다. |
|
Managed |
스토리지 계정에 대한 관리 ID 세부 정보입니다. |
|
Private |
프라이빗 엔드포인트 연결의 프라이빗 엔드포인트 속성입니다. |
|
Private |
작업 영역의 프라이빗 엔드포인트 연결입니다. |
|
Private |
프라이빗 엔드포인트 연결의 속성입니다. |
|
Private |
현재 프로비저닝 상태입니다. |
|
Private |
프라이빗 엔드포인트 연결의 현재 상태입니다. |
|
Private |
프라이빗 엔드포인트 연결의 상태입니다. |
|
Provisioning |
작업 영역의 프로비전 상태입니다. |
|
Public |
작업 영역에 액세스하기 위한 네트워크 액세스 유형입니다. 프라이빗 링크를 통해서만 작업 영역에 액세스하도록 값을 사용하지 않도록 설정합니다. Serverless ComputeMode 작업 공간에서 프론트엔드 전용 프라이빗 링크를 구성할 때 사용되었습니다. |
|
Required |
프라이빗 엔드포인트를 통해 평면 통신을 제어하는 데이터 평면(클러스터)이 발생하는지 여부를 나타내는 값을 가져오거나 설정합니다. 지원되는 값은 'AllRules' 및 'NoAzureDatabricksRules'입니다. 'NoAzureServiceRules' 값은 내부 전용입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
| Sku |
리소스에 대한 SKU입니다. |
|
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
| Workspace |
작업 영역에 대한 정보입니다. |
|
Workspace. |
databricks 작업 영역에 대한 암호화 속성입니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다. |
|
Workspace |
이 필드에 사용해야 하는 값입니다. |
|
Workspace |
이 필드에 사용해야 하는 값입니다. |
|
Workspace |
작업 공간 생성에 사용되는 사용자 지정 매개변수. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
Workspace |
값. |
|
Workspace |
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다. |
|
Workspace |
이 필드에 사용해야 하는 값입니다. |
|
Workspace |
databricks 작업 영역에 대한 암호화 속성입니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다. |
|
Workspace |
작업 영역 공급자 권한 부여입니다. |
AccessConnector
Databricks 작업 영역과 연결될 커넥터 리소스에 액세스합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
Azure Databricks Access Connector 리소스의 리소스 ID입니다. |
| identityType |
Access Connector 리소스의 ID 형식입니다. |
|
| userAssignedIdentityId |
string (arm-id) |
Access Connector 리소스와 연결된 사용자 할당 ID의 리소스 ID입니다. 이는 'UserAssigned' 형식에 필요하며 'SystemAssigned' 형식에는 유효하지 않습니다. |
AutomaticClusterUpdateDefinition
자동화된 클러스터 업데이트 기능의 상태입니다.
| Name | 형식 | Description |
|---|---|---|
| value |
AutomaticClusterUpdateValue
| 값 | Description |
|---|---|
| Enabled | |
| Disabled |
ComplianceSecurityProfileDefinition
준수 보안 프로필 기능의 상태입니다.
| Name | 형식 | Description |
|---|---|---|
| complianceStandards |
string[] |
작업 영역과 연결된 규정 준수 표준입니다. |
| value |
ComplianceSecurityProfileValue
| 값 | Description |
|---|---|
| Enabled | |
| Disabled |
ComputeMode
작업 영역 컴퓨팅 모드입니다. 만들 때 필요하며 변경할 수 없습니다. 가능한 값은 'Serverless', 'Hybrid'입니다.
| 값 | Description |
|---|---|
| Serverless | |
| Hybrid |
CreatedBy
작업 영역을 생성/업데이트한 엔터티에 대한 세부 정보를 제공합니다.
| Name | 형식 | Description |
|---|---|---|
| applicationId |
string (uuid) |
작업 영역 만들기를 시작한 응용 프로그램의 응용 프로그램 ID입니다. 예를 들어 Azure Portal입니다. |
| oid |
string (uuid) |
작업 영역을 만든 개체 ID입니다. |
| puid |
string |
위의 개체 ID에 해당하는 개인 개체 ID |
createdByType
리소스를 만든 ID의 형식입니다.
| 값 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CustomParameterType
변수의 유형입니다.
| 값 | Description |
|---|---|
| Bool | |
| Object | |
| String |
DefaultCatalogProperties
이러한 속성을 사용하면 작업 영역을 만드는 동안 기본 카탈로그 속성을 지정할 수 있습니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다.
| Name | 형식 | Default value | Description |
|---|---|---|---|
| initialName |
string |
기본 카탈로그의 초기 이름을 지정합니다. 지정하지 않으면 작업 영역의 이름이 사용됩니다. |
|
| initialType | HiveMetastore |
기본 카탈로그의 초기 형식을 정의합니다. 가능한 값(대/소문자를 구분하지 않습니다): HiveMetastore, UnityCatalog |
defaultStorageFirewall
기본 스토리지 방화벽 구성 정보를 가져오거나 설정합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다.
| 값 | Description |
|---|---|
| Disabled | |
| Enabled |
Encryption
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다.
| Name | 형식 | Default value | Description |
|---|---|---|---|
| KeyName |
string |
KeyVault 키의 이름입니다. |
|
| keySource | Default |
암호화 keySource(공급자)입니다. 가능한 값(대/소문자를 구분하지 않습니다): 기본값, Microsoft.Keyvault |
|
| keyvaulturi |
string |
KeyVault의 URI입니다. |
|
| keyversion |
string |
KeyVault 키의 버전입니다. |
EncryptionEntitiesDefinition
databricks 작업 영역 리소스에 대한 암호화 엔터티입니다.
| Name | 형식 | Description |
|---|---|---|
| managedDisk |
databricks 관리 디스크에 대한 암호화 속성입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| managedServices |
databricks 관리 서비스에 대한 암호화 속성입니다. Serverless 및 Hybrid ComputeMode 모두에서 지원됩니다. |
EncryptionKeySource
암호화 keySource(공급자)입니다. 가능한 값(대/소문자를 구분하지 않습니다): Microsoft.Keyvault
| 값 | Description |
|---|---|
| Microsoft.Keyvault |
EncryptionV2
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다.
| Name | 형식 | Description |
|---|---|---|
| keySource |
암호화 keySource(공급자)입니다. 가능한 값(대/소문자를 구분하지 않습니다): Microsoft.Keyvault |
|
| keyVaultProperties |
암호화에 대한 Key Vault 입력 속성입니다. |
EnhancedSecurityComplianceDefinition
향상된 보안 및 규정 준수 추가 기능과 관련된 설정의 상태입니다.
| Name | 형식 | Description |
|---|---|---|
| automaticClusterUpdate |
자동화된 클러스터 업데이트 기능의 상태입니다. |
|
| complianceSecurityProfile |
준수 보안 프로필 기능의 상태입니다. |
|
| enhancedSecurityMonitoring |
향상된 보안 모니터링 기능의 상태입니다. |
EnhancedSecurityMonitoringDefinition
향상된 보안 모니터링 기능의 상태입니다.
| Name | 형식 | Description |
|---|---|---|
| value |
EnhancedSecurityMonitoringValue
| 값 | Description |
|---|---|
| Enabled | |
| Disabled |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| code |
string |
오류의 코드입니다. |
| message |
string |
사람이 읽을 수 있는 오류 메시지입니다. |
| target |
string |
요청의 어떤 속성이 오류의 원인이 되는지를 나타냅니다. |
ErrorInfo
오류에 대한 코드 및 메시지입니다.
| Name | 형식 | Description |
|---|---|---|
| code |
string |
기계가 읽을 수 있는 오류 코드입니다. |
| details |
오류 세부 정보. |
|
| innererror |
string |
내부 오류 세부 정보가 있는 경우 |
| message |
string |
사람이 읽을 수 있는 오류 메시지입니다. |
ErrorResponse
오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| error |
오류에 대한 코드 및 메시지입니다. |
IdentityType
Access Connector 리소스의 ID 형식입니다.
| 값 | Description |
|---|---|
| SystemAssigned | |
| UserAssigned |
initialType
기본 카탈로그의 초기 형식을 정의합니다. 가능한 값(대/소문자를 구분하지 않습니다): HiveMetastore, UnityCatalog
| 값 | Description |
|---|---|
| HiveMetastore | |
| UnityCatalog |
KeySource
암호화 keySource(공급자)입니다. 가능한 값(대/소문자를 구분하지 않습니다): 기본값, Microsoft.Keyvault
| 값 | Description |
|---|---|
| Default | |
| Microsoft.Keyvault |
KeyVaultProperties
암호화에 대한 Key Vault 입력 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| keyName |
string |
KeyVault 키의 이름입니다. |
| keyVaultUri |
string |
KeyVault의 URI입니다. |
| keyVersion |
string |
KeyVault 키의 버전입니다. |
ManagedDiskEncryption
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다.
| Name | 형식 | Description |
|---|---|---|
| keySource |
암호화 keySource(공급자)입니다. 가능한 값(대/소문자 구분 안 함): Microsoft.Keyvault. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| keyVaultProperties |
암호화에 대한 Key Vault 입력 속성입니다. |
|
| rotationToLatestKeyVersionEnabled |
boolean |
최신 키 버전을 Managed Disk Encryption에 자동으로 사용할지 여부를 나타냅니다. |
ManagedIdentityConfiguration
스토리지 계정에 대한 관리 ID 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| principalId |
string (uuid) |
Managed Storage 계정에 연결된 관리 ID의 objectId입니다. |
| tenantId |
string (uuid) |
관리 ID가 만들어지는 테넌트 ID입니다. |
| type |
string |
생성된 ID의 유형입니다. SystemAssigned 또는 UserAssigned일 수 있습니다. |
PrivateEndpoint
프라이빗 엔드포인트 연결의 프라이빗 엔드포인트 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
리소스 식별자입니다. |
PrivateEndpointConnection
작업 영역의 프라이빗 엔드포인트 연결입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
리소스 식별자입니다. |
| name |
string |
리소스 이름입니다. |
| properties |
프라이빗 엔드포인트 연결 속성입니다. |
|
| type |
string |
리소스 종류입니다. |
PrivateEndpointConnectionProperties
프라이빗 엔드포인트 연결의 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| groupIds |
string[] |
프라이빗 링크 서비스 리소스의 GroupId입니다. |
| privateEndpoint |
프라이빗 엔드포인트 |
|
| privateLinkServiceConnectionState |
프라이빗 링크 서비스 서비스 연결 상태 |
|
| provisioningState |
프라이빗 엔드포인트 연결의 프로비전 상태입니다. |
PrivateEndpointConnectionProvisioningState
현재 프로비저닝 상태입니다.
| 값 | Description |
|---|---|
| Succeeded | |
| Creating | |
| Updating | |
| Deleting | |
| Failed |
PrivateLinkServiceConnectionState
프라이빗 엔드포인트 연결의 현재 상태입니다.
| Name | 형식 | Description |
|---|---|---|
| actionsRequired |
string |
프라이빗 엔드포인트 연결에 필요한 작업 |
| description |
string |
프라이빗 엔드포인트 연결의 현재 상태에 대한 설명입니다. |
| status |
프라이빗 엔드포인트 연결의 상태입니다. |
PrivateLinkServiceConnectionStatus
프라이빗 엔드포인트 연결의 상태입니다.
| 값 | Description |
|---|---|
| Pending | |
| Approved | |
| Rejected | |
| Disconnected |
ProvisioningState
작업 영역의 프로비전 상태입니다.
| 값 | Description |
|---|---|
| Accepted | |
| Running | |
| Ready | |
| Creating | |
| Created | |
| Deleting | |
| Deleted | |
| Canceled | |
| Failed | |
| Succeeded | |
| Updating |
PublicNetworkAccess
작업 영역에 액세스하기 위한 네트워크 액세스 유형입니다. 프라이빗 링크를 통해서만 작업 영역에 액세스하도록 값을 사용하지 않도록 설정합니다. Serverless ComputeMode 작업 공간에서 프론트엔드 전용 프라이빗 링크를 구성할 때 사용되었습니다.
| 값 | Description |
|---|---|
| Enabled | |
| Disabled |
RequiredNsgRules
프라이빗 엔드포인트를 통해 평면 통신을 제어하는 데이터 평면(클러스터)이 발생하는지 여부를 나타내는 값을 가져오거나 설정합니다. 지원되는 값은 'AllRules' 및 'NoAzureDatabricksRules'입니다. 'NoAzureServiceRules' 값은 내부 전용입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다.
| 값 | Description |
|---|---|
| AllRules | |
| NoAzureDatabricksRules | |
| NoAzureServiceRules |
Sku
리소스에 대한 SKU입니다.
| Name | 형식 | Description |
|---|---|---|
| name |
string |
SKU 이름입니다. |
| tier |
string |
SKU 레벨. |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
| Name | 형식 | Description |
|---|---|---|
| createdAt |
string (date-time) |
리소스 만들기의 타임스탬프(UTC)입니다. |
| createdBy |
string |
리소스를 만든 ID입니다. |
| createdByType |
리소스를 만든 ID의 형식입니다. |
|
| lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
| lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
| lastModifiedByType |
리소스를 마지막으로 수정한 ID의 형식입니다. |
Workspace
작업 영역에 대한 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
리소스가 있는 지리적 위치 |
| name |
string |
리소스의 이름 |
| properties.accessConnector |
Databricks 작업 영역과 연결될 커넥터 리소스에 액세스합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| properties.authorizations |
작업 영역 공급자 권한 부여입니다. |
|
| properties.computeMode |
작업 영역 컴퓨팅 모드입니다. 만들 때 필요하며 변경할 수 없습니다. 가능한 값은 'Serverless', 'Hybrid'입니다. |
|
| properties.createdBy |
작업 영역을 만든 엔터티의 개체 ID, PUID 및 애플리케이션 ID를 나타냅니다. |
|
| properties.createdDateTime |
string (date-time) |
작업공간이 작성되는 날짜와 시간을 지정합니다. |
| properties.defaultCatalog |
작업 영역을 만드는 동안 기본 카탈로그 구성에 대한 속성입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| properties.defaultStorageFirewall |
기본 스토리지 방화벽 구성 정보를 가져오거나 설정합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| properties.diskEncryptionSetId |
string |
관리 디스크 암호화 집합의 리소스 ID입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
| properties.encryption |
databricks 작업 영역에 대한 암호화 속성입니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다. |
|
| properties.enhancedSecurityCompliance |
향상된 보안 및 규정 준수 추가 기능과 관련된 설정을 포함합니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다. |
|
| properties.isUcEnabled |
boolean |
작업 영역에 대해 Unity 카탈로그를 사용하도록 설정했는지 여부를 나타냅니다. Serverless ComputeMode 작업 영역에서 true로 설정합니다. |
| properties.managedDiskIdentity |
Managed Disk Encryption에 사용되는 디스크 암호화 집합의 관리 ID에 대한 세부 정보입니다. 하이브리드 ComputeMode 작업 영역에서만 반환됩니다. |
|
| properties.managedResourceGroupId |
string |
관리되는 리소스 그룹 ID입니다. 하이브리드 ComputeMode 작업 영역에 필요합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
| properties.parameters |
작업 영역의 사용자 지정 매개 변수입니다. |
|
| properties.privateEndpointConnections |
작업 영역에서 생성된 프라이빗 엔드포인트 연결입니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다. |
|
| properties.provisioningState |
작업 영역 프로비저닝 상태입니다. |
|
| properties.publicNetworkAccess |
작업 영역에 액세스하기 위한 네트워크 액세스 유형입니다. 프라이빗 링크를 통해서만 작업 영역에 액세스하도록 값을 사용하지 않도록 설정합니다. Serverless ComputeMode 작업 공간에서 프론트엔드 전용 프라이빗 링크를 구성할 때 사용되었습니다. |
|
| properties.requiredNsgRules |
프라이빗 엔드포인트를 통해 평면 통신을 제어하는 데이터 평면(클러스터)이 발생하는지 여부를 나타내는 값을 가져오거나 설정합니다. 지원되는 값은 'AllRules' 및 'NoAzureDatabricksRules'입니다. 'NoAzureServiceRules' 값은 내부 전용입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| properties.storageAccountIdentity |
스토리지 계정의 관리 ID에 대한 세부 정보입니다. 하이브리드 ComputeMode 작업 영역에서만 반환됩니다. |
|
| properties.uiDefinitionUri |
string |
UI 정의 파일이 있는 Blob URI입니다. |
| properties.updatedBy |
작업 영역을 마지막으로 업데이트한 엔터티의 개체 ID, PUID 및 애플리케이션 ID를 나타냅니다. |
|
| properties.workspaceId |
string |
Databricks 컨트롤 플레인에 있는 Databricks 작업 영역의 고유 식별자입니다. |
| properties.workspaceUrl |
string |
'adb-{workspaceId} 형식의 작업 영역 URL입니다. {무작위}.azuredatabricks.net' |
| sku |
리소스의 SKU입니다. |
|
| systemData |
이 리소스와 관련된 시스템 메타데이터 |
|
| tags |
object |
리소스 태그. |
| type |
string |
리소스의 형식입니다. 예: Microsoft.Compute/virtualMachines 또는 Microsoft.Storage/storageAccounts. |
Workspace.WorkspaceProperties.Encryption
databricks 작업 영역에 대한 암호화 속성입니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다.
| Name | 형식 | Description |
|---|---|---|
| entities |
작업 영역에 대한 암호화 엔터티 정의입니다. |
WorkspaceCustomBooleanParameter
이 필드에 사용해야 하는 값입니다.
| Name | 형식 | Description |
|---|---|---|
| type |
변수의 유형입니다. |
|
| value |
boolean |
이 필드에 사용해야 하는 값입니다. |
WorkspaceCustomObjectParameter
이 필드에 사용해야 하는 값입니다.
| Name | 형식 | Description |
|---|---|---|
| type |
변수의 유형입니다. |
|
| value |
object |
이 필드에 사용해야 하는 값입니다. |
WorkspaceCustomParameters
작업 공간 생성에 사용되는 사용자 지정 매개변수. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다.
| Name | 형식 | Description |
|---|---|---|
| amlWorkspaceId |
Databricks 작업 영역과 연결할 Azure Machine Learning 작업 영역의 ID입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| customPrivateSubnetName |
Virtual Network 내의 프라이빗 서브넷의 이름입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| customPublicSubnetName |
Virtual Network 내의 공용 서브넷의 이름입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| customVirtualNetworkId |
이 Databricks 클러스터를 만들어야 하는 Virtual Network의 ID입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| enableNoPublicIp |
공용 IP를 사용하지 않도록 설정해야 하는지 여부를 나타내는 부울입니다. 기본값은 true입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| encryption |
CMK(Customer-Managed 키) 사용 작업 영역에 대한 암호화 세부 정보가 포함되어 있습니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| loadBalancerBackendPoolName |
보안 클러스터 연결을 위한 아웃바운드 Load Balancer 백 엔드 풀의 이름입니다(공용 IP 없음). Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| loadBalancerId |
보안 클러스터 연결(공용 IP 없음) 작업 영역에 대한 아웃바운드 부하 분산 장치의 리소스 URI입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| natGatewayName |
보안 클러스터 연결(공용 IP 없음) 작업 영역 서브넷에 대한 NAT 게이트웨이의 이름입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| prepareEncryption |
암호화를 위해 작업 영역을 준비합니다. 관리되는 스토리지 계정에 대해 관리 ID를 사용하도록 설정합니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| publicIpName |
관리되는 vNet을 사용하는 공용 IP 작업 영역이 없는 공용 IP의 이름입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| requireInfrastructureEncryption |
미사용 데이터에 대한 플랫폼 관리 키를 사용하여 DBFS 루트 파일 시스템을 보조 암호화 계층으로 사용할 수 있는지 여부를 나타내는 부울입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| resourceTags |
관리되는 리소스 그룹 아래의 리소스에 적용되는 태그입니다. 작업 영역 수준에서 태그를 업데이트하여 업데이트할 수 있습니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| storageAccountName |
기본 DBFS 스토리지 계정 이름입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| storageAccountSkuName |
스토리지 계정 SKU 이름( 예: Standard_GRS, Standard_LRS. 유효한 입력은 https://aka.ms/storageskus 참조하세요. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
|
| vnetAddressPrefix |
관리되는 가상 네트워크에 대한 주소 접두사입니다. 이 입력의 기본값은 10.139입니다. Serverless ComputeMode 작업 영역에서는 허용되지 않습니다. |
WorkspaceCustomStringParameter
값.
| Name | 형식 | Description |
|---|---|---|
| type |
변수의 유형입니다. |
|
| value |
string |
이 필드에 사용해야 하는 값입니다. |
WorkspaceEncryptionParameter
작업 영역에서 사용되는 암호화의 세부 정보가 포함된 개체입니다.
| Name | 형식 | Description |
|---|---|---|
| type |
변수의 유형입니다. |
|
| value |
이 필드에 사용해야 하는 값입니다. |
WorkspaceNoPublicIPBooleanParameter
이 필드에 사용해야 하는 값입니다.
| Name | 형식 | Description |
|---|---|---|
| type |
변수의 유형입니다. |
|
| value |
boolean |
이 필드에 사용해야 하는 값입니다. |
WorkspaceProperties.Encryption
databricks 작업 영역에 대한 암호화 속성입니다. 서버리스 및 하이브리드 ComputeMode 작업 영역 모두에서 지원됩니다.
| Name | 형식 | Description |
|---|---|---|
| entities |
작업 영역에 대한 암호화 엔터티 정의입니다. |
WorkspaceProviderAuthorization
작업 영역 공급자 권한 부여입니다.
| Name | 형식 | Description |
|---|---|---|
| principalId |
string (uuid) |
공급자의 보안 주체 식별자입니다. 공급자가 ARM을 호출하여 작업 영역 리소스를 관리하는 데 사용하는 ID입니다. |
| roleDefinitionId |
string (uuid) |
공급자의 역할 정의 식별자입니다. 이 역할은 공급자가 작업 영역의 컨테이너 리소스 그룹에 대해 가져야 하는 모든 권한을 정의합니다. 이 역할 정의에는 리소스 그룹을 삭제할 수 있는 권한이 없습니다. |