Big Data Pools - Create Or Update

Riferimento

Servizio:: Synapse

Versione API:: 2021-06-01

Creare un pool di Big Data.
Creare un nuovo pool Big Data.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/bigDataPools/{bigDataPoolName}?api-version=2021-06-01

Con parametri facoltativi:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/bigDataPools/{bigDataPoolName}?api-version=2021-06-01&force={force}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
bigDataPoolName	path	True	string	Nome del pool Big Data
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
workspaceName	path	True	string	Nome dell'area di lavoro.
api-version	query	True	string	Versione dell'API da usare per questa operazione.
force	query		boolean	Se arrestare i processi in esecuzione nel pool Big Data

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.autoPause		AutoPauseProperties	Proprietà di sospensione automatica del pool di Spark Sospensione automatica delle proprietà
properties.autoScale		AutoScaleProperties	Proprietà di ridimensionamento automatico del pool di Spark Proprietà di ridimensionamento automatico
properties.cacheSize		integer	Dimensioni della cache
properties.customLibraries		LibraryInfo[]	Elenco di librerie/pacchetti personalizzati associati al pool di Spark.
properties.defaultSparkLogFolder		string	Cartella predefinita in cui verranno scritti i log di Spark.
properties.dynamicExecutorAllocation		DynamicExecutorAllocation	Allocazione dell'executor dinamico
properties.isAutotuneEnabled		boolean	Abilitare l'ottimizzazione automatica Indica se la regolazione automatica è obbligatoria o meno.
properties.isComputeIsolationEnabled		boolean	Indica se l'isolamento del calcolo è necessario o meno.
properties.libraryRequirements		LibraryRequirements	Requisiti della versione della libreria del pool di Spark Requisiti della versione della libreria
properties.nodeCount		integer	Numero di nodi nel pool Big Data.
properties.nodeSize		NodeSize	Livello di potenza di calcolo di cui ha ogni nodo nel pool Big Data.
properties.nodeSizeFamily		NodeSizeFamily	Tipo di nodi forniti dal pool Big Data.
properties.provisioningState		string	Stato del pool Big Data.
properties.sessionLevelPackagesEnabled		boolean	Indica se i pacchetti a livello di sessione sono abilitati.
properties.sparkConfigProperties		SparkConfigProperties	Proprietà di configurazione del pool di Spark File di configurazione di Spark per specificare proprietà aggiuntive
properties.sparkEventsFolder		string	Cartella eventi Spark
properties.sparkVersion		string	Versione di Apache Spark.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	BigDataPoolResourceInfo	OK
202 Accepted	BigDataPoolResourceInfo
Other Status Codes	ErrorResponse

Esempio

Create or update a Big Data pool

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/01234567-89ab-4def-0123-456789abcdef/resourceGroups/ExampleResourceGroup/providers/Microsoft.Synapse/workspaces/ExampleWorkspace/bigDataPools/ExamplePool?api-version=2021-06-01

{
  "tags": {
    "key": "value"
  },
  "location": "West US 2",
  "properties": {
    "sparkVersion": "3.3",
    "nodeCount": 4,
    "nodeSize": "Medium",
    "nodeSizeFamily": "MemoryOptimized",
    "autoScale": {
      "enabled": true,
      "minNodeCount": 3,
      "maxNodeCount": 50
    },
    "autoPause": {
      "enabled": true,
      "delayInMinutes": 15
    },
    "sparkEventsFolder": "/events",
    "libraryRequirements": {
      "content": "",
      "filename": "requirements.txt"
    },
    "defaultSparkLogFolder": "/logs",
    "isAutotuneEnabled": false
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/01234567-89ab-4def-0123-456789abcdef/resourceGroups/ExampleResourceGroup/providers/Microsoft.Synapse/workspaces/ExampleWorkspace/bigDataPools/ExamplePool",
  "type": "Microsoft.Synapse/workspaces/bigDataPools",
  "location": "West US 2",
  "name": "ExamplePool",
  "tags": {
    "key": "value"
  },
  "properties": {
    "provisioningState": "Provisioning",
    "sparkVersion": "3.3",
    "nodeCount": 4,
    "nodeSize": "Medium",
    "nodeSizeFamily": "MemoryOptimized",
    "autoScale": {
      "enabled": true,
      "minNodeCount": 3,
      "maxNodeCount": 50
    },
    "autoPause": {
      "enabled": true,
      "delayInMinutes": 15
    },
    "creationDate": "1970-01-01T00:00:00Z",
    "sparkEventsFolder": "/events",
    "libraryRequirements": {
      "time": "1970-01-01T00:00:00Z",
      "content": "",
      "filename": "requirements.txt"
    },
    "defaultSparkLogFolder": "/logs",
    "lastSucceededTimestamp": "1970-01-01T10:00:00Z",
    "isAutotuneEnabled": false
  }
}

Codice di stato:: 202

{
  "id": "/subscriptions/01234567-89ab-4def-0123-456789abcdef/resourceGroups/ExampleResourceGroup/providers/Microsoft.Synapse/workspaces/ExampleWorkspace/bigDataPools/ExamplePool",
  "type": "Microsoft.Synapse/workspaces/bigDataPools",
  "location": "West US 2",
  "name": "ExamplePool",
  "tags": {
    "key": "value"
  },
  "properties": {
    "provisioningState": "Provisioning",
    "sparkVersion": "3.3",
    "nodeCount": 4,
    "nodeSize": "Medium",
    "nodeSizeFamily": "MemoryOptimized",
    "autoScale": {
      "enabled": true,
      "minNodeCount": 3,
      "maxNodeCount": 50
    },
    "autoPause": {
      "enabled": true,
      "delayInMinutes": 15
    },
    "creationDate": "1970-01-01T00:00:00Z",
    "sparkEventsFolder": "/events",
    "libraryRequirements": {
      "time": "1970-01-01T00:00:00Z",
      "content": "",
      "filename": "requirements.txt"
    },
    "defaultSparkLogFolder": "/logs",
    "isAutotuneEnabled": false
  }
}

Codice di stato:: default

{
  "error": {
    "code": "Error code",
    "message": "Error message"
  }
}

Definizioni

Nome	Descrizione
AutoPauseProperties	Proprietà di sospensione automatica del pool di Spark
AutoScaleProperties	Proprietà di ridimensionamento automatico del pool di Spark
BigDataPoolResourceInfo	Pool big data
ConfigurationType	Tipo del file delle proprietà di configurazione spark.
DynamicExecutorAllocation	Proprietà di allocazione dell'executor dinamico
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
LibraryInfo	Informazioni su una libreria o un pacchetto creato a livello di area di lavoro.
LibraryRequirements	Requisiti della versione della libreria del pool di Spark
NodeSize	Livello di potenza di calcolo di cui ha ogni nodo nel pool Big Data.
NodeSizeFamily	Tipo di nodi forniti dal pool Big Data.
SparkConfigProperties	Proprietà di configurazione del pool di Spark

AutoPauseProperties

Object

Proprietà di sospensione automatica del pool di Spark

Nome	Tipo	Descrizione
delayInMinutes	integer	Numero di minuti di inattività prima che il pool big data venga sospeso automaticamente.
enabled	boolean	Indica se la sospensione automatica è abilitata per il pool Big Data.

AutoScaleProperties

Object

Proprietà di ridimensionamento automatico del pool di Spark

Nome	Tipo	Descrizione
enabled	boolean	Indica se la scalabilità automatica è abilitata per il pool big data.
maxNodeCount	integer	Il numero massimo di nodi che il pool big data può supportare.
minNodeCount	integer	Il numero minimo di nodi che il pool Big Data può supportare.

BigDataPoolResourceInfo

Object

Pool big data

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.autoPause	AutoPauseProperties	Proprietà di sospensione automatica del pool di Spark Sospensione automatica delle proprietà
properties.autoScale	AutoScaleProperties	Proprietà di ridimensionamento automatico del pool di Spark Proprietà di ridimensionamento automatico
properties.cacheSize	integer	Dimensioni della cache
properties.creationDate	string	Ora di creazione del pool Big Data.
properties.customLibraries	LibraryInfo[]	Elenco di librerie/pacchetti personalizzati associati al pool di Spark.
properties.defaultSparkLogFolder	string	Cartella predefinita in cui verranno scritti i log di Spark.
properties.dynamicExecutorAllocation	DynamicExecutorAllocation	Allocazione dell'executor dinamico
properties.isAutotuneEnabled	boolean	Abilitare l'ottimizzazione automatica Indica se la regolazione automatica è obbligatoria o meno.
properties.isComputeIsolationEnabled	boolean	Indica se l'isolamento del calcolo è necessario o meno.
properties.lastSucceededTimestamp	string	Ora in cui il pool Big Data è stato aggiornato correttamente.
properties.libraryRequirements	LibraryRequirements	Requisiti della versione della libreria del pool di Spark Requisiti della versione della libreria
properties.nodeCount	integer	Numero di nodi nel pool Big Data.
properties.nodeSize	NodeSize	Livello di potenza di calcolo di cui ha ogni nodo nel pool Big Data.
properties.nodeSizeFamily	NodeSizeFamily	Tipo di nodi forniti dal pool Big Data.
properties.provisioningState	string	Stato del pool Big Data.
properties.sessionLevelPackagesEnabled	boolean	Indica se i pacchetti a livello di sessione sono abilitati.
properties.sparkConfigProperties	SparkConfigProperties	Proprietà di configurazione del pool di Spark File di configurazione di Spark per specificare proprietà aggiuntive
properties.sparkEventsFolder	string	Cartella eventi Spark
properties.sparkVersion	string	Versione di Apache Spark.
tags	object	Tag di risorsa.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ConfigurationType

Enumeration

Tipo del file delle proprietà di configurazione spark.

Valore	Descrizione
Artifact
File

DynamicExecutorAllocation

Object

Proprietà di allocazione dell'executor dinamico

Nome	Tipo	Descrizione
enabled	boolean	Indica se l'allocazione dell'executor dinamico è abilitata o meno.
maxExecutors	integer	Numero massimo di executor allocati
minExecutors	integer	Numero minimo di executor allocati

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

LibraryInfo

Object

Informazioni su una libreria o un pacchetto creato a livello di area di lavoro.

Nome	Tipo	Descrizione
containerName	string	Nome del contenitore BLOB di archiviazione.
creatorId	string	ID creatore della libreria/pacchetto.
name	string	Nome della libreria.
path	string	Percorso BLOB di archiviazione della libreria.
provisioningStatus	string	Stato del provisioning della libreria/pacchetto.
type	string	Tipo della libreria.
uploadedTimestamp	string	Ora dell'ultimo aggiornamento della libreria.

LibraryRequirements

Object

Requisiti della versione della libreria del pool di Spark

Nome	Tipo	Descrizione
content	string	Requisiti della libreria.
filename	string	Nome file del file dei requisiti della libreria.
time	string	Ora dell'ultimo aggiornamento del file dei requisiti della libreria.

NodeSize

Enumeration

Livello di potenza di calcolo di cui ha ogni nodo nel pool Big Data.

Valore	Descrizione
Large
Medium
None
Small
XLarge
XXLarge
XXXLarge

NodeSizeFamily

Enumeration

Tipo di nodi forniti dal pool Big Data.

Valore	Descrizione
HardwareAcceleratedFPGA
HardwareAcceleratedGPU
MemoryOptimized
None

SparkConfigProperties

Object

Proprietà di configurazione del pool di Spark

Nome	Tipo	Descrizione
configurationType	ConfigurationType	Tipo del file delle proprietà di configurazione spark.
content	string	Proprietà di configurazione spark.
filename	string	Nome file del file delle proprietà di configurazione spark.
time	string	Ora dell'ultimo aggiornamento del file delle proprietà di configurazione spark.

Condividi tramite

Big Data Pools - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Create or update a Big Data pool

Esempio di richiesta

Risposta di esempio

Definizioni

AutoPauseProperties

AutoScaleProperties

BigDataPoolResourceInfo

ConfigurationType

DynamicExecutorAllocation

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LibraryInfo

LibraryRequirements

NodeSize

NodeSizeFamily

SparkConfigProperties

Risorse aggiuntive