Elastic Pools - Update

Служба:

SQL Database

Версия API:

2021-11-01

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

PATCH 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 для использования в запросе.

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

Имя	Тип	Описание
properties.highAvailabilityReplicaCount	integer	Количество вторичных реплик, связанных с эластичным пулом, которые используются для обеспечения высокого уровня доступности. Применимо только к эластичным пулам с гипермасштабированием.
properties.licenseType	ElasticPoolLicenseType	Тип лицензии, применяемой для этого эластичного пула.
properties.maintenanceConfigurationId	string	Идентификатор конфигурации обслуживания, назначенный эластичному пулу. Эта конфигурация определяет период, когда будут выполняться обновления для обслуживания.
properties.maxSizeBytes	integer	Ограничение хранилища для эластичного пула базы данных в байтах.
properties.minCapacity	number	Минимальная емкость, что бессерверный пул не будет уменьшаться ниже, если не приостановлено
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	Параметры базы данных для эластичного пула.
properties.zoneRedundant	boolean	Является ли этот эластичный пул избыточным между зонами. Это означает, что реплики этого эластичного пула будут распределены по нескольким зонам доступности.
sku	Sku	SKU ресурса ARM.
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	ElasticPool	Обновлен эластичный пул
202 Accepted		Принято
Other Status Codes		Ответы об ошибках: *** 400 ElasticPoolOverStorageUsage — попытка записи данных в базу данных при достижении предела хранилища эластичного пула. 400 InvalidSku — пользователь указал недопустимый номер SKU. 400 InvalidTierSkuCombination — указанный уровень не поддерживает указанный номер SKU. 400 ServerQuotaExceeded — сервер достиг предела для разрешенной единицы пропускной способности базы данных. 400 ElasticPoolAlreadyExists — сервер уже содержит эластичный пул с указанным именем. 400 SubscriptionVcoreQuotaExceeded — не удалось выполнить операцию, так как подписка превысит допустимую квоту виртуальных ядер. 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 ServerQuotaExceeded — сервер достиг предела для разрешенной единицы пропускной способности базы данных. 400 ElasticPoolAlreadyExists — сервер уже содержит эластичный пул с указанным именем. 400 SubscriptionVcoreQuotaExceeded — не удалось выполнить операцию, так как подписка превысит допустимую квоту виртуальных ядер. 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 — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Assigns maintenance configuration to an elastic pool.

Resets maintenance configuration of an elastic pool to default.

Update an elastic pool with all parameter

Update an elastic pool with minimum parameters

Update high availability replica count of a Hyperscale elastic pool.

Assigns maintenance configuration to an elastic pool.

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

HTTP

PATCH 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

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

Java

import com.azure.resourcemanager.sql.models.ElasticPoolUpdate;

/**
 * Samples for ElasticPools Update.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ElasticPoolUpdateAssignMaintenanceConfiguration.json
     */
    /**
     * Sample code: Assigns maintenance configuration to an elastic pool.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        assignsMaintenanceConfigurationToAnElasticPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().update("sqlcrudtest-2369", "sqlcrudtest-8069",
            "sqlcrudtest-8102",
            new ElasticPoolUpdate().withMaintenanceConfigurationId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"),
            com.azure.core.util.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

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

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

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": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

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

202

Resets maintenance configuration of an elastic pool to default.

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

HTTP

PATCH 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

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
  }
}

Java

import com.azure.resourcemanager.sql.models.ElasticPoolUpdate;

/**
 * Samples for ElasticPools Update.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ElasticPoolUpdateResetMaintenanceConfiguration.json
     */
    /**
     * Sample code: Resets maintenance configuration of an elastic pool to default.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        resetsMaintenanceConfigurationOfAnElasticPoolToDefault(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().update("sqlcrudtest-2369", "sqlcrudtest-8069",
            "sqlcrudtest-8102",
            new ElasticPoolUpdate().withMaintenanceConfigurationId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"),
            com.azure.core.util.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

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

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

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": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    }
  }
}

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

202

Update an elastic pool with all parameter

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

HTTP

PATCH 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

{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded"
  }
}

Java

import com.azure.resourcemanager.sql.models.ElasticPoolLicenseType;
import com.azure.resourcemanager.sql.models.ElasticPoolPerDatabaseSettings;
import com.azure.resourcemanager.sql.models.ElasticPoolUpdate;
import com.azure.resourcemanager.sql.models.Sku;

/**
 * Samples for ElasticPools Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolUpdateMax.json
     */
    /**
     * Sample code: Update an elastic pool with all parameter.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAnElasticPoolWithAllParameter(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().update("sqlcrudtest-2369", "sqlcrudtest-8069",
            "sqlcrudtest-8102",
            new ElasticPoolUpdate().withSku(new Sku().withName("BC_Gen4").withTier("BusinessCritical").withCapacity(2))
                .withPerDatabaseSettings(
                    new ElasticPoolPerDatabaseSettings().withMinCapacity(0.25D).withMaxCapacity(1.0D))
                .withZoneRedundant(true).withLicenseType(ElasticPoolLicenseType.LICENSE_INCLUDED),
            com.azure.core.util.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

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

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

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": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:27:21.32Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded"
  }
}

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

202

Update an elastic pool with minimum parameters

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

HTTP

PATCH 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

{}

Java

import com.azure.resourcemanager.sql.models.ElasticPoolUpdate;

/**
 * Samples for ElasticPools Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolUpdateMin.json
     */
    /**
     * Sample code: Update an elastic pool with minimum parameters.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAnElasticPoolWithMinimumParameters(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().update("sqlcrudtest-2369", "sqlcrudtest-8069",
            "sqlcrudtest-8102", new ElasticPoolUpdate(), com.azure.core.util.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

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

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

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": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    }
  }
}

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

202

Update high availability replica count of a Hyperscale elastic pool.

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

HTTP

PATCH 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

{
  "properties": {
    "highAvailabilityReplicaCount": 2
  }
}

Java

import com.azure.resourcemanager.sql.models.ElasticPoolUpdate;

/**
 * Samples for ElasticPools Update.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * HyperscaleElasticPoolUpdateSetHighAvailabilityReplicaCount.json
     */
    /**
     * Sample code: Update high availability replica count of a Hyperscale elastic pool.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateHighAvailabilityReplicaCountOfAHyperscaleElasticPool(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().update("sqlcrudtest-2369", "sqlcrudtest-8069",
            "sqlcrudtest-8102", new ElasticPoolUpdate().withHighAvailabilityReplicaCount(2),
            com.azure.core.util.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

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

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

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

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

202

Определения

Имя	Описание
ElasticPool	Пул эластичных баз данных.
ElasticPoolLicenseType	Тип лицензии, применяемой для этого эластичного пула.
ElasticPoolPerDatabaseSettings	Параметры базы данных эластичного пула.
ElasticPoolState	Состояние эластичного пула.
ElasticPoolUpdate	Обновление эластичного пула.
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

ElasticPoolUpdate

Обновление эластичного пула.

Имя	Тип	Описание
properties.highAvailabilityReplicaCount	integer	Количество вторичных реплик, связанных с эластичным пулом, которые используются для обеспечения высокого уровня доступности. Применимо только к эластичным пулам с гипермасштабированием.
properties.licenseType	ElasticPoolLicenseType	Тип лицензии, применяемой для этого эластичного пула.
properties.maintenanceConfigurationId	string	Идентификатор конфигурации обслуживания, назначенный эластичному пулу. Эта конфигурация определяет период, когда будут выполняться обновления для обслуживания.
properties.maxSizeBytes	integer	Ограничение хранилища для эластичного пула базы данных в байтах.
properties.minCapacity	number	Минимальная емкость, что бессерверный пул не будет уменьшаться ниже, если не приостановлено
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	Параметры базы данных для эластичного пула.
properties.zoneRedundant	boolean	Является ли этот эластичный пул избыточным между зонами. Это означает, что реплики этого эластичного пула будут распределены по нескольким зонам доступности.
sku	Sku	SKU ресурса ARM.
tags	object	Теги ресурсов.

Sku

SKU ресурса ARM.

Имя	Тип	Описание
capacity	integer	Емкость конкретного номера SKU.
family	string	Если служба имеет разные поколения оборудования для одного номера SKU, то это можно записать здесь.
name	string	Имя номера SKU, как правило, буква + номер, например P3.
size	string	Размер конкретного номера SKU
tier	string	Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум".