Big Data Pools - Create Or Update

Referentie

Service:: Synapse

API-versie:: 2021-06-01

Maak een Big Data-pool.
Maak een nieuwe Big Data-pool.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
bigDataPoolName	path	True	string	Naam van big data-pool
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId	path	True	string	De id van het doelabonnement.
workspaceName	path	True	string	De naam van de werkruimte.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.
force	query		boolean	Of u actieve taken in de big data-pool wilt stoppen

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
properties.autoPause		AutoPauseProperties	Eigenschappen voor automatisch onderbreken van Spark-pool Eigenschappen voor automatisch onderbreken
properties.autoScale		AutoScaleProperties	Eigenschappen voor automatisch schalen van Spark-pools Eigenschappen voor automatisch schalen
properties.cacheSize		integer	De cachegrootte
properties.customLibraries		LibraryInfo[]	Lijst met aangepaste bibliotheken/pakketten die zijn gekoppeld aan de Spark-pool.
properties.defaultSparkLogFolder		string	De standaardmap waarin Spark-logboeken worden geschreven.
properties.dynamicExecutorAllocation		DynamicExecutorAllocation	Dynamische uitvoerdertoewijzing
properties.isAutotuneEnabled		boolean	Autotune inschakelen Of autotune vereist is of niet.
properties.isComputeIsolationEnabled		boolean	Of rekenisolatie vereist is of niet.
properties.libraryRequirements		LibraryRequirements	Versievereisten voor Spark-poolbibliotheek Vereisten voor bibliotheekversie
properties.nodeCount		integer	Het aantal knooppunten in de big data-pool.
properties.nodeSize		NodeSize	Het rekenvermogen dat elk knooppunt in de big data-pool heeft.
properties.nodeSizeFamily		NodeSizeFamily	Het soort knooppunten dat de big data-pool biedt.
properties.provisioningState		string	De status van de big data-pool.
properties.sessionLevelPackagesEnabled		boolean	Of pakketten op sessieniveau zijn ingeschakeld.
properties.sparkConfigProperties		SparkConfigProperties	Configuratie-eigenschappen van Spark-pool Spark-configuratiebestand voor het opgeven van aanvullende eigenschappen
properties.sparkEventsFolder		string	De map Spark-gebeurtenissen
properties.sparkVersion		string	De Apache Spark-versie.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	BigDataPoolResourceInfo	OK
202 Accepted	BigDataPoolResourceInfo
Other Status Codes	ErrorResponse

Voorbeelden

Create or update a Big Data pool

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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
  }
}

Statuscode:: 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
  }
}

Statuscode:: default

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

Definities

Name	Description
AutoPauseProperties	Eigenschappen voor automatisch onderbreken van Spark-pool
AutoScaleProperties	Eigenschappen voor automatisch schalen van Spark-pools
BigDataPoolResourceInfo	Big Data-pool
ConfigurationType	Het type van het bestand met spark-configuratie-eigenschappen.
DynamicExecutorAllocation	Eigenschappen van dynamische uitvoerdertoewijzing
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
LibraryInfo	Informatie over een bibliotheek/pakket dat op werkruimteniveau is gemaakt.
LibraryRequirements	Versievereisten voor Spark-poolbibliotheek
NodeSize	Het rekenvermogen dat elk knooppunt in de big data-pool heeft.
NodeSizeFamily	Het soort knooppunten dat de big data-pool biedt.
SparkConfigProperties	Configuratie-eigenschappen van Spark-pool

AutoPauseProperties

Eigenschappen voor automatisch onderbreken van Spark-pool

Name	Type	Description
delayInMinutes	integer	Aantal minuten niet-actieve tijd voordat de big data-pool automatisch wordt onderbroken.
enabled	boolean	Of automatisch onderbreken is ingeschakeld voor de big data-pool.

AutoScaleProperties

Eigenschappen voor automatisch schalen van Spark-pools

Name	Type	Description
enabled	boolean	Of automatisch schalen is ingeschakeld voor de big data-pool.
maxNodeCount	integer	Het maximum aantal knooppunten dat de big data-pool kan ondersteunen.
minNodeCount	integer	Het minimale aantal knooppunten dat de big data-pool kan ondersteunen.

BigDataPoolResourceInfo

Big Data-pool

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.autoPause	AutoPauseProperties	Eigenschappen voor automatisch onderbreken van Spark-pool Eigenschappen voor automatisch onderbreken
properties.autoScale	AutoScaleProperties	Eigenschappen voor automatisch schalen van Spark-pools Eigenschappen voor automatisch schalen
properties.cacheSize	integer	De cachegrootte
properties.creationDate	string	De tijd waarop de big data-pool is gemaakt.
properties.customLibraries	LibraryInfo[]	Lijst met aangepaste bibliotheken/pakketten die zijn gekoppeld aan de Spark-pool.
properties.defaultSparkLogFolder	string	De standaardmap waarin Spark-logboeken worden geschreven.
properties.dynamicExecutorAllocation	DynamicExecutorAllocation	Dynamische uitvoerdertoewijzing
properties.isAutotuneEnabled	boolean	Autotune inschakelen Of autotune vereist is of niet.
properties.isComputeIsolationEnabled	boolean	Of rekenisolatie vereist is of niet.
properties.lastSucceededTimestamp	string	Het tijdstip waarop de big data-pool is bijgewerkt.
properties.libraryRequirements	LibraryRequirements	Versievereisten voor Spark-poolbibliotheek Vereisten voor bibliotheekversie
properties.nodeCount	integer	Het aantal knooppunten in de big data-pool.
properties.nodeSize	NodeSize	Het rekenvermogen dat elk knooppunt in de big data-pool heeft.
properties.nodeSizeFamily	NodeSizeFamily	Het soort knooppunten dat de big data-pool biedt.
properties.provisioningState	string	De status van de big data-pool.
properties.sessionLevelPackagesEnabled	boolean	Of pakketten op sessieniveau zijn ingeschakeld.
properties.sparkConfigProperties	SparkConfigProperties	Configuratie-eigenschappen van Spark-pool Spark-configuratiebestand voor het opgeven van aanvullende eigenschappen
properties.sparkEventsFolder	string	De map Spark-gebeurtenissen
properties.sparkVersion	string	De Apache Spark-versie.
tags	object	Resourcetags.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ConfigurationType

Het type van het bestand met spark-configuratie-eigenschappen.

Name	Type	Description
Artifact	string
File	string

DynamicExecutorAllocation

Eigenschappen van dynamische uitvoerdertoewijzing

Name	Type	Description
enabled	boolean	Geeft aan of dynamische uitvoerdertoewijzing is ingeschakeld of niet.
maxExecutors	integer	Het maximum aantal uitvoerders dat is toegewezen
minExecutors	integer	Het minimum aantal uitvoerders dat is toegewezen

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

LibraryInfo

Informatie over een bibliotheek/pakket dat op werkruimteniveau is gemaakt.

Name	Type	Description
containerName	string	Naam van opslagblobcontainer.
creatorId	string	Creator-id van de bibliotheek/het pakket.
name	string	Naam van de bibliotheek.
path	string	Opslagblobpad van bibliotheek.
provisioningStatus	string	Inrichtingsstatus van de bibliotheek/het pakket.
type	string	Type bibliotheek.
uploadedTimestamp	string	De laatste updatetijd van de bibliotheek.

LibraryRequirements

Versievereisten voor Spark-poolbibliotheek

Name	Type	Description
content	string	De bibliotheekvereisten.
filename	string	De bestandsnaam van het bestand met bibliotheekvereisten.
time	string	De laatste updatetijd van het bestand met bibliotheekvereisten.

NodeSize

Het rekenvermogen dat elk knooppunt in de big data-pool heeft.

Name	Type	Description
Large	string
Medium	string
None	string
Small	string
XLarge	string
XXLarge	string
XXXLarge	string

NodeSizeFamily

Het soort knooppunten dat de big data-pool biedt.

Name	Type	Description
HardwareAcceleratedFPGA	string
HardwareAcceleratedGPU	string
MemoryOptimized	string
None	string

SparkConfigProperties

Configuratie-eigenschappen van Spark-pool

Name	Type	Description
configurationType	ConfigurationType	Het type van het bestand met spark-configuratie-eigenschappen.
content	string	De spark-configuratie-eigenschappen.
filename	string	De bestandsnaam van het bestand met spark-configuratie-eigenschappen.
time	string	De laatste updatetijd van het spark-configuratie-eigenschappenbestand.

Delen via