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


Elastic Pools - Create Or Update

Создает или обновляет эластичный пул.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01

Параметры URI

Имя В Обязательно Тип Описание
elasticPoolName
path True

string

Имя эластичного пула.

resourceGroupName
path True

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.

serverName
path True

string

Имя сервера.

subscriptionId
path True

string

Идентификатор подписки Azure.

api-version
query True

string

Версия API для использования в запросе.

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

Имя Обязательно Тип Описание
location True

string

Расположение ресурса.

properties.highAvailabilityReplicaCount

integer

Количество вторичных реплик, связанных с эластичным пулом, которые используются для обеспечения высокого уровня доступности. Применимо только к эластичным пулам с гипермасштабированием.

properties.licenseType

ElasticPoolLicenseType

Тип лицензии, применяемой для этого эластичного пула.

properties.maintenanceConfigurationId

string

Идентификатор конфигурации обслуживания, назначенный эластичному пулу. Эта конфигурация определяет период, когда будут выполняться обновления обслуживания.

properties.maxSizeBytes

integer

Ограничение хранилища для эластичного пула базы данных в байтах.

properties.minCapacity

number

Минимальная емкость бессерверного пула не будет уменьшаться ниже, если она не приостановлена

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Параметры базы данных для эластичного пула.

properties.zoneRedundant

boolean

Является ли этот эластичный пул избыточным между зонами. Это означает, что реплики этого эластичного пула будут распределены между несколькими зонами доступности.

sku

Sku

Номер SKU эластичного пула.

Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для подписки в регионе Azure, используйте Capabilities_ListByLocation REST API или следующую команду:

az sql elastic-pool list-editions -l <location> -o table
tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

ElasticPool

Обновлен эластичный пул

201 Created

ElasticPool

Создание эластичного пула

202 Accepted

Принято

Other Status Codes

Ответы на ошибки: ***

  • 400 ElasticPoolOverStorageUsage — попытка записи данных в базу данных при достижении ограничения хранилища эластичного пула.

  • 400 InvalidSku — пользователь указал недопустимый номер SKU.

  • 400 InvalidTierSkuCombination — указанный уровень не поддерживает указанный SKU.

  • 400 ServerQuotaExceededed — сервер достиг предела допустимой пропускной способности базы данных.

  • 400 ElasticPoolAlreadyExists — сервер уже содержит эластичный пул с указанным именем.

  • 400 SubscriptionVcoreQuotaExceededed — не удалось выполнить операцию, так как подписка превысит допустимую квоту на виртуальные ядра.

  • 400 InvalidInputValueForEdition — указанный выпуск не поддерживается для подготовки эластичных пулов.

  • 400 ElasticPoolDtuBelowLimit — запрошенное значение DTU слишком низко для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDtuAboveLimit — запрошенное значение DTU слишком велико для запрошенного уровня служб эластичного пула.

  • 400 InvalidMaxSize — недопустимый максимальный размер.

  • 400 ElasticPoolDbDtuMaxBelowLimit — запрошенное максимальное число DTU базы данных слишком мало для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDbDtuMaxAboveLimit — запрошенное максимальное значение DTU базы данных слишком велико для запрошенного уровня служб эластичного пула.

  • 400 InvalidInputValueForDatabaseDtuMax — попытка задать максимальное значение DTU на базу данных для пула ресурсов, которое не соответствует допустимым значениям.

  • 400 ElasticPoolDbDtuMinAboveLimit — запрошенный минимум DTU на базу данных слишком высок для запрошенного уровня служб.

  • 400 ElasticPoolOverStorage — попытка записи данных в базу данных при достижении ограничения хранилища эластичного пула.

  • 400 InvalidInputValueForDatabaseDtuMin — попытка задать минимальное значение DTU для каждой базы данных для пула ресурсов, который не соответствует допустимым значениям.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings — попытка указать минимальное значение DTU для баз данных в эластичном пуле, превышающих запрошенные DTU эластичного пула.

  • 400 ElasticPoolDtuUnsupported — пользователь пытался создать или обновить эластичный пул с емкостью DTU, которая не поддерживается.

  • 400 ElasticPoolStorageAboveLimitGB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 ElasticPoolsNotEnabled — пулы эластичных баз данных не включены в этом регионе.

  • 400 ElasticPoolNotEmpty — запрос на удаление эластичного пула, который не является пустым.

  • 400 ElasticPoolStorageBelowLimitGB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 ElasticPoolStorageNotAllowedGB — попытка установить ограничение хранилища эластичного пула в ГБ, которое не соответствует допустимым значениям.

  • 400 ElasticPoolDatabaseLimit — эластичный пул достиг предельного количества баз данных.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage — попытка уменьшить ограничение хранилища эластичного пула ниже его использования хранилища.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax — попытка установить минимальное значение DTU для базы данных, превышающее максимальное значение DTU для каждой базы данных.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings — количество баз данных и минимальное количество виртуальных ядер на базу данных не может превышать запрошенные виртуальные ядра эластичного пула.

  • 400 ElasticPoolStorageBelowLimitMB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 ElasticPoolStorageNotAllowedMB — попытка установить ограничение хранилища эластичного пула в мб, которое не соответствует допустимым значениям.

  • 400 ElasticPoolCapacityStorageNotAllowedMB — попытка задать ограничение хранилища эластичного пула в мб, которое не соответствует допустимым значениям.

  • 400 ElasticPoolStorageAboveLimitMB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 RegionDoesNotSupportVersion — пользователь пытался создать сервер указанной версии в расположении, где эта версия сервера не поддерживается.

  • 400 InvalidTier — пользователь указал недопустимый уровень.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded — база данных-источник не может иметь более высокий выпуск, чем целевая база данных.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded — целевая база данных не может иметь более низкий выпуск, чем исходная база данных.

  • 400 ElasticPoolUpdateHkNotAllowed — эластичный пул не может понизить уровень служб с уровня "Премиум" до уровня "Стандартный" или "Базовый", так как одна или несколько баз данных используют объекты, оптимизированные для памяти.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress — операция запрещена, так как операция копирования или отработки отказа для базы данных "{0}" на сервере "{1}" в настоящее время выполняется.

  • 400 RegionDoesNotAllowProvisioning — выбранное расположение не принимает новые серверы Windows Azure SQL Database. Позже это может измениться.

  • 400 ElasticPoolOverFileSpace — недостаточно места для файлов в эластичном пуле.

  • 400 ElasticPoolDbDtuMinBelowLimit — запрошенный минимум DTU базы данных слишком низок для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDbVcoreMaxBelowLimit — запрошенное максимальное количество виртуальных ядер базы данных слишком мало для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDbVcoreMaxAboveLimit — запрошенное максимальное количество виртуальных ядер базы данных слишком велико для запрошенного уровня служб эластичного пула.

  • 400 InvalidInputValueForDatabaseVcoreMax — попытка задать максимальное число виртуальных ядер для каждой базы данных для пула ресурсов, который не соответствует допустимым значениям.

  • 400 ElasticPoolDbVcoreMinBelowLimit — запрошенный минимум виртуального ядра базы данных слишком низок для запрошенного уровня служб эластичного пула.

  • 400 InvalidInputValueForDatabaseVcoreMin — попытка задать минимальное количество виртуальных ядер на базу данных для пула ресурсов, который не соответствует допустимым значениям.

  • 400 PartnerDBNotCompatibleForSGXEnclave — попытка задать ссылку GeoDR или обновить SLO для базы данных с поддержкой анклава поддерживается только в том случае, если обе базы данных работают на оборудовании серии DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax — попытка установить минимальное значение виртуального ядра на базу данных, превышающее максимальное число виртуальных ядер на базу данных.

  • 400 InvalidLicenseType — пользователь пытался создать или обновить базу данных или эластичные пулы с неподдерживаемой лицензией.

  • 400 ProvisioningDisabled — отображает сообщение об ошибке от авторизации операции ресурсов без изменений.

  • 400 InvalidPublicMaintenanceConfiguration — пользователь попытался указать общедоступную конфигурацию обслуживания, которая не может быть преобразована во внутренний идентификатор (неправильно сформированный или неправильный регион).

  • 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы.

  • 400 InvalidResourceId — недопустимый идентификатор ресурса.

  • 400 InvalidSkuName — недопустимое имя SKU.

  • 400 MismatchedSkuNameAndCapacity — несоответствие между именем SKU и емкостью.

  • 400 MismatchedSkuNameAndTier — несоответствие между именем SKU и уровнем.

  • 400 MismatchedSkuNameAndFamily — несоответствие между именем SKU и семейством.

  • 400 MismatchingSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе.

  • 400 ElasticPoolOverStorageUsage — попытка записи данных в базу данных при достижении ограничения хранилища эластичного пула.

  • 400 InvalidSku — пользователь указал недопустимый номер SKU.

  • 400 InvalidTierSkuCombination — указанный уровень не поддерживает указанный SKU.

  • 400 ServerQuotaExceededed — сервер достиг предела допустимой пропускной способности базы данных.

  • 400 ElasticPoolAlreadyExists — сервер уже содержит эластичный пул с указанным именем.

  • 400 SubscriptionVcoreQuotaExceededed — не удалось выполнить операцию, так как подписка превысит допустимую квоту на виртуальные ядра.

  • 400 InvalidInputValueForEdition — указанный выпуск не поддерживается для подготовки эластичных пулов.

  • 400 ElasticPoolDtuBelowLimit — запрошенное значение DTU слишком низко для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDtuAboveLimit — запрошенное значение DTU слишком велико для запрошенного уровня служб эластичного пула.

  • 400 InvalidMaxSize — недопустимый максимальный размер.

  • 400 ElasticPoolDbDtuMaxBelowLimit — запрошенное максимальное число DTU базы данных слишком мало для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDbDtuMaxAboveLimit — запрошенное максимальное значение DTU базы данных слишком велико для запрошенного уровня служб эластичного пула.

  • 400 InvalidInputValueForDatabaseDtuMax — попытка задать максимальное значение DTU на базу данных для пула ресурсов, которое не соответствует допустимым значениям.

  • 400 ElasticPoolDbDtuMinAboveLimit — запрошенный минимум DTU на базу данных слишком высок для запрошенного уровня служб.

  • 400 ElasticPoolOverStorage — попытка записи данных в базу данных при достижении ограничения хранилища эластичного пула.

  • 400 InvalidInputValueForDatabaseDtuMin — попытка задать минимальное значение DTU для каждой базы данных для пула ресурсов, который не соответствует допустимым значениям.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings — попытка указать минимальное значение DTU для баз данных в эластичном пуле, превышающих запрошенные DTU эластичного пула.

  • 400 ElasticPoolDtuUnsupported — пользователь пытался создать или обновить эластичный пул с емкостью DTU, которая не поддерживается.

  • 400 ElasticPoolStorageAboveLimitGB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 ElasticPoolsNotEnabled — пулы эластичных баз данных не включены в этом регионе.

  • 400 ElasticPoolNotEmpty — запрос на удаление эластичного пула, который не является пустым.

  • 400 ElasticPoolStorageBelowLimitGB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 ElasticPoolStorageNotAllowedGB — попытка установить ограничение хранилища эластичного пула в ГБ, которое не соответствует допустимым значениям.

  • 400 ElasticPoolDatabaseLimit — эластичный пул достиг предельного количества баз данных.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage — попытка уменьшить ограничение хранилища эластичного пула ниже его использования хранилища.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax — попытка установить минимальное значение DTU для базы данных, превышающее максимальное значение DTU для каждой базы данных.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings — количество баз данных и минимальное количество виртуальных ядер на базу данных не может превышать запрошенные виртуальные ядра эластичного пула.

  • 400 ElasticPoolStorageBelowLimitMB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 ElasticPoolStorageNotAllowedMB — попытка установить ограничение хранилища эластичного пула в мб, которое не соответствует допустимым значениям.

  • 400 ElasticPoolCapacityStorageNotAllowedMB — попытка задать ограничение хранилища эластичного пула в мб, которое не соответствует допустимым значениям.

  • 400 ElasticPoolStorageAboveLimitMB — попытка установить ограничение хранилища эластичного пула ниже поддерживаемого ограничения.

  • 400 RegionDoesNotSupportVersion — пользователь пытался создать сервер указанной версии в расположении, где эта версия сервера не поддерживается.

  • 400 InvalidTier — пользователь указал недопустимый уровень.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded — база данных-источник не может иметь более высокий выпуск, чем целевая база данных.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded — целевая база данных не может иметь более низкий выпуск, чем исходная база данных.

  • 400 ElasticPoolUpdateHkNotAllowed — эластичный пул не может понизить уровень служб с уровня "Премиум" до уровня "Стандартный" или "Базовый", так как одна или несколько баз данных используют объекты, оптимизированные для памяти.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress — операция запрещена, так как операция копирования или отработки отказа для базы данных "{0}" на сервере "{1}" в настоящее время выполняется.

  • 400 RegionDoesNotAllowProvisioning — выбранное расположение не принимает новые серверы Windows Azure SQL Database. Позже это может измениться.

  • 400 ElasticPoolOverFileSpace — недостаточно места для файлов в эластичном пуле.

  • 400 ElasticPoolDbDtuMinBelowLimit — запрошенный минимум DTU базы данных слишком низок для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDbVcoreMaxBelowLimit — запрошенное максимальное количество виртуальных ядер базы данных слишком мало для запрошенного уровня служб эластичного пула.

  • 400 ElasticPoolDbVcoreMaxAboveLimit — запрошенное максимальное количество виртуальных ядер базы данных слишком велико для запрошенного уровня служб эластичного пула.

  • 400 InvalidInputValueForDatabaseVcoreMax — попытка задать максимальное число виртуальных ядер для каждой базы данных для пула ресурсов, который не соответствует допустимым значениям.

  • 400 ElasticPoolDbVcoreMinBelowLimit — запрошенный минимум виртуального ядра базы данных слишком низок для запрошенного уровня служб эластичного пула.

  • 400 InvalidInputValueForDatabaseVcoreMin — попытка задать минимальное количество виртуальных ядер на базу данных для пула ресурсов, который не соответствует допустимым значениям.

  • 400 PartnerDBNotCompatibleForSGXEnclave — попытка задать ссылку GeoDR или обновить SLO для базы данных с поддержкой анклава поддерживается только в том случае, если обе базы данных работают на оборудовании серии DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax — попытка установить минимальное значение виртуального ядра на базу данных, превышающее максимальное число виртуальных ядер на базу данных.

  • 400 InvalidLicenseType — пользователь пытался создать или обновить базу данных или эластичные пулы с неподдерживаемой лицензией.

  • 400 ProvisioningDisabled — отображает сообщение об ошибке от авторизации операции ресурсов без изменений.

  • 400 InvalidPublicMaintenanceConfiguration — пользователь попытался указать общедоступную конфигурацию обслуживания, которая не может быть преобразована во внутренний идентификатор (неправильно сформированный или неправильный регион).

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 404 ElasticPoolNotFound — указанный эластичный пул не существует для указанного сервера.

  • 404 OperationIdNotFound — операция с идентификатором не существует.

  • 404 ElasticPoolNotFound — указанный эластичный пул не существует для указанного сервера.

  • 405 NotSupported — эта функция не поддерживается.

  • 405 NotSupported — эта функция не поддерживается.

  • 409 ElasticPoolBusy — предпринята попытка выполнения операции управления в занятом эластичном пуле.

  • 409 ServerDisabled — сервер отключен.

  • 409 SimultaneousSkuChangeNotAllowed — операции изменения цели службы не могут выполняться одновременно в обеих базах данных связи репликации.

  • 409 ElasticPoolUpdateLinksNotInCatchup — не удается обновить эластичный пул, пока одна из баз данных выполняет отработку отказа копирования или георепликации.

  • 409 OperationCancelled — операция отменена пользователем.

  • 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом.

  • 409 ElasticPoolBusy — предпринята попытка выполнения операции управления в занятом эластичном пуле.

  • 409 ServerDisabled — сервер отключен.

  • 409 SimultaneousSkuChangeNotAllowed — операции изменения цели службы не могут выполняться одновременно в обеих базах данных связи репликации.

  • 409 ElasticPoolUpdateLinksNotInCatchup — не удается обновить эластичный пул, пока одна из баз данных выполняет отработку отказа копирования или георепликации.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 500 ElasticPoolFailedMoveDbToElasticPool — не удалось переместить базу данных в эластичный пул из-за внутренних ограничений ресурсов. Это может быть временное условие, повторите попытку.

  • 500 OperationTimedOut — истекло время ожидания операции и автоматически выполняется откат. Повторите операцию.

  • 500 ElasticPoolFailedMoveDbToElasticPool — не удалось переместить базу данных в эластичный пул из-за внутренних ограничений ресурсов. Это может быть временное условие, повторите попытку.

  • 503 ServiceTemporarilyUnavailable — функция временно недоступна.

  • 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 503 ServiceTemporarilyUnavailable — функция временно недоступна.

  • 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Create or update elastic pool with all parameter
Create or update elastic pool with maintenance configuration parameter
Create or update elastic pool with minimum parameters
Create or update Hyperscale elastic pool with high availability replica count parameter

Create or update elastic pool with all parameter

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

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

{
  "location": "Japan East",
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Create or update elastic pool with maintenance configuration parameter

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

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

{
  "location": "Japan East",
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Create or update elastic pool with minimum parameters

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

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

{
  "location": "Japan East"
}

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}

Create or update Hyperscale elastic pool with high availability replica count parameter

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

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

{
  "location": "Japan East",
  "sku": {
    "name": "HS_Gen5_4"
  },
  "properties": {
    "highAvailabilityReplicaCount": 2
  }
}

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "HS_Gen5",
    "tier": "Hyperscale",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2021-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "HS_Gen5",
    "tier": "Hyperscale",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2021-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2
  }
}

Определения

Имя Описание
ElasticPool

Пул эластичных баз данных.

ElasticPoolLicenseType

Тип лицензии, применяемой для этого эластичного пула.

ElasticPoolPerDatabaseSettings

На параметры базы данных эластичного пула.

ElasticPoolState

Состояние эластичного пула.

Sku

SKU ресурса ARM.

ElasticPool

Пул эластичных баз данных.

Имя Тип Описание
id

string

Идентификатор ресурса.

kind

string

Тип эластичного пула. Это метаданные, используемые для портал Azure взаимодействия.

location

string

Расположение ресурса.

name

string

Имя ресурса.

properties.creationDate

string

Дата создания эластичного пула (ISO8601 формате).

properties.highAvailabilityReplicaCount

integer

Количество вторичных реплик, связанных с эластичным пулом, которые используются для обеспечения высокого уровня доступности. Применимо только к эластичным пулам с гипермасштабированием.

properties.licenseType

ElasticPoolLicenseType

Тип лицензии, применяемой для этого эластичного пула.

properties.maintenanceConfigurationId

string

Идентификатор конфигурации обслуживания, назначенный эластичному пулу. Эта конфигурация определяет период, когда будут выполняться обновления обслуживания.

properties.maxSizeBytes

integer

Ограничение хранилища для эластичного пула базы данных в байтах.

properties.minCapacity

number

Минимальная емкость бессерверного пула не будет уменьшаться ниже, если она не приостановлена

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Параметры базы данных для эластичного пула.

properties.state

ElasticPoolState

Состояние эластичного пула.

properties.zoneRedundant

boolean

Является ли этот эластичный пул избыточным между зонами. Это означает, что реплики этого эластичного пула будут распределены между несколькими зонами доступности.

sku

Sku

Номер SKU эластичного пула.

Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для подписки в регионе Azure, используйте Capabilities_ListByLocation REST API или следующую команду:

az sql elastic-pool list-editions -l <location> -o table
tags

object

Теги ресурсов.

type

string

Тип ресурса.

ElasticPoolLicenseType

Тип лицензии, применяемой для этого эластичного пула.

Имя Тип Описание
BasePrice

string

LicenseIncluded

string

ElasticPoolPerDatabaseSettings

На параметры базы данных эластичного пула.

Имя Тип Описание
maxCapacity

number

Максимальный объем, который может использовать одна база данных.

minCapacity

number

Гарантируется минимальная емкость всех баз данных.

ElasticPoolState

Состояние эластичного пула.

Имя Тип Описание
Creating

string

Disabled

string

Ready

string

Sku

SKU ресурса ARM.

Имя Тип Описание
capacity

integer

Емкость конкретного номера SKU.

family

string

Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь.

name

string

Имя номера SKU, как правило, буква + числовой код, например P3.

size

string

Размер конкретного номера SKU

tier

string

Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум".