Big Data Pools - Create Or Update

Ссылка

Служба:: Synapse

Версия API:: 2021-06-01

Создайте пул больших данных.
Создайте пул больших данных.

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
bigDataPoolName	path	True	string	Имя пула больших данных
resourceGroupName	path	True	string	Имя группы ресурсов. Имя не учитывает регистр.
subscriptionId	path	True	string	Идентификатор целевой подписки.
workspaceName	path	True	string	Имя рабочей области.
api-version	query	True	string	Версия API, используемая для этой операции.
force	query		boolean	Остановка выполнения заданий в пуле больших данных

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
properties.autoPause		AutoPauseProperties	Свойства автоматического приостановки пула Spark Свойства автоматической приостановки
properties.autoScale		AutoScaleProperties	Свойства автоматического масштабирования пула Spark Свойства автоматического масштабирования
properties.cacheSize		integer	Размер кэша
properties.customLibraries		LibraryInfo[]	Список пользовательских библиотек и пакетов, связанных с пулом Spark.
properties.defaultSparkLogFolder		string	Папка по умолчанию, в которой будут записываться журналы Spark.
properties.dynamicExecutorAllocation		DynamicExecutorAllocation	Динамическое выделение исполнителя
properties.isAutotuneEnabled		boolean	Включение Autotune Требуется ли автозапуск.
properties.isComputeIsolationEnabled		boolean	Требуется ли изоляция вычислений.
properties.libraryRequirements		LibraryRequirements	Требования к версии библиотеки пула Spark Требования к версии библиотеки
properties.nodeCount		integer	Количество узлов в пуле больших данных.
properties.nodeSize		NodeSize	Уровень вычислительной мощности каждого узла в пуле больших данных.
properties.nodeSizeFamily		NodeSizeFamily	Тип узлов, которые предоставляет пул больших данных.
properties.provisioningState		string	Состояние пула больших данных.
properties.sessionLevelPackagesEnabled		boolean	Включен ли пакет уровня сеанса.
properties.sparkConfigProperties		SparkConfigProperties	Свойства конфигурации пула Spark Файл конфигурации Spark для указания дополнительных свойств
properties.sparkEventsFolder		string	Папка событий Spark
properties.sparkVersion		string	Версия Apache Spark.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	BigDataPoolResourceInfo	ХОРОШО
202 Accepted	BigDataPoolResourceInfo
Other Status Codes	ErrorResponse

Примеры

Create or update a Big Data pool

Образец запроса

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

Пример ответа

Код состояния:: 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
  }
}

Код состояния:: 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
  }
}

Код состояния:: default

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

Определения

Имя	Описание
AutoPauseProperties	Свойства автоматического приостановки пула Spark
AutoScaleProperties	Свойства автоматического масштабирования пула Spark
BigDataPoolResourceInfo	Пул больших данных
ConfigurationType	Тип файла свойств конфигурации Spark.
DynamicExecutorAllocation	Свойства динамического выделения исполнителя
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
LibraryInfo	Сведения о библиотеке или пакете, созданном на уровне рабочей области.
LibraryRequirements	Требования к версии библиотеки пула Spark
NodeSize	Уровень вычислительной мощности каждого узла в пуле больших данных.
NodeSizeFamily	Тип узлов, которые предоставляет пул больших данных.
SparkConfigProperties	Свойства конфигурации пула Spark

AutoPauseProperties

Object

Свойства автоматического приостановки пула Spark

Имя	Тип	Описание
delayInMinutes	integer	Количество минут простоя до автоматической приостановки пула больших данных.
enabled	boolean	Включена ли автоматическая приостановка для пула больших данных.

AutoScaleProperties

Object

Свойства автоматического масштабирования пула Spark

Имя	Тип	Описание
enabled	boolean	Включена ли автоматическая масштабирование для пула больших данных.
maxNodeCount	integer	Максимальное количество узлов пула больших данных может поддерживаться.
minNodeCount	integer	Минимальное количество узлов пула больших данных может поддерживаться.

BigDataPoolResourceInfo

Object

Пул больших данных

Имя	Тип	Описание
id	string	Полный идентификатор ресурса для ресурса. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.autoPause	AutoPauseProperties	Свойства автоматического приостановки пула Spark Свойства автоматической приостановки
properties.autoScale	AutoScaleProperties	Свойства автоматического масштабирования пула Spark Свойства автоматического масштабирования
properties.cacheSize	integer	Размер кэша
properties.creationDate	string	Время создания пула больших данных.
properties.customLibraries	LibraryInfo[]	Список пользовательских библиотек и пакетов, связанных с пулом Spark.
properties.defaultSparkLogFolder	string	Папка по умолчанию, в которой будут записываться журналы Spark.
properties.dynamicExecutorAllocation	DynamicExecutorAllocation	Динамическое выделение исполнителя
properties.isAutotuneEnabled	boolean	Включение Autotune Требуется ли автозапуск.
properties.isComputeIsolationEnabled	boolean	Требуется ли изоляция вычислений.
properties.lastSucceededTimestamp	string	Время успешного обновления пула больших данных.
properties.libraryRequirements	LibraryRequirements	Требования к версии библиотеки пула Spark Требования к версии библиотеки
properties.nodeCount	integer	Количество узлов в пуле больших данных.
properties.nodeSize	NodeSize	Уровень вычислительной мощности каждого узла в пуле больших данных.
properties.nodeSizeFamily	NodeSizeFamily	Тип узлов, которые предоставляет пул больших данных.
properties.provisioningState	string	Состояние пула больших данных.
properties.sessionLevelPackagesEnabled	boolean	Включен ли пакет уровня сеанса.
properties.sparkConfigProperties	SparkConfigProperties	Свойства конфигурации пула Spark Файл конфигурации Spark для указания дополнительных свойств
properties.sparkEventsFolder	string	Папка событий Spark
properties.sparkVersion	string	Версия Apache Spark.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ConfigurationType

Enumeration

Тип файла свойств конфигурации Spark.

Значение	Описание
Artifact
File

DynamicExecutorAllocation

Object

Свойства динамического выделения исполнителя

Имя	Тип	Описание
enabled	boolean	Указывает, включена ли динамическое выделение исполнителя.
maxExecutors	integer	Максимальное количество исполнителей, вычисленное
minExecutors	integer	Минимальное количество исполнителей, вычисленное

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

LibraryInfo

Object

Сведения о библиотеке или пакете, созданном на уровне рабочей области.

Имя	Тип	Описание
containerName	string	Имя контейнера BLOB-объектов хранилища.
creatorId	string	Идентификатор создателя библиотеки или пакета.
name	string	Имя библиотеки.
path	string	Путь к BLOB-объектам хранилища библиотеки.
provisioningStatus	string	Состояние подготовки библиотеки или пакета.
type	string	Тип библиотеки.
uploadedTimestamp	string	Время последнего обновления библиотеки.

LibraryRequirements

Object

Требования к версии библиотеки пула Spark

Имя	Тип	Описание
content	string	Требования к библиотеке.
filename	string	Имя файла требований к библиотеке.
time	string	Время последнего обновления файла требований к библиотеке.

NodeSize

Enumeration

Уровень вычислительной мощности каждого узла в пуле больших данных.

Значение	Описание
Large
Medium
None
Small
XLarge
XXLarge
XXXLarge

NodeSizeFamily

Enumeration

Тип узлов, которые предоставляет пул больших данных.

Значение	Описание
HardwareAcceleratedFPGA
HardwareAcceleratedGPU
MemoryOptimized
None

SparkConfigProperties

Object

Свойства конфигурации пула Spark

Имя	Тип	Описание
configurationType	ConfigurationType	Тип файла свойств конфигурации Spark.
content	string	Свойства конфигурации Spark.
filename	string	Имя файла свойств конфигурации Spark.
time	string	Время последнего обновления файла свойств конфигурации Spark.

Поделиться через

Big Data Pools - Create Or Update

Параметры URI

Текст запроса

Ответы

Примеры

Create or update a Big Data pool

Образец запроса

Пример ответа

Определения

AutoPauseProperties

AutoScaleProperties

BigDataPoolResourceInfo

ConfigurationType

DynamicExecutorAllocation

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LibraryInfo

LibraryRequirements

NodeSize

NodeSizeFamily

SparkConfigProperties

Дополнительные ресурсы