Elastic Pools - Update

Aktualizacje elastycznej puli.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
elasticPoolName
path True

string

Nazwa elastycznej puli.

resourceGroupName
path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True

string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa Typ Opis
properties.highAvailabilityReplicaCount

integer

Liczba replik pomocniczych skojarzonych z elastyczną pulą, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala.

properties.licenseType

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

properties.maintenanceConfigurationId

string

Identyfikator konfiguracji konserwacji przypisany do puli elastycznej. Ta konfiguracja definiuje okres, w których będą wykonywane aktualizacje konserwacji.

properties.maxSizeBytes

integer

Limit magazynu dla elastycznej puli bazy danych w bajtach.

properties.minCapacity

number

Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Ustawienia poszczególnych baz danych dla elastycznej puli.

properties.zoneRedundant

boolean

Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności.

sku

Sku

Jednostka SKU zasobu usługi ARM.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

ElasticPool

Zaktualizowano elastyczną pulę

202 Accepted

Zaakceptowano

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 ElasticPoolOverStorageUsage — próba zapisania danych w bazie danych po osiągnięciu limitu magazynu puli elastycznej.

  • 400 InvalidSku — użytkownik określił nieprawidłową jednostkę SKU.

  • 400 InvalidTierSkuCombination — określona warstwa nie obsługuje określonej jednostki SKU.

  • 400 ServerQuotaExceeded — serwer osiągnął limit dozwolonej jednostki przepływności bazy danych.

  • 400 ElasticPoolAlreadyExists — serwer zawiera już elastyczną pulę o określonej nazwie.

  • 400 SubscriptionVcoreQuotaExceeded — nie można wykonać operacji, ponieważ subskrypcja przekroczy dozwolony limit przydziału rdzeni wirtualnych.

  • 400 InvalidInputValueForEdition — określona wersja nie jest obsługiwana w przypadku aprowizacji puli elastycznej.

  • 400 ElasticPoolDtuBelowLimit — żądana wartość jednostki DTU jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDtuAboveLimit — żądana wartość jednostki DTU jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidMaxSize — nieprawidłowy maksymalny rozmiar.

  • 400 ElasticPoolDbDtuMaxBelowLimit — żądana maksymalna liczba jednostek DTU bazy danych jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbDtuMaxAboveLimit — żądana maksymalna liczba jednostek DTU bazy danych jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseDtuMax — próba ustawienia maksymalnej liczby jednostek DTU dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolDbDtuMinAboveLimit — żądana minimalna liczba jednostek DTU na bazę danych jest zbyt wysoka dla żądanej warstwy usługi.

  • 400 ElasticPoolOverStorage — próba zapisania danych w bazie danych po osiągnięciu limitu magazynu elastycznej puli.

  • 400 InvalidInputValueForDatabaseDtuMin — próba ustawienia wartości DTU min na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings — próba podania wartości DTU min dla baz danych w puli elastycznej, która przekracza żądane jednostki DTU puli elastycznej.

  • 400 ElasticPoolDtuUnsupported — użytkownik próbował utworzyć lub zaktualizować elastyczną pulę z pojemnością jednostki DTU, która nie jest obsługiwana.

  • 400 ElasticPoolStorageAboveLimitGB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolsNotEnabled — pule elastyczne nie zostały włączone w tym regionie.

  • 400 ElasticPoolNotEmpty — żądanie usunięcia puli elastycznej, która nie jest pusta.

  • 400 ElasticPoolStorageBelowLimitGB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolStorageNotAllowedGB — próba ustawienia limitu magazynu elastycznej puli w gb, który nie jest zgodny z dozwolonymi wartościami.

  • 400 ElasticPoolDatabaseLimit — pula elastyczna osiągnęła limit liczby baz danych.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage — próba zmniejszenia limitu magazynu puli elastycznej poniżej użycia magazynu.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax — próba ustawienia wartości minimalnej jednostki DTU na bazę danych wyższą niż maksymalna liczba jednostek DTU na bazę danych.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings — liczba baz danych i minimalna liczba rdzeni wirtualnych na bazę danych nie może przekraczać żądanych rdzeni wirtualnych puli elastycznej.

  • 400 ElasticPoolStorageBelowLimitMB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolStorageNotAllowedMB — próba ustawienia limitu magazynu elastycznej puli w mb, który nie jest zgodny z dozwolonymi wartościami.

  • 400 ElasticPoolCapacityStorageNotAllowedMB — próba ustawienia limitu magazynu elastycznej puli w mb, który nie jest zgodny z dozwolonymi wartościami.

  • 400 ElasticPoolStorageAboveLimitMB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 RegionDoesNotSupportVersion — użytkownik próbował utworzyć serwer określonej wersji w lokalizacji, w której ta wersja serwera nie jest obsługiwana.

  • 400 InvalidTier — użytkownik określił nieprawidłową warstwę.

  • 400 SourceDatabaseEditionCouldNotBe Upgrade — źródłowa baza danych nie może mieć wyższej wersji niż docelowa baza danych.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded — docelowa baza danych nie może mieć niższej wersji niż źródłowa baza danych.

  • 400 ElasticPoolUpdateHkNotAllowed — pula elastyczna nie może obniżyć warstwy usługi z warstwy Premium do Warstwy Standardowa lub Podstawowa, ponieważ co najmniej jedna z jej baz danych używa obiektów zoptymalizowanych pod kątem pamięci.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress — operacja jest niedozwolona, ponieważ operacja kopiowania lub trybu failover dla bazy danych "" na serwerze "{0}{1}" jest obecnie w toku.

  • 400 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów usługi Windows Azure SQL Database. Może to ulec zmianie w późniejszym czasie.

  • 400 ElasticPoolOverFileSpace — niewystarczająca ilość miejsca na plikach w elastycznej puli.

  • 400 ElasticPoolDbDtuMinBelowLimit — żądana liczba jednostek DTU bazy danych jest za mała dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbVcoreMaxBelowLimit — żądana maksymalna wartość rdzenia wirtualnego bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbVcoreMaxAboveLimit — żądana maksymalna liczba rdzeni wirtualnych bazy danych jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseVcoreMax — próba ustawienia maksymalnej liczby rdzeni wirtualnych na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolDbVcoreMinBelowLimit — żądana minimalna liczba rdzeni wirtualnych bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseVcoreMin — próba ustawienia min rdzeni wirtualnych na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 PartnerDBNotCompatibleForSGXEnclave — próba ustawienia linku GeoDR lub zaktualizowanie celu SLO dla bazy danych z włączoną enklawą jest obsługiwana tylko wtedy, gdy obie bazy danych są uruchomione na sprzęcie serii DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax — próba ustawienia wartości minimalnej liczby rdzeni wirtualnych na bazę danych wyższej niż maksymalna liczba rdzeni wirtualnych na bazę danych.

  • 400 InvalidLicenseType — użytkownik próbował utworzyć lub zaktualizować bazę danych lub elastyczną pulę z nieobsługiwanym typem licencji.

  • 400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów bez zmian

  • 400 InvalidPublicMaintenanceConfiguration — użytkownik próbował określić konfigurację konserwacji publicznej, której nie można przekonwertować na identyfikator wewnętrzny (źle sformułowany lub nieprawidłowy region).

  • 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe.

  • 400 InvalidResourceId — nieprawidłowy identyfikator zasobu.

  • 400 InvalidSkuName — nieprawidłowa nazwa jednostki SKU.

  • 400 NiedopasowaneSkuNameAndCapacity — niezgodność między nazwą jednostki SKU a pojemnością.

  • 400 NiedopasowaneSkuNameAndTier — niezgodność między nazwą jednostki SKU a warstwą.

  • 400 NiedopasowaneSkuNameAndFamily — niezgodność między nazwą jednostki SKU a rodziną.

  • 400 NiezgodnośćSubscriptionWithUrl — podana subskrypcja nie jest zgodna z subskrypcją w adresie URL.

  • 400 ElasticPoolOverStorageUsage — próba zapisania danych w bazie danych po osiągnięciu limitu magazynu elastycznej puli.

  • 400 InvalidSku — użytkownik określił nieprawidłową jednostkę SKU.

  • 400 InvalidTierSkuCombination — określona warstwa nie obsługuje określonej jednostki SKU.

  • 400 ServerQuotaExceeded — serwer osiągnął limit dozwolonych jednostek przepływności bazy danych.

  • 400 ElasticPoolAlreadyExists — serwer zawiera już pulę elastyczną o określonej nazwie.

  • 400 SubscriptionVcoreQuotaExceeded — nie można wykonać operacji, ponieważ subskrypcja przekroczy dozwolony limit przydziału rdzeni wirtualnych.

  • 400 InvalidInputValueForEdition — określona wersja nie jest obsługiwana w przypadku aprowizacji puli elastycznej.

  • 400 ElasticPoolDtuBelowLimit — żądana wartość jednostki DTU jest zbyt niska dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDtuAboveLimit — żądana wartość jednostki DTU jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidMaxSize — nieprawidłowy maksymalny rozmiar.

  • 400 ElasticPoolDbDtuMaxBelowLimit — żądana maksymalna wartość jednostki DTU bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbDtuMaxAboveLimit — żądana maksymalna liczba jednostek DTU bazy danych jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseDtuMax — próba ustawienia maksymalnej wartości DTU dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolDbDtuMinAboveLimit — żądana minimalna liczba jednostek DTU na bazę danych jest zbyt wysoka dla żądanej warstwy usługi.

  • 400 ElasticPoolOverStorage — próba zapisania danych w bazie danych po osiągnięciu limitu magazynu elastycznej puli.

  • 400 InvalidInputValueForDatabaseDtuMin — próba ustawienia minimalnej liczby jednostek DTU na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings — próba zapewnienia minimalnej liczby jednostek DTU dla baz danych w elastycznej puli, która przekracza żądane jednostki DTU puli elastycznej.

  • 400 ElasticPoolDtuUnsupported — użytkownik próbował utworzyć lub zaktualizować elastyczną pulę przy użyciu pojemności jednostki DTU, która nie jest obsługiwana.

  • 400 ElasticPoolStorageAboveLimitGB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolsNotEnabled — pule elastyczne nie zostały włączone w tym regionie.

  • 400 ElasticPoolNotEmpty — żądanie usunięcia puli elastycznej, która nie jest pusta.

  • 400 ElasticPoolStorageBelowLimitGB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolStorageNotAllowedGB — próba ustawienia limitu magazynu elastycznej puli w gb, który nie odpowiada dozwolonym wartościom.

  • 400 ElasticPoolDatabaseLimit — pula elastyczna osiągnęła limit liczby baz danych.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage — próba zmniejszenia limitu magazynu puli elastycznej poniżej użycia magazynu.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax — próba ustawienia minimalnej liczby jednostek DTU na bazę danych wyższej niż maksymalna liczba jednostek DTU na bazę danych.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings — liczba baz danych i minimalna liczba rdzeni wirtualnych na bazę danych nie może przekraczać żądanych rdzeni wirtualnych elastycznej puli.

  • 400 ElasticPoolStorageBelowLimitMB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 ElasticPoolStorageNotAllowedMB — próba ustawienia limitu magazynu elastycznej puli w mb, który nie jest zgodny z dozwolonymi wartościami.

  • 400 ElasticPoolCapacityStorageNotAllowedMB — próba ustawienia limitu magazynu elastycznej puli w mb, który nie odpowiada dozwolonym wartościom.

  • 400 ElasticPoolStorageAboveLimitMB — próba ustawienia limitu magazynu elastycznej puli poniżej obsługiwanego limitu.

  • 400 RegionDoesNotSupportVersion — użytkownik próbował utworzyć serwer określonej wersji w lokalizacji, w której ta wersja serwera nie jest obsługiwana.

  • 400 InvalidTier — użytkownik określił nieprawidłową warstwę.

  • 400 SourceDatabaseEditionCouldNotBe Upgrade — źródłowa baza danych nie może mieć wyższej wersji niż docelowa baza danych.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded — docelowa baza danych nie może mieć niższej wersji niż źródłowa baza danych.

  • 400 ElasticPoolUpdateHkNotAllowed — elastyczna pula nie może obniżyć warstwy usługi z warstwy Premium do warstwy Standardowa lub Podstawowa, ponieważ co najmniej jedna baza danych używa obiektów zoptymalizowanych pod kątem pamięci.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress — operacja jest niedozwolona, ponieważ operacja kopiowania lub trybu failover dla bazy danych "{0}" na serwerze "{1}" jest obecnie w toku.

  • 400 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów bazy danych systemu Windows Azure SQL. Może to ulec zmianie w późniejszym czasie.

  • 400 ElasticPoolOverFileSpace — niewystarczająca ilość miejsca na plik w elastycznej puli.

  • 400 ElasticPoolDbDtuMinBelowLimit — żądana minimalna liczba jednostek DTU bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbVcoreMaxBelowLimit — żądana maksymalna wartość rdzenia wirtualnego bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli.

  • 400 ElasticPoolDbVcoreMaxAboveLimit — żądana maksymalna liczba rdzeni wirtualnych bazy danych jest zbyt wysoka dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseVcoreMax — próba ustawienia maksymalnej liczby rdzeni wirtualnych na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 ElasticPoolDbVcoreMinBelowLimit — żądana minimalna liczba rdzeni wirtualnych bazy danych jest zbyt niska dla żądanej warstwy usługi elastycznej puli.

  • 400 InvalidInputValueForDatabaseVcoreMin — próba ustawienia min rdzeni wirtualnych na bazę danych dla puli zasobów, która nie jest zgodna z dozwolonymi wartościami.

  • 400 PartnerDBNotCompatibleForSGXEnclave — próba ustawienia linku GeoDR lub zaktualizowanie celu SLO dla bazy danych z włączoną enklawą jest obsługiwana tylko wtedy, gdy obie bazy danych są uruchomione na sprzęcie serii DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax — próba ustawienia wartości minimalnej liczby rdzeni wirtualnych na bazę danych wyższej niż maksymalna liczba rdzeni wirtualnych na bazę danych.

  • 400 InvalidLicenseType — użytkownik próbował utworzyć lub zaktualizować bazę danych lub elastyczną pulę z nieobsługiwanym typem licencji.

  • 400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów bez zmian

  • 400 InvalidPublicMaintenanceConfiguration — użytkownik próbował określić konfigurację konserwacji publicznej, której nie można przekonwertować na identyfikator wewnętrzny (źle sformułowany lub nieprawidłowy region).

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 ElasticPoolNotFound — określona pula elastyczna nie istnieje dla określonego serwera.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 404 ElasticPoolNotFound — określona pula elastyczna nie istnieje dla określonego serwera.

  • 405 NotSupported — ta funkcja nie jest obsługiwana.

  • 405 NotSupported — ta funkcja nie jest obsługiwana.

  • 409 ElasticPoolBusy — podjęto próbę wykonania operacji zarządzania w elastycznej puli, która jest zajęta.

  • 409 ServerDisabled — serwer jest wyłączony.

  • 409 JednoczesneSkuChangeNotAllowed — operacje zmiany celu usługi nie mogą być jednocześnie uruchamiane w obu bazach danych relacji replikacji.

  • 409 ElasticPoolUpdateLinksNotInCatchup — nie można zaktualizować elastycznej puli, podczas gdy jedna z jej baz danych wykonuje operację kopiowania lub replikacji geograficznej w trybie failover.

  • 409 OperationCancelled — operacja została anulowana przez użytkownika.

  • 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.

  • 409 ElasticPoolBusy — podjęto próbę wykonania operacji zarządzania w elastycznej puli, która jest zajęta.

  • 409 ServerDisabled — serwer jest wyłączony.

  • 409 JednoczesneSkuChangeNotAllowed — operacje zmiany celu usługi nie mogą być jednocześnie uruchamiane w obu bazach danych relacji replikacji.

  • 409 ElasticPoolUpdateLinksNotInCatchup — nie można zaktualizować elastycznej puli, podczas gdy jedna z jej baz danych wykonuje operację kopiowania lub replikacji geograficznej w trybie failover.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.

  • 500 ElasticPoolFailedMoveDbToElasticPool — nie można przenieść bazy danych do elastycznej puli z powodu ograniczeń zasobów wewnętrznych. Może to być warunek przejściowy. Spróbuj ponownie.

  • 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji.

  • 500 ElasticPoolFailedMoveDbToElasticPool — nie można przenieść bazy danych do elastycznej puli z powodu ograniczeń zasobów wewnętrznych. Może to być warunek przejściowy. Spróbuj ponownie.

  • 503 ServiceTemporarilyUnavailable — funkcja jest tymczasowo niedostępna.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 503 ServiceTemporarilyUnavailable — funkcja jest tymczasowo niedostępna.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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.

Sample Request

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

Sample Response

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

Resets maintenance configuration of an elastic pool to default.

Sample Request

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

Sample Response

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

Update an elastic pool with all parameter

Sample Request

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

Sample Response

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

Update an elastic pool with minimum parameters

Sample Request

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

{}

Sample Response

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

Update high availability replica count of a Hyperscale elastic pool.

Sample Request

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

Sample Response

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

Definicje

Nazwa Opis
ElasticPool

Elastyczna pula.

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

ElasticPoolPerDatabaseSettings

Na ustawienia bazy danych elastycznej puli.

ElasticPoolState

Stan elastycznej puli.

ElasticPoolUpdate

Aktualizacja elastycznej puli.

Sku

Jednostka SKU zasobu usługi ARM.

ElasticPool

Elastyczna pula.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

kind

string

Rodzaj elastycznej puli. Są to metadane używane w środowisku Azure Portal.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.creationDate

string

Data utworzenia elastycznej puli (format ISO8601).

properties.highAvailabilityReplicaCount

integer

Liczba replik pomocniczych skojarzonych z elastyczną pulą, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala.

properties.licenseType

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

properties.maintenanceConfigurationId

string

Identyfikator konfiguracji konserwacji przypisany do puli elastycznej. Ta konfiguracja definiuje okres, w których będą wykonywane aktualizacje konserwacji.

properties.maxSizeBytes

integer

Limit magazynu dla elastycznej puli bazy danych w bajtach.

properties.minCapacity

number

Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Ustawienia poszczególnych baz danych dla elastycznej puli.

properties.state

ElasticPoolState

Stan elastycznej puli.

properties.zoneRedundant

boolean

Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności.

sku

Sku

Jednostka SKU puli elastycznej.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub następującego polecenia:

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

object

Tagi zasobów.

type

string

Typ zasobu.

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

Nazwa Typ Opis
BasePrice

string

LicenseIncluded

string

ElasticPoolPerDatabaseSettings

Na ustawienia bazy danych elastycznej puli.

Nazwa Typ Opis
maxCapacity

number

Maksymalna pojemność, jaką może zużyć dowolna baza danych.

minCapacity

number

Minimalna pojemność wszystkich baz danych jest gwarantowana.

ElasticPoolState

Stan elastycznej puli.

Nazwa Typ Opis
Creating

string

Disabled

string

Ready

string

ElasticPoolUpdate

Aktualizacja elastycznej puli.

Nazwa Typ Opis
properties.highAvailabilityReplicaCount

integer

Liczba replik pomocniczych skojarzonych z elastyczną pulą, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala.

properties.licenseType

ElasticPoolLicenseType

Typ licencji do zastosowania dla tej elastycznej puli.

properties.maintenanceConfigurationId

string

Identyfikator konfiguracji konserwacji przypisany do puli elastycznej. Ta konfiguracja definiuje okres, w których będą wykonywane aktualizacje konserwacji.

properties.maxSizeBytes

integer

Limit magazynu dla elastycznej puli bazy danych w bajtach.

properties.minCapacity

number

Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Ustawienia poszczególnych baz danych dla elastycznej puli.

properties.zoneRedundant

boolean

Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności.

sku

Sku

Jednostka SKU zasobu usługi ARM.

tags

object

Tagi zasobów.

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa Typ Opis
capacity

integer

Pojemność określonej jednostki SKU.

family

string

Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.

name

string

Nazwa jednostki SKU, zazwyczaj litera + kod liczbowy, np. P3.

size

string

Rozmiar określonej jednostki SKU

tier

string

Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium.