Elastic Pools - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

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

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

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;
import com.azure.resourcemanager.sql.models.ElasticPoolPerDatabaseSettings;
import com.azure.resourcemanager.sql.models.Sku;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolCreateOrUpdateMax.json
     */
    /**
     * Sample code: Create or update elastic pool with all parameter.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateElasticPoolWithAllParameter(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102",
            new ElasticPoolInner().withLocation("Japan East")
                .withSku(new Sku().withName("GP_Gen4_2").withTier("GeneralPurpose").withCapacity(2))
                .withPerDatabaseSettings(
                    new ElasticPoolPerDatabaseSettings().withMinCapacity(0.25D).withMaxCapacity(2.0D)),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

Create or update elastic pool with maintenance configuration parameter

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ElasticPoolCreateOrUpdateSetMaintenanceConfiguration.json
     */
    /**
     * Sample code: Create or update elastic pool with maintenance configuration parameter.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateElasticPoolWithMaintenanceConfigurationParameter(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102",
            new ElasticPoolInner().withLocation("Japan East").withMaintenanceConfigurationId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

Create or update elastic pool with minimum parameters

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolCreateOrUpdateMin.json
     */
    /**
     * Sample code: Create or update elastic pool with minimum parameters.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createOrUpdateElasticPoolWithMinimumParameters(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", new ElasticPoolInner().withLocation("Japan East"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

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

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ElasticPoolInner;
import com.azure.resourcemanager.sql.models.Sku;

/** Samples for ElasticPools CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * HyperscaleElasticPoolCreateOrUpdateSetHighAvailabilityReplicaCount.json
     */
    /**
     * Sample code: Create or update Hyperscale elastic pool with high availability replica count parameter.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateHyperscaleElasticPoolWithHighAvailabilityReplicaCountParameter(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().createOrUpdate("sqlcrudtest-2369",
            "sqlcrudtest-8069", "sqlcrudtest-8102", new ElasticPoolInner().withLocation("Japan East")
                .withSku(new Sku().withName("HS_Gen5_4")).withHighAvailabilityReplicaCount(2),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

Определения

Имя	Описание
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, например "Базовый", "Премиум".