Delen via

Elastic Pools - Update

  • Referentie
Service:
SQL Database
API Version:
2021-11-01

Updates een elastische pool.

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

URI-parameters

Name In Vereist Type Description
elasticPoolName
 path True

string

De naam van de elastische pool.
resourceGroupName
 path True

string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName
 path True

string

De naam van de server.
subscriptionId
 path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version
 query True

string

De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name Type Description
properties.highAvailabilityReplicaCount

integer

Het aantal secundaire replica's dat is gekoppeld aan de elastische pool dat wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools.
properties.licenseType

ElasticPoolLicenseType

Het licentietype dat moet worden toegepast voor deze elastische pool.
properties.maintenanceConfigurationId

string

Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Deze configuratie definieert de periode waarin de onderhoudsupdates worden uitgevoerd.
properties.maxSizeBytes

integer

De opslaglimiet voor de elastische databasegroep in bytes.
properties.minCapacity

number

Minimale capaciteit die serverloze pool niet kleiner wordt, indien niet onderbroken
properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

De instellingen per database voor de elastische pool.
properties.zoneRedundant

boolean

Of deze elastische pool zoneredundant is of niet, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones.
sku

Sku

Een ARM-resource-SKU.
tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

ElasticPool

De elastische pool is bijgewerkt
202 Accepted

Geaccepteerd
Other Status Codes

Foutreacties: ***

  • 400 ElasticPoolOverStorageUsage : er wordt geprobeerd gegevens naar een database te schrijven wanneer de opslaglimiet van de elastische pool is bereikt.

  • 400 InvalidSku : de gebruiker heeft een ongeldige SKU opgegeven.

  • 400 InvalidTierSkuCombination - De opgegeven laag biedt geen ondersteuning voor de opgegeven SKU.

  • 400 ServerQuotaExceeded : de server heeft de limiet voor toegestane databasedoorvoereenheid bereikt.

  • 400 ElasticPoolAlreadyExists: de server bevat al een elastische pool met de opgegeven naam.

  • 400 SubscriptionVcoreQuotaExceeded - Kan de bewerking niet uitvoeren omdat het abonnement het toegestane vCore-quotum overschrijdt.

  • 400 InvalidInputValueForEdition - Opgegeven editie wordt niet ondersteund voor het inrichten van elastische pools.

  • 400 ElasticPoolDtuBelowLimit - De aangevraagde DTU-waarde is te laag voor de servicelaag van de aangevraagde elastische pool.

  • 400 ElasticPoolDtuAboveLimit : de aangevraagde DTU-waarde is te hoog voor de servicelaag van de aangevraagde elastische pool.

  • 400 InvalidMaxSize - Ongeldige maximale grootte.

  • 400 ElasticPoolDbDtuMaxBelowLimit - Het aangevraagde DTU-maximum per database is te laag voor de aangevraagde servicelaag voor elastische pools.

  • 400 ElasticPoolDbDtuMaxAboveLimit - Het aangevraagde DTU-maximum per database is te hoog voor de aangevraagde servicelaag voor elastische pools.

  • 400 InvalidInputValueForDatabaseDtuMax : probeert het DTU-maximum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolDbDtuMinAboveLimit : de aangevraagde DTU min per database is te hoog voor de aangevraagde servicelaag.

  • 400 ElasticPoolOverStorage : er wordt geprobeerd gegevens naar een database te schrijven wanneer de opslaglimiet van de elastische pool is bereikt.

  • 400 InvalidInputValueForDatabaseDtuMin : een poging om het DTU-minimum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings : er wordt geprobeerd om DTU min op te geven voor databases in de elastische pool die de aangevraagde DTU's van de elastische pool overschrijdt.

  • 400 ElasticPoolDtuUnsupported - Gebruiker heeft geprobeerd een elastische pool te maken of bij te werken met een DTU-capaciteit die niet wordt ondersteund.

  • 400 ElasticPoolStorageAboveLimitGB: een poging om de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 ElasticPoolsNotEnabled - Elastische pools zijn niet ingeschakeld in deze regio.

  • 400 ElasticPoolNotEmpty : aanvraag om een elastische pool te verwijderen die niet leeg is.

  • 400 ElasticPoolStorageBelowLimitGB: er wordt geprobeerd de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 ElasticPoolStorageNotAllowedGB: een poging om de opslaglimiet voor elastische pools in gb in te stellen die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolDatabaseLimit : de elastische pool heeft de limiet voor het aantal databases bereikt.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage : probeert de opslaglimiet van de elastische pool te verlagen tot onder het opslaggebruik.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax : er wordt geprobeerd de DTU min per database hoger in te stellen dan het DTU-maximum per database.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings : het aantal databases en het VCore-minimum per database mag niet groter zijn dan de aangevraagde VCores van de elastische pool.

  • 400 ElasticPoolStorageBelowLimitMB: er wordt geprobeerd de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 ElasticPoolStorageNotAllowedMB: er wordt geprobeerd de opslaglimiet voor de elastische pool in mb in te stellen die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolCapacityStorageNotAllowedMB: een poging om de opslaglimiet voor de elastische pool in mb in te stellen die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolStorageAboveLimitMB: er wordt geprobeerd de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 RegionDoesNotSupportVersion - Een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund.

  • 400 InvalidTier : de gebruiker heeft een ongeldige laag opgegeven.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded : de brondatabase mag geen hogere editie hebben dan de doeldatabase.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded : de doeldatabase mag geen lagere editie hebben dan de brondatabase.

  • 400 ElasticPoolUpdateHkNotAllowed - De elastische pool kan de servicelaag niet verlagen van Premium naar Standard of Basic, omdat een of meer databases gebruikmaken van objecten die zijn geoptimaliseerd voor geheugen.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress : de bewerking is niet toegestaan omdat de kopieer- of failoverbewerking voor de database '{0}' op server{1}' momenteel wordt uitgevoerd.

  • 400 RegionDoesNotAllowProvisioning - De geselecteerde locatie accepteert geen nieuwe Windows Azure SQL Database-servers. Dit kan op een later tijdstip veranderen.

  • 400 ElasticPoolOverFileSpace - Onvoldoende bestandsruimte in de elastische pool.

  • 400 ElasticPoolDbDtuMinBelowLimit: de aangevraagde DTU-min per database is te laag voor de servicelaag van de aangevraagde elastische pool.

  • 400 ElasticPoolDbVcoreMaxBelowLimit - Het aangevraagde VCore-maximum per database is te laag voor de aangevraagde servicelaag voor elastische pools.

  • 400 ElasticPoolDbVcoreMaxAboveLimit - Het aangevraagde VCore-maximum per database is te hoog voor de aangevraagde servicelaag voor elastische pools.

  • 400 InvalidInputValueForDatabaseVcoreMax: er wordt geprobeerd het VCore-maximum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolDbVcoreMinBelowLimit - De aangevraagde VCore-min per database is te laag voor de aangevraagde servicelaag voor elastische pools.

  • 400 InvalidInputValueForDatabaseVcoreMin: een poging om het VCore-minimum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Poging om GeoDR-koppeling in te stellen of SLO bij te werken voor enclave-database wordt alleen ondersteund wanneer beide databases worden uitgevoerd op hardware uit de DC-serie.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Een poging om het VCore-minimum per database hoger in te stellen dan het VCore-maximum per database.

  • 400 InvalidLicenseType - Gebruiker heeft geprobeerd een database of elastische pool te maken of bij te werken met een niet-ondersteund licentietype.

  • 400 ProvisioningDisabled - Geeft een foutbericht weer van de resource operation authorizer zoals het is, zonder wijzigingen

  • 400 InvalidPublicMaintenanceConfiguration - Gebruiker heeft geprobeerd een configuratie voor openbaar onderhoud op te geven die niet kan worden geconverteerd naar een interne id (onjuiste of verkeerde regio).

  • 400 InvalidResourceRequestBody : de resource of resource-eigenschappen in de aanvraagtekst zijn leeg of ongeldig.

  • 400 InvalidResourceId - Ongeldige resource-id.

  • 400 InvalidSkuName - Ongeldige SKU-naam.

  • 400 Komt niet overeenSkuNameAndCapacity - Niet-overeenkomende SKU-naam en capaciteit.

  • 400 Komt niet overeenSkuNameAndTier : komt niet overeen tussen SKU-naam en laag.

  • 400 Komt niet overeenSkuNameAndFamily : komt niet overeen tussen SKU-naam en familie.

  • 400 Komt niet overeenSubscriptionWithUrl : het opgegeven abonnement komt niet overeen met het abonnement in de URL.

  • 400 ElasticPoolOverStorageUsage : er wordt geprobeerd gegevens naar een database te schrijven wanneer de opslaglimiet van de elastische pool is bereikt.

  • 400 InvalidSku : de gebruiker heeft een ongeldige SKU opgegeven.

  • 400 InvalidTierSkuCombination - De opgegeven laag biedt geen ondersteuning voor de opgegeven SKU.

  • 400 ServerQuotaExceeded : de server heeft de limiet voor toegestane databasedoorvoereenheid bereikt.

  • 400 ElasticPoolAlreadyExists: de server bevat al een elastische pool met de opgegeven naam.

  • 400 SubscriptionVcoreQuotaExceeded - Kan de bewerking niet uitvoeren omdat het abonnement het toegestane vCore-quotum overschrijdt.

  • 400 InvalidInputValueForEdition - Opgegeven editie wordt niet ondersteund voor het inrichten van elastische pools.

  • 400 ElasticPoolDtuBelowLimit - De aangevraagde DTU-waarde is te laag voor de servicelaag van de aangevraagde elastische pool.

  • 400 ElasticPoolDtuAboveLimit : de aangevraagde DTU-waarde is te hoog voor de servicelaag van de aangevraagde elastische pool.

  • 400 InvalidMaxSize - Ongeldige maximale grootte.

  • 400 ElasticPoolDbDtuMaxBelowLimit - Het aangevraagde DTU-maximum per database is te laag voor de aangevraagde servicelaag voor elastische pools.

  • 400 ElasticPoolDbDtuMaxAboveLimit - Het aangevraagde DTU-maximum per database is te hoog voor de aangevraagde servicelaag voor elastische pools.

  • 400 InvalidInputValueForDatabaseDtuMax : probeert het DTU-maximum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolDbDtuMinAboveLimit : de aangevraagde DTU min per database is te hoog voor de aangevraagde servicelaag.

  • 400 ElasticPoolOverStorage : er wordt geprobeerd gegevens naar een database te schrijven wanneer de opslaglimiet van de elastische pool is bereikt.

  • 400 InvalidInputValueForDatabaseDtuMin : een poging om het DTU-minimum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings : er wordt geprobeerd om DTU min op te geven voor databases in de elastische pool die de aangevraagde DTU's van de elastische pool overschrijdt.

  • 400 ElasticPoolDtuUnsupported - Gebruiker heeft geprobeerd een elastische pool te maken of bij te werken met een DTU-capaciteit die niet wordt ondersteund.

  • 400 ElasticPoolStorageAboveLimitGB: een poging om de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 ElasticPoolsNotEnabled - Elastische pools zijn niet ingeschakeld in deze regio.

  • 400 ElasticPoolNotEmpty : aanvraag om een elastische pool te verwijderen die niet leeg is.

  • 400 ElasticPoolStorageBelowLimitGB: er wordt geprobeerd de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 ElasticPoolStorageNotAllowedGB: een poging om de opslaglimiet voor elastische pools in gb in te stellen die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolDatabaseLimit : de elastische pool heeft de limiet voor het aantal databases bereikt.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage : probeert de opslaglimiet van de elastische pool te verlagen tot onder het opslaggebruik.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax : er wordt geprobeerd de DTU min per database hoger in te stellen dan het DTU-maximum per database.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings : het aantal databases en het VCore-minimum per database mag niet groter zijn dan de aangevraagde VCores van de elastische pool.

  • 400 ElasticPoolStorageBelowLimitMB: er wordt geprobeerd de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 ElasticPoolStorageNotAllowedMB: er wordt geprobeerd de opslaglimiet voor de elastische pool in mb in te stellen die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolCapacityStorageNotAllowedMB: een poging om de opslaglimiet voor de elastische pool in mb in te stellen die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolStorageAboveLimitMB: er wordt geprobeerd de opslaglimiet voor elastische pools in te stellen onder de ondersteunde limiet.

  • 400 RegionDoesNotSupportVersion - Een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund.

  • 400 InvalidTier : de gebruiker heeft een ongeldige laag opgegeven.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded : de brondatabase mag geen hogere editie hebben dan de doeldatabase.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded : de doeldatabase mag geen lagere editie hebben dan de brondatabase.

  • 400 ElasticPoolUpdateHkNotAllowed - De elastische pool kan de servicelaag niet verlagen van Premium naar Standard of Basic, omdat een of meer databases gebruikmaken van objecten die zijn geoptimaliseerd voor geheugen.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress : de bewerking is niet toegestaan omdat de kopieer- of failoverbewerking voor de database '{0}' op server{1}' momenteel wordt uitgevoerd.

  • 400 RegionDoesNotAllowProvisioning - De geselecteerde locatie accepteert geen nieuwe Windows Azure SQL Database-servers. Dit kan op een later tijdstip veranderen.

  • 400 ElasticPoolOverFileSpace - Onvoldoende bestandsruimte in de elastische pool.

  • 400 ElasticPoolDbDtuMinBelowLimit: de aangevraagde DTU-min per database is te laag voor de servicelaag van de aangevraagde elastische pool.

  • 400 ElasticPoolDbVcoreMaxBelowLimit - Het aangevraagde VCore-maximum per database is te laag voor de aangevraagde servicelaag voor elastische pools.

  • 400 ElasticPoolDbVcoreMaxAboveLimit - Het aangevraagde VCore-maximum per database is te hoog voor de aangevraagde servicelaag voor elastische pools.

  • 400 InvalidInputValueForDatabaseVcoreMax: er wordt geprobeerd het VCore-maximum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 ElasticPoolDbVcoreMinBelowLimit - De aangevraagde VCore-min per database is te laag voor de aangevraagde servicelaag voor elastische pools.

  • 400 InvalidInputValueForDatabaseVcoreMin: een poging om het VCore-minimum per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Poging om GeoDR-koppeling in te stellen of SLO bij te werken voor enclave-database wordt alleen ondersteund wanneer beide databases worden uitgevoerd op hardware uit de DC-serie.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Een poging om het VCore-minimum per database hoger in te stellen dan het VCore-maximum per database.

  • 400 InvalidLicenseType - Gebruiker heeft geprobeerd een database of elastische pool te maken of bij te werken met een niet-ondersteund licentietype.

  • 400 ProvisioningDisabled - Geeft een foutbericht weer van de resource operation authorizer zoals het is, zonder wijzigingen

  • 400 InvalidPublicMaintenanceConfiguration - Gebruiker heeft geprobeerd een configuratie voor openbaar onderhoud op te geven die niet kan worden geconverteerd naar een interne id (onjuiste of verkeerde regio).

  • 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden

  • 404 ServerNotInSubscriptionResourceGroup: de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

  • 404 ElasticPoolNotFound - De opgegeven elastische pool bestaat niet voor de opgegeven server.

  • 404 OperationIdNotFound - De bewerking met id bestaat niet.

  • 404 ElasticPoolNotFound - De opgegeven elastische pool bestaat niet voor de opgegeven server.

  • 405 Niet ondersteund : deze functionaliteit wordt niet ondersteund.

  • 405 Niet ondersteund : deze functionaliteit wordt niet ondersteund.

  • 409 ElasticPoolBusy - Er is een beheerbewerking uitgevoerd op een elastische pool die bezet is.

  • 409 ServerDisabled - Server is uitgeschakeld.

  • 409 SimultaneousSkuChangeNotAllowed - Servicedoelstellingwijzigingsbewerkingen kunnen niet tegelijkertijd worden uitgevoerd op beide databases van een replicatierelatie.

  • 409 ElasticPoolUpdateLinksNotInCatchup - Kan elastische pool niet bijwerken terwijl een van de databases een failoverbewerking voor kopiëren of geo-replicatie uitvoert.

  • 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker.

  • 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.

  • 409 ElasticPoolBusy - Er is een beheerbewerking uitgevoerd op een elastische pool die bezet is.

  • 409 ServerDisabled - Server is uitgeschakeld.

  • 409 SimultaneousSkuChangeNotAllowed - Servicedoelstellingwijzigingsbewerkingen kunnen niet tegelijkertijd worden uitgevoerd op beide databases van een replicatierelatie.

  • 409 ElasticPoolUpdateLinksNotInCatchup - Kan elastische pool niet bijwerken terwijl een van de databases een failoverbewerking voor kopiëren of geo-replicatie uitvoert.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 500 ElasticPoolFailedMoveDbToElasticPool- Kan de database niet verplaatsen naar de elastische pool vanwege interne resourcebeperkingen. Dit kan een tijdelijke situatie zijn. Probeer het opnieuw.

  • 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.

  • 500 ElasticPoolFailedMoveDbToElasticPool- Kan de database niet verplaatsen naar de elastische pool vanwege interne resourcebeperkingen. Dit kan een tijdelijke situatie zijn. Probeer het opnieuw.

  • 503 ServiceTemporarilyUnavailable - Functie tijdelijk niet beschikbaar.

  • 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 503 ServiceTemporarilyUnavailable - Functie tijdelijk niet beschikbaar.

  • 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

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

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": "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"
  }
}
Status code:
202

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

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

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

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": "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"
  }
}
Status code:
202

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

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

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

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:
202

Definities

Name Description
ElasticPool

Een elastische pool.
ElasticPoolLicenseType

Het licentietype dat moet worden toegepast voor deze elastische pool.
ElasticPoolPerDatabaseSettings

Per database-instellingen van een elastische pool.
ElasticPoolState

De status van de elastische pool.
ElasticPoolUpdate

Een update van een elastische pool.
Sku

Een ARM-resource-SKU.

ElasticPool

Een elastische pool.

Name Type Description
id

string

Resource-id.
kind

string

Soort elastische pool. Dit zijn metagegevens die worden gebruikt voor de Azure Portal ervaring.
location

string

Resourcelocatie.
name

string

Resourcenaam.
properties.creationDate

string

De aanmaakdatum van de elastische pool (ISO8601-indeling).
properties.highAvailabilityReplicaCount

integer

Het aantal secundaire replica's dat is gekoppeld aan de elastische pool dat wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools.
properties.licenseType

ElasticPoolLicenseType

Het licentietype dat moet worden toegepast voor deze elastische pool.
properties.maintenanceConfigurationId

string

Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Deze configuratie definieert de periode waarin de onderhoudsupdates worden uitgevoerd.
properties.maxSizeBytes

integer

De opslaglimiet voor de elastische databasegroep in bytes.
properties.minCapacity

number

Minimale capaciteit die serverloze pool niet kleiner wordt, indien niet onderbroken
properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

De instellingen per database voor de elastische pool.
properties.state

ElasticPoolState

De status van de elastische pool.
properties.zoneRedundant

boolean

Of deze elastische pool zoneredundant is of niet, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones.
sku

Sku

De elastische pool-SKU.

De lijst met SKU's kan verschillen per regio en ondersteuningsaanbieding. Als u wilt bepalen welke SKU's (inclusief de SKU-naam, laag/editie, familie en capaciteit) beschikbaar zijn voor uw abonnement in een Azure-regio, gebruikt u de Capabilities_ListByLocation REST API of de volgende opdracht:

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

object

Resourcetags.
type

string

Resourcetype.

ElasticPoolLicenseType

Het licentietype dat moet worden toegepast voor deze elastische pool.

Name Type Description
BasePrice

string

LicenseIncluded

string

ElasticPoolPerDatabaseSettings

Per database-instellingen van een elastische pool.

Name Type Description
maxCapacity

number

De maximale capaciteit die een database kan gebruiken.
minCapacity

number

De minimale capaciteit is gegarandeerd voor alle databases.

ElasticPoolState

De status van de elastische pool.

Name Type Description
Creating

string

Disabled

string

Ready

string

ElasticPoolUpdate

Een update van een elastische pool.

Name Type Description
properties.highAvailabilityReplicaCount

integer

Het aantal secundaire replica's dat is gekoppeld aan de elastische pool dat wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools.
properties.licenseType

ElasticPoolLicenseType

Het licentietype dat moet worden toegepast voor deze elastische pool.
properties.maintenanceConfigurationId

string

Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Deze configuratie definieert de periode waarin de onderhoudsupdates worden uitgevoerd.
properties.maxSizeBytes

integer

De opslaglimiet voor de elastische databasegroep in bytes.
properties.minCapacity

number

Minimale capaciteit die serverloze pool niet kleiner wordt, indien niet onderbroken
properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

De instellingen per database voor de elastische pool.
properties.zoneRedundant

boolean

Of deze elastische pool zoneredundant is of niet, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones.
sku

Sku

Een ARM-resource-SKU.
tags

object

Resourcetags.

Sku

Een ARM-resource-SKU.

Name Type Description
capacity

integer

Capaciteit van de specifieke SKU.
family

string

Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan dat hier worden vastgelegd.
name

string

De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3.
size

string

Grootte van de specifieke SKU
tier

string

De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium.