Leggere in inglese

Condividi tramite

Aree di lavoro Microsoft.Synapse 2021-04-01-preview

  • Articolo
Scegliere una lingua di distribuzione

Definizione di risorsa Bicep

Il tipo di risorsa delle aree di lavoro può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Synapse/workspaces, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Synapse/workspaces@2021-04-01-preview' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    connectivityEndpoints: {
      {customized property}: 'string'
    }
    defaultDataLakeStorage: {
      accountUrl: 'string'
      filesystem: 'string'
    }
    encryption: {
      cmk: {
        key: {
          keyVaultUrl: 'string'
          name: 'string'
        }
      }
    }
    managedResourceGroupName: 'string'
    managedVirtualNetwork: 'string'
    managedVirtualNetworkSettings: {
      allowedAadTenantIdsForLinking: [
        'string'
      ]
      linkedAccessCheckOnTargetResource: bool
      preventDataExfiltration: bool
    }
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    purviewConfiguration: {
      purviewResourceId: 'string'
    }
    sqlAdministratorLogin: 'string'
    sqlAdministratorLoginPassword: 'string'
    virtualNetworkProfile: {
      computeSubnetId: 'string'
    }
    workspaceRepositoryConfiguration: {
      accountName: 'string'
      collaborationBranch: 'string'
      hostName: 'string'
      lastCommitId: 'string'
      projectName: 'string'
      repositoryName: 'string'
      rootFolder: 'string'
      tenantId: 'string'
      type: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

CustomerManagedKeyDetails

Nome Descrizione Valore
chiave Oggetto chiave dell'area di lavoro workspaceKeyDetails

DataLakeStorageAccountDetails

Nome Descrizione Valore
accountUrl Account URL corda
file system Nome file system corda

EncryptionDetails

Nome Descrizione Valore
cmk Dettagli chiave gestita dal cliente CustomerManagedKeyDetails

ManagedIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita per l'area di lavoro 'Nessuno'
'SystemAssigned'

ManagedVirtualNetworkSettings

Nome Descrizione Valore
allowedAadTenantIdsForLinking ID tenant Aad consentiti per il collegamento string[]
linkedAccessCheckOnTargetResource Controllo di accesso collegato nella risorsa di destinazione Bool
preventDataExfiltration Impedire l'esfiltrazione di dati Bool

Microsoft.Synapse/workspaces

Nome Descrizione Valore
identità Identità dell'area di lavoro ManagedIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse dell'area di lavoro WorkspaceProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

PrivateEndpoint

Nome Descrizione Valore

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà di connessione dell'endpoint privato. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome Descrizione Valore
privateEndpoint Endpoint privato a cui appartiene la connessione. PrivateEndpoint
privateLinkServiceConnectionState Stato della connessione dell'endpoint privato. PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Nome Descrizione Valore
descrizione Descrizione della connessione al servizio di collegamento privato. corda
stato Stato della connessione al servizio collegamento privato. corda

PurviewConfiguration

Nome Descrizione Valore
purviewResourceId ID risorsa Purview corda

TrackedResourceTags

Nome Descrizione Valore

VirtualNetworkProfile

Nome Descrizione Valore
computeSubnetId ID subnet usato per i calcoli nell'area di lavoro corda

WorkspaceKeyDetails

Nome Descrizione Valore
keyVaultUrl URL dell'insieme di credenziali delle chiavi della chiave secondaria dell'area di lavoro corda
nome Nome della sotto-risorsa chiave dell'area di lavoro corda

WorkspaceProperties

Nome Descrizione Valore
connectivityEndpoints Endpoint di connettività WorkspacePropertiesConnectivityEndpoints
defaultDataLakeStorage Dettagli dell'account data lake storage predefinito dell'area di lavoro DataLakeStorageAccountDetails
codifica Dettagli della crittografia dell'area di lavoro EncryptionDetails
managedResourceGroupName Gruppo di risorse gestite dell'area di lavoro. Il nome del gruppo di risorse identifica in modo univoco il gruppo di risorse all'interno dell'id sottoscrizione utente. Il nome del gruppo di risorse non deve contenere più di 90 caratteri e deve essere composto da caratteri alfanumerici (Char.IsLetterOrDigit()) e '-', '_', '(', ')' e'.'. Si noti che il nome non può terminare con '.' corda
managedVirtualNetwork L'impostazione di questa opzione su "default" garantisce che tutte le risorse di calcolo per questa area di lavoro si trovano in una rete virtuale gestita per conto dell'utente. corda
managedVirtualNetworkSettings Impostazioni della rete virtuale gestita ManagedVirtualNetworkSettings
privateEndpointConnections Connessioni endpoint privato all'area di lavoro PrivateEndpointConnection[]
publicNetworkAccess Abilitare o disabilitare l'accesso alla rete pubblica all'area di lavoro 'Disabilitato'
'Enabled'
purviewConfiguration Configurazione di Purview PurviewConfiguration
sqlAdministratorLogin Account di accesso per l'amministratore di SQL Active Directory dell'area di lavoro corda
sqlAdministratorLoginPassword Password di accesso dell'amministratore SQL corda
virtualNetworkProfile Profilo di rete virtuale VirtualNetworkProfile
workspaceRepositoryConfiguration Impostazioni di integrazione git WorkspaceRepositoryConfiguration

WorkspacePropertiesConnectivityEndpoints

Nome Descrizione Valore

WorkspaceRepositoryConfiguration

Nome Descrizione Valore
accountName Nome account corda
collaborationBranch Ramo di collaborazione corda
hostName Nome host GitHub Enterprise. Ad esempio: https://github.mydomain.com corda
lastCommitId Ultimo ID commit corda
projectName Nome del progetto VSTS corda
repositoryName Nome repository corda
rootFolder Cartella radice da usare nel repository corda
tenantId The VSTS tenant ID corda

Vincoli:
Lunghezza minima = 36
Lunghezza massima = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
digitare Tipo di configurazione repositoryID dell'area di lavoro. Esempio di WorkspaceVSTSConfiguration, WorkspaceGitHubConfiguration corda

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
dell'area di lavoro synapse Modulo di risorse AVM per l'area di lavoro di Synapse

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa delle aree di lavoro può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Synapse/workspaces, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Synapse/workspaces",
  "apiVersion": "2021-04-01-preview",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "connectivityEndpoints": {
      "{customized property}": "string"
    },
    "defaultDataLakeStorage": {
      "accountUrl": "string",
      "filesystem": "string"
    },
    "encryption": {
      "cmk": {
        "key": {
          "keyVaultUrl": "string",
          "name": "string"
        }
      }
    },
    "managedResourceGroupName": "string",
    "managedVirtualNetwork": "string",
    "managedVirtualNetworkSettings": {
      "allowedAadTenantIdsForLinking": [ "string" ],
      "linkedAccessCheckOnTargetResource": "bool",
      "preventDataExfiltration": "bool"
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "purviewConfiguration": {
      "purviewResourceId": "string"
    },
    "sqlAdministratorLogin": "string",
    "sqlAdministratorLoginPassword": "string",
    "virtualNetworkProfile": {
      "computeSubnetId": "string"
    },
    "workspaceRepositoryConfiguration": {
      "accountName": "string",
      "collaborationBranch": "string",
      "hostName": "string",
      "lastCommitId": "string",
      "projectName": "string",
      "repositoryName": "string",
      "rootFolder": "string",
      "tenantId": "string",
      "type": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

CustomerManagedKeyDetails

Nome Descrizione Valore
chiave Oggetto chiave dell'area di lavoro workspaceKeyDetails

DataLakeStorageAccountDetails

Nome Descrizione Valore
accountUrl Account URL corda
file system Nome file system corda

EncryptionDetails

Nome Descrizione Valore
cmk Dettagli chiave gestita dal cliente CustomerManagedKeyDetails

ManagedIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita per l'area di lavoro 'Nessuno'
'SystemAssigned'

ManagedVirtualNetworkSettings

Nome Descrizione Valore
allowedAadTenantIdsForLinking ID tenant Aad consentiti per il collegamento string[]
linkedAccessCheckOnTargetResource Controllo di accesso collegato nella risorsa di destinazione Bool
preventDataExfiltration Impedire l'esfiltrazione di dati Bool

Microsoft.Synapse/workspaces

Nome Descrizione Valore
apiVersion Versione dell'API '2021-04-01-preview'
identità Identità dell'area di lavoro ManagedIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse dell'area di lavoro WorkspaceProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.Synapse/workspaces'

PrivateEndpoint

Nome Descrizione Valore

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà di connessione dell'endpoint privato. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome Descrizione Valore
privateEndpoint Endpoint privato a cui appartiene la connessione. PrivateEndpoint
privateLinkServiceConnectionState Stato della connessione dell'endpoint privato. PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Nome Descrizione Valore
descrizione Descrizione della connessione al servizio di collegamento privato. corda
stato Stato della connessione al servizio collegamento privato. corda

PurviewConfiguration

Nome Descrizione Valore
purviewResourceId ID risorsa Purview corda

TrackedResourceTags

Nome Descrizione Valore

VirtualNetworkProfile

Nome Descrizione Valore
computeSubnetId ID subnet usato per i calcoli nell'area di lavoro corda

WorkspaceKeyDetails

Nome Descrizione Valore
keyVaultUrl URL dell'insieme di credenziali delle chiavi della chiave secondaria dell'area di lavoro corda
nome Nome della sotto-risorsa chiave dell'area di lavoro corda

WorkspaceProperties

Nome Descrizione Valore
connectivityEndpoints Endpoint di connettività WorkspacePropertiesConnectivityEndpoints
defaultDataLakeStorage Dettagli dell'account data lake storage predefinito dell'area di lavoro DataLakeStorageAccountDetails
codifica Dettagli della crittografia dell'area di lavoro EncryptionDetails
managedResourceGroupName Gruppo di risorse gestite dell'area di lavoro. Il nome del gruppo di risorse identifica in modo univoco il gruppo di risorse all'interno dell'id sottoscrizione utente. Il nome del gruppo di risorse non deve contenere più di 90 caratteri e deve essere composto da caratteri alfanumerici (Char.IsLetterOrDigit()) e '-', '_', '(', ')' e'.'. Si noti che il nome non può terminare con '.' corda
managedVirtualNetwork L'impostazione di questa opzione su "default" garantisce che tutte le risorse di calcolo per questa area di lavoro si trovano in una rete virtuale gestita per conto dell'utente. corda
managedVirtualNetworkSettings Impostazioni della rete virtuale gestita ManagedVirtualNetworkSettings
privateEndpointConnections Connessioni endpoint privato all'area di lavoro PrivateEndpointConnection[]
publicNetworkAccess Abilitare o disabilitare l'accesso alla rete pubblica all'area di lavoro 'Disabilitato'
'Enabled'
purviewConfiguration Configurazione di Purview PurviewConfiguration
sqlAdministratorLogin Account di accesso per l'amministratore di SQL Active Directory dell'area di lavoro corda
sqlAdministratorLoginPassword Password di accesso dell'amministratore SQL corda
virtualNetworkProfile Profilo di rete virtuale VirtualNetworkProfile
workspaceRepositoryConfiguration Impostazioni di integrazione git WorkspaceRepositoryConfiguration

WorkspacePropertiesConnectivityEndpoints

Nome Descrizione Valore

WorkspaceRepositoryConfiguration

Nome Descrizione Valore
accountName Nome account corda
collaborationBranch Ramo di collaborazione corda
hostName Nome host GitHub Enterprise. Ad esempio: https://github.mydomain.com corda
lastCommitId Ultimo ID commit corda
projectName Nome del progetto VSTS corda
repositoryName Nome repository corda
rootFolder Cartella radice da usare nel repository corda
tenantId The VSTS tenant ID corda

Vincoli:
Lunghezza minima = 36
Lunghezza massima = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
digitare Tipo di configurazione repositoryID dell'area di lavoro. Esempio di WorkspaceVSTSConfiguration, WorkspaceGitHubConfiguration corda

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
proof-of-concept di Azure Synapse

Distribuire in Azure 		Questo modello crea un ambiente di verifica per Azure Synapse, inclusi pool SQL e pool Apache Spark facoltativi

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa delle aree di lavoro può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Synapse/workspaces, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Synapse/workspaces@2021-04-01-preview"
  name = "string"
  identity = {
    type = "string"
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      connectivityEndpoints = {
        {customized property} = "string"
      }
      defaultDataLakeStorage = {
        accountUrl = "string"
        filesystem = "string"
      }
      encryption = {
        cmk = {
          key = {
            keyVaultUrl = "string"
            name = "string"
          }
        }
      }
      managedResourceGroupName = "string"
      managedVirtualNetwork = "string"
      managedVirtualNetworkSettings = {
        allowedAadTenantIdsForLinking = [
          "string"
        ]
        linkedAccessCheckOnTargetResource = bool
        preventDataExfiltration = bool
      }
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      purviewConfiguration = {
        purviewResourceId = "string"
      }
      sqlAdministratorLogin = "string"
      sqlAdministratorLoginPassword = "string"
      virtualNetworkProfile = {
        computeSubnetId = "string"
      }
      workspaceRepositoryConfiguration = {
        accountName = "string"
        collaborationBranch = "string"
        hostName = "string"
        lastCommitId = "string"
        projectName = "string"
        repositoryName = "string"
        rootFolder = "string"
        tenantId = "string"
        type = "string"
      }
    }
  })
}

Valori delle proprietà

CustomerManagedKeyDetails

Nome Descrizione Valore
chiave Oggetto chiave dell'area di lavoro workspaceKeyDetails

DataLakeStorageAccountDetails

Nome Descrizione Valore
accountUrl Account URL corda
file system Nome file system corda

EncryptionDetails

Nome Descrizione Valore
cmk Dettagli chiave gestita dal cliente CustomerManagedKeyDetails

ManagedIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita per l'area di lavoro 'Nessuno'
'SystemAssigned'

ManagedVirtualNetworkSettings

Nome Descrizione Valore
allowedAadTenantIdsForLinking ID tenant Aad consentiti per il collegamento string[]
linkedAccessCheckOnTargetResource Controllo di accesso collegato nella risorsa di destinazione Bool
preventDataExfiltration Impedire l'esfiltrazione di dati Bool

Microsoft.Synapse/workspaces

Nome Descrizione Valore
identità Identità dell'area di lavoro ManagedIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse dell'area di lavoro WorkspaceProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.Synapse/workspaces@2021-04-01-preview"

PrivateEndpoint

Nome Descrizione Valore

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà di connessione dell'endpoint privato. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome Descrizione Valore
privateEndpoint Endpoint privato a cui appartiene la connessione. PrivateEndpoint
privateLinkServiceConnectionState Stato della connessione dell'endpoint privato. PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Nome Descrizione Valore
descrizione Descrizione della connessione al servizio di collegamento privato. corda
stato Stato della connessione al servizio collegamento privato. corda

PurviewConfiguration

Nome Descrizione Valore
purviewResourceId ID risorsa Purview corda

TrackedResourceTags

Nome Descrizione Valore

VirtualNetworkProfile

Nome Descrizione Valore
computeSubnetId ID subnet usato per i calcoli nell'area di lavoro corda

WorkspaceKeyDetails

Nome Descrizione Valore
keyVaultUrl URL dell'insieme di credenziali delle chiavi della chiave secondaria dell'area di lavoro corda
nome Nome della sotto-risorsa chiave dell'area di lavoro corda

WorkspaceProperties

Nome Descrizione Valore
connectivityEndpoints Endpoint di connettività WorkspacePropertiesConnectivityEndpoints
defaultDataLakeStorage Dettagli dell'account data lake storage predefinito dell'area di lavoro DataLakeStorageAccountDetails
codifica Dettagli della crittografia dell'area di lavoro EncryptionDetails
managedResourceGroupName Gruppo di risorse gestite dell'area di lavoro. Il nome del gruppo di risorse identifica in modo univoco il gruppo di risorse all'interno dell'id sottoscrizione utente. Il nome del gruppo di risorse non deve contenere più di 90 caratteri e deve essere composto da caratteri alfanumerici (Char.IsLetterOrDigit()) e '-', '_', '(', ')' e'.'. Si noti che il nome non può terminare con '.' corda
managedVirtualNetwork L'impostazione di questa opzione su "default" garantisce che tutte le risorse di calcolo per questa area di lavoro si trovano in una rete virtuale gestita per conto dell'utente. corda
managedVirtualNetworkSettings Impostazioni della rete virtuale gestita ManagedVirtualNetworkSettings
privateEndpointConnections Connessioni endpoint privato all'area di lavoro PrivateEndpointConnection[]
publicNetworkAccess Abilitare o disabilitare l'accesso alla rete pubblica all'area di lavoro 'Disabilitato'
'Enabled'
purviewConfiguration Configurazione di Purview PurviewConfiguration
sqlAdministratorLogin Account di accesso per l'amministratore di SQL Active Directory dell'area di lavoro corda
sqlAdministratorLoginPassword Password di accesso dell'amministratore SQL corda
virtualNetworkProfile Profilo di rete virtuale VirtualNetworkProfile
workspaceRepositoryConfiguration Impostazioni di integrazione git WorkspaceRepositoryConfiguration

WorkspacePropertiesConnectivityEndpoints

Nome Descrizione Valore

WorkspaceRepositoryConfiguration

Nome Descrizione Valore
accountName Nome account corda
collaborationBranch Ramo di collaborazione corda
hostName Nome host GitHub Enterprise. Ad esempio: https://github.mydomain.com corda
lastCommitId Ultimo ID commit corda
projectName Nome del progetto VSTS corda
repositoryName Nome repository corda
rootFolder Cartella radice da usare nel repository corda
tenantId The VSTS tenant ID corda

Vincoli:
Lunghezza minima = 36
Lunghezza massima = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
digitare Tipo di configurazione repositoryID dell'area di lavoro. Esempio di WorkspaceVSTSConfiguration, WorkspaceGitHubConfiguration corda

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
dell'area di lavoro synapse Modulo di risorse AVM per l'area di lavoro di Synapse