Elastic Pools - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Skapar eller uppdaterar en elastisk pool.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
elasticPoolName	path	True	string	Namnet på den elastiska poolen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Resursplats.
properties.highAvailabilityReplicaCount		integer	Antalet sekundära repliker som är associerade med den elastiska poolen som används för att tillhandahålla hög tillgänglighet. Gäller endast för elastiska pooler i Hyperskala.
properties.licenseType		ElasticPoolLicenseType	Licenstypen som ska gälla för den här elastiska poolen.
properties.maintenanceConfigurationId		string	Underhållskonfigurations-ID som tilldelats den elastiska poolen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske.
properties.maxSizeBytes		integer	Lagringsgränsen för databasens elastiska pool i byte.
properties.minCapacity		number	Minimal kapacitet som den serverlösa poolen inte krymper under, om den inte är pausad
properties.perDatabaseSettings		ElasticPoolPerDatabaseSettings	Inställningarna per databas för den elastiska poolen.
properties.zoneRedundant		boolean	Oavsett om den här elastiska poolen är zonredundant eller inte, vilket innebär att replikerna i den elastiska poolen sprids över flera tillgänglighetszoner.
sku		Sku	SKU:n för elastisk pool. Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure-region använder Capabilities_ListByLocation du REST-API:et eller följande kommando: az sql elastic-pool list-editions -l <location> -o table
tags		object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	ElasticPool	Den elastiska poolen har uppdaterats
201 Created	ElasticPool	Den elastiska poolen skapades
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 ElasticPoolOverStorageUsage – Försöker skriva data till en databas när lagringsgränsen för den elastiska poolen har nåtts. 400 InvalidSku – Användaren har angett en ogiltig SKU. 400 InvalidTierSkuCombination – Den angivna nivån stöder inte angiven sku. 400 ServerQuotaExceeded – Servern har nått sin gräns för tillåten databasflödesenhet. 400 ElasticPoolAlreadyExists – Servern innehåller redan en elastisk pool med det angivna namnet. 400 SubscriptionVcoreQuotaExceeded – Det gick inte att utföra åtgärden eftersom prenumerationen skulle överskrida den tillåtna kvoten för virtuell kärna. 400 InvalidInputValueForEdition – den angivna utgåvan stöds inte för etablering av elastisk pool. 400 ElasticPoolDtuBelowLimit – det begärda DTU-värdet är för lågt för den begärda elastiska pooltjänstnivån. 400 ElasticPoolDtuAboveLimit – det begärda DTU-värdet är för högt för den begärda elastiska pooltjänstnivån. 400 InvalidMaxSize – ogiltig maxstorlek. 400 ElasticPoolDbDtuMaxBelowLimit – det begärda DTU-maxvärdet per databas är för lågt för den begärda elastiska pooltjänstnivån. 400 ElasticPoolDbDtuMaxAboveLimit – det begärda DTU-maxvärdet per databas är för högt för den begärda tjänstnivån för elastisk pool. 400 InvalidInputValueForDatabaseDtuMax – Försöker ange DTU:ens maxvärde per databas för resurspoolen som inte matchar de tillåtna värdena. 400 ElasticPoolDbDtuMinAboveLimit – den begärda DTU:en min per databas är för hög för den begärda tjänstnivån. 400 ElasticPoolOverStorage – Försöker skriva data till en databas när lagringsgränsen för den elastiska poolen har nåtts. 400 InvalidInputValueForDatabaseDtuMin – Försöker ange DTU:en min per databas för resurspoolen som inte matchar de tillåtna värdena. 400 ElasticPoolInconsistentDtuGuaranteeSettings – Försöker ange DTU min för databaser i den elastiska poolen som överskrider begärda DTU:er för den elastiska poolen. 400 ElasticPoolDtuUnsupported – Användaren försökte skapa eller uppdatera en elastisk pool med en DTU-kapacitet som inte stöds. 400 ElasticPoolStorageAboveLimitGB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds. 400 ElasticPoolsNotEnabled – Elastiska pooler har inte aktiverats i den här regionen. 400 ElasticPoolNotEmpty – Begäran om att ta bort en elastisk pool som inte är tom. 400 ElasticPoolStorageBelowLimitGB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds. 400 ElasticPoolStorageNotAllowedGB – Försöker ange den elastiska poollagringsgränsen i GB som inte matchar de tillåtna värdena. 400 ElasticPoolDatabaseLimit – Den elastiska poolen har nått sin gräns för antalet databaser. 400 ElasticPoolDecreaseStorageLimitBelowUsage – Försöker minska lagringsgränsen för den elastiska poolen under dess lagringsanvändning. 400 InvalidInputValueDatabaseDtuMinLargerThanMax – Försöker ställa in DTU min per databas högre än DTU-maxvärdet per databas. 400 ElasticPoolInconsistentVcoreGuaranteeSettings – Antalet databaser och virtuella kärnor min per databas får inte överskrida begärda virtuella kärnor i den elastiska poolen. 400 ElasticPoolStorageBelowLimitMB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds. 400 ElasticPoolStorageNotAllowedMB – Försöker ange lagringsgränsen för elastisk pool i MB som inte matchar de tillåtna värdena. 400 ElasticPoolCapacityStorageNotAllowedMB – Försöker ange lagringsgränsen för elastisk pool i MB som inte matchar de tillåtna värdena. 400 ElasticPoolStorageAboveLimitMB – Försöker ställa in lagringsgränsen för elastisk pool under gränsen som stöds. 400 RegionDoesNotSupportVersion – En användare försökte skapa en server med en angiven version på en plats där serverversionen inte stöds. 400 InvalidTier – Användaren har angett en ogiltig nivå. 400 SourceDatabaseEditionCouldNotBeUpgraded – Källdatabasen får inte ha en högre utgåva än måldatabasen. 400 TargetDatabaseEditionCouldNotBeDowngraded – Måldatabasen får inte ha en lägre utgåva än källdatabasen. 400 ElasticPoolUpdateHkNotAllowed – Den elastiska poolen kan inte sänka tjänstnivån från Premium till Standard eller Basic eftersom en eller flera av databaserna använder minnesoptimerade objekt. 400 UpdateNotAllowedIfGeoDrOperationInProgress – Åtgärden tillåts inte eftersom kopierings- eller redundansåtgärd för databasen på{0} servern{1} pågår. 400 RegionDoesNotAllowProvisioning – Den valda platsen accepterar inte nya Windows Azure SQL Database-servrar. Detta kan ändras vid ett senare tillfälle. 400 ElasticPoolOverFileSpace – Otillräckligt filutrymme i den elastiska poolen. 400 ElasticPoolDbDtuMinBelowLimit – den begärda DTU-min per databas är för låg för den begärda tjänstnivån för elastisk pool. 400 ElasticPoolDbVcoreMaxBelowLimit – det begärda maxvärdet per databas för virtuell kärna är för lågt för den begärda tjänstnivån för elastisk pool. 400 ElasticPoolDbVcoreMaxAboveLimit – det begärda maxvärdet per databas för virtuell kärna är för högt för den begärda tjänstnivån för elastisk pool. 400 InvalidInputValueForDatabaseVcoreMax – Försöker ange maxvärdet för virtuell kärna per databas för resurspoolen som inte matchar de tillåtna värdena. 400 ElasticPoolDbVcoreMinBelowLimit – den begärda virtuella kärnan per databas min är för låg för den begärda tjänstnivån för elastisk pool. 400 InvalidInputValueForDatabaseVcoreMin – Försöker ange den virtuella kärnan min per databas för resurspoolen som inte matchar de tillåtna värdena. 400 PartnerDBNotCompatibleForSGXEnclave – Försök att ange GeoDR-länk eller uppdatera SLO för enklavaktiverad databas stöds bara när båda databaserna körs på dc-seriens maskinvara. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – Försöker ange den virtuella kärnan min per databas som är högre än det högsta antalet virtuella kärnor per databas. 400 InvalidLicenseType – Användaren försökte skapa eller uppdatera en databas eller elastisk pool med en licenstyp som inte stöds. 400 ProvisioningDisabled – visar felmeddelandet från resursåtgärden authorizer som den är, utan ändringar 400 InvalidPublicMaintenanceConfiguration – Användaren försökte ange konfiguration för offentligt underhåll som inte kan konverteras till internt ID (felaktigt format eller fel region). 400 InvalidResourceRequestBody – Resursen eller resursegenskaperna i begärandetexten är tomma eller ogiltiga. 400 InvalidResourceId – Ogiltig resursidentifierare. 400 InvalidSkuName – ogiltigt SKU-namn. 400 MismatchedSkuNameAndCapacity – Matchningsfel mellan SKU-namn och kapacitet. 400 MismatchedSkuNameAndTier – Matchningsfel mellan SKU-namn och nivå. 400 MismatchedSkuNameAndFamily – Matchningsfel mellan SKU-namn och familj. 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en. 400 ElasticPoolOverStorageUsage – Försöker skriva data till en databas när lagringsgränsen för den elastiska poolen har nåtts. 400 InvalidSku – användaren angav en ogiltig sku. 400 InvalidTierSkuCombination – den angivna nivån stöder inte angiven sku. 400 ServerQuotaExceeded – Servern har nått sin gräns för tillåten databasdataflödesenhet. 400 ElasticPoolAlreadyExists – Servern innehåller redan en elastisk pool med det angivna namnet. 400 SubscriptionVcoreQuotaExceeded – Det gick inte att utföra åtgärden eftersom prenumerationen skulle överskrida den tillåtna kvoten för virtuell kärna. 400 InvalidInputValueForEdition – angiven utgåva stöds inte för elastisk pooletablering. 400 ElasticPoolDtuBelowLimit – det begärda DTU-värdet är för lågt för den begärda tjänstnivån för elastisk pool. 400 ElasticPoolDtuAboveLimit – det begärda DTU-värdet är för högt för den begärda tjänstnivån för elastisk pool. 400 InvalidMaxSize – Ogiltig maxstorlek. 400 ElasticPoolDbDtuMaxBelowLimit – det begärda DTU-maxvärdet per databas är för lågt för den begärda tjänstnivån för elastisk pool. 400 ElasticPoolDbDtuMaxAboveLimit – det begärda DTU-maxvärdet per databas är för högt för den begärda tjänstnivån för elastisk pool. 400 InvalidInputValueForDatabaseDtuMax – Försöker ange DTU-max per databas för resurspoolen som inte matchar de tillåtna värdena. 400 ElasticPoolDbDtuMinAboveLimit – den begärda DTU:en min per databas är för hög för den begärda tjänstnivån. 400 ElasticPoolOverStorage – Försöker skriva data till en databas när lagringsgränsen för den elastiska poolen har nåtts. 400 InvalidInputValueForDatabaseDtuMin – Försöker ange DTU-min per databas för resurspoolen som inte matchar de tillåtna värdena. 400 ElasticPoolInconsistentDtuGuaranteeSettings – Försöker ange DTU min för databaser i den elastiska poolen som överskrider begärda DTU:er för den elastiska poolen. 400 ElasticPoolDtuUnsupported – Användaren försökte skapa eller uppdatera en elastisk pool med en DTU-kapacitet som inte stöds. 400 ElasticPoolStorageAboveLimitGB – Försöker ange lagringsgränsen för elastisk pool under gränsen som stöds. 400 ElasticPoolsNotEnabled – Elastiska pooler har inte aktiverats i den här regionen. 400 ElasticPoolNotEmpty – Begäran om att ta bort en elastisk pool som inte är tom. 400 ElasticPoolStorageBelowLimitGB – Försöker ange lagringsgränsen för elastisk pool under gränsen som stöds. 400 ElasticPoolStorageNotAllowedGB – Försöker ange den elastiska poollagringsgränsen i gb som inte matchar de tillåtna värdena. 400 ElasticPoolDatabaseLimit – Den elastiska poolen har nått sin gräns för antalet databaser. 400 ElasticPoolDecreaseStorageLimitBelowUsage – Försöker minska lagringsgränsen för den elastiska poolen under lagringsanvändningen. 400 InvalidInputValueDatabaseDtuMinLargerThanMax – Försöker ange DTU min per databas som är högre än DTU-maxvärdet per databas. 400 ElasticPoolInconsistentVcoreGuaranteeSettings – Antalet databaser och virtuella kärnor min per databas får inte överskrida begärda virtuella kärnor i den elastiska poolen. 400 ElasticPoolStorageBelowLimitMB – Försöker ange lagringsgränsen för elastisk pool under gränsen som stöds. 400 ElasticPoolStorageNotAllowedMB – Försöker ange den elastiska poollagringsgränsen i mb som inte matchar de tillåtna värdena. 400 ElasticPoolCapacityStorageNotAllowedMB – Försöker ange lagringsgränsen för elastisk pool i mb som inte matchar de tillåtna värdena. 400 ElasticPoolStorageAboveLimitMB – Försöker ange lagringsgränsen för elastisk pool under gränsen som stöds. 400 RegionDoesNotSupportVersion – En användare försökte skapa en server med en angiven version på en plats där serverversionen inte stöds. 400 InvalidTier – användaren angav en ogiltig nivå. 400 SourceDatabaseEditionCouldNotBeUpgraded – Källdatabasen får inte ha en högre utgåva än måldatabasen. 400 TargetDatabaseEditionCouldNotBeDowngraded – Måldatabasen får inte ha en lägre utgåva än källdatabasen. 400 ElasticPoolUpdateHkNotAllowed – Den elastiska poolen kan inte sänka tjänstnivån från Premium till Standard eller Basic eftersom en eller flera av databaserna använder minnesoptimerade objekt. 400 UpdateNotAllowedIfGeoDrOperationInProgress – Åtgärden tillåts inte eftersom kopierings- eller redundansåtgärden för databasen på{0} servern{1} pågår. 400 RegionDoesNotAllowProvisioning – Den valda platsen accepterar inte nya Windows Azure SQL Database-servrar. Detta kan ändras vid ett senare tillfälle. 400 ElasticPoolOverFileSpace – Otillräckligt filutrymme i den elastiska poolen. 400 ElasticPoolDbDtuMinBelowLimit – den begärda DTU-min per databas är för låg för den begärda tjänstnivån för elastisk pool. 400 ElasticPoolDbVcoreMaxBelowLimit – det begärda maxvärdet per databas för virtuell kärna är för lågt för den begärda tjänstnivån för elastisk pool. 400 ElasticPoolDbVcoreMaxAboveLimit – det begärda maxvärdet per databas för virtuell kärna är för högt för den begärda tjänstnivån för elastisk pool. 400 InvalidInputValueForDatabaseVcoreMax – Försöker ange maxvärdet för virtuell kärna per databas för resurspoolen som inte matchar de tillåtna värdena. 400 ElasticPoolDbVcoreMinBelowLimit – den begärda virtuella kärnor per databas är för låg för den begärda tjänstnivån för elastisk pool. 400 InvalidInputValueForDatabaseVcoreMin – Försöker ange den virtuella kärnor min per databas för resurspoolen som inte matchar de tillåtna värdena. 400 PartnerDBNotCompatibleForSGXEnclave – Försök att ange GeoDR-länk eller uppdatera SLO för enklaveraktiverad databas stöds bara när båda databaserna körs på DC-seriens maskinvara. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – Försöker ange den virtuella kärnor min per databas högre än det maximala antalet virtuella kärnor per databas. 400 InvalidLicenseType – Användaren försökte skapa eller uppdatera en databas eller elastisk pool med licenstyp som inte stöds. 400 ProvisioningDisabled – Visar felmeddelande från resursåtgärdsauktoriseraren som den är, utan ändringar 400 InvalidPublicMaintenanceConfiguration – Användaren försökte ange konfiguration för offentligt underhåll som inte kan konverteras till internt ID (felaktigt format eller fel region). 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 ElasticPoolNotFound – den angivna elastiska poolen finns inte för den angivna servern. 404 OperationIdNotFound – Åtgärden med ID finns inte. 404 ElasticPoolNotFound – den angivna elastiska poolen finns inte för den angivna servern. 405 NotSupported – Den här funktionen stöds inte. 405 NotSupported – Den här funktionen stöds inte. 409 ElasticPoolBusy – En hanteringsåtgärd försökte utföras på en elastisk pool som är upptagen. 409 ServerDisabled – Servern är inaktiverad. 409 SimultaneousSkuChangeNotAllowed – Tjänstens måländringsåtgärder kan inte köras på båda databaserna i en replikeringsrelation samtidigt. 409 ElasticPoolUpdateLinksNotInCatchup – Det går inte att uppdatera den elastiska poolen medan en av databaserna utför en redundansåtgärd för kopiering eller geo-replikering. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 409 ElasticPoolBusy – En hanteringsåtgärd försökte utföras på en elastisk pool som är upptagen. 409 ServerDisabled – Servern är inaktiverad. 409 SimultaneousSkuChangeNotAllowed – Tjänstens måländringsåtgärder kan inte köras på båda databaserna i en replikeringsrelation samtidigt. 409 ElasticPoolUpdateLinksNotInCatchup – Det går inte att uppdatera den elastiska poolen medan en av databaserna utför en redundansåtgärd för kopiering eller geo-replikering. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 ElasticPoolFailedMoveDbToElasticPool – Det gick inte att flytta databasen till elastisk pool på grund av interna resursbegränsningar. Detta kan vara ett tillfälligt villkor. Försök igen. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 500 ElasticPoolFailedMoveDbToElasticPool – Det gick inte att flytta databasen till elastisk pool på grund av interna resursbegränsningar. Detta kan vara ett tillfälligt villkor. Försök igen. 503 ServiceTemporarilyUnavailable – Funktionen är inte tillgänglig för tillfället. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 ServiceTemporarilyUnavailable – Funktionen är inte tillgänglig för tillfället. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Create or update elastic pool with all parameter

Create or update elastic pool with maintenance configuration parameter

Create or update elastic pool with minimum parameters

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

Create or update elastic pool with all parameter

Sample Request

HTTP

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

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

Java

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

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

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

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

Create or update elastic pool with maintenance configuration parameter

Sample Request

HTTP

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

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

Java

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

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

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

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

Create or update elastic pool with minimum parameters

Sample Request

HTTP

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

{
  "location": "Japan East"
}

Java

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

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

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

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

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

Sample Request

HTTP

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

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

Java

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

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

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

Sample Response

Status code:

200

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

Status code:

201

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

Status code:

202

Definitioner

Name	Description
ElasticPool	En elastisk pool.
ElasticPoolLicenseType	Licenstypen som ska gälla för den här elastiska poolen.
ElasticPoolPerDatabaseSettings	Per databasinställningar för en elastisk pool.
ElasticPoolState	Status för den elastiska poolen.
Sku	En ARM-resurs-SKU.

ElasticPool

En elastisk pool.

Name	Typ	Description
id	string	Resurs-ID.
kind	string	Typ av elastisk pool. Det här är metadata som används för Azure Portal upplevelse.
location	string	Resursplats.
name	string	Resursnamn.
properties.creationDate	string	Skapandedatumet för den elastiska poolen (ISO8601 format).
properties.highAvailabilityReplicaCount	integer	Antalet sekundära repliker som är associerade med den elastiska poolen som används för att tillhandahålla hög tillgänglighet. Gäller endast för elastiska pooler i Hyperskala.
properties.licenseType	ElasticPoolLicenseType	Licenstypen som ska gälla för den här elastiska poolen.
properties.maintenanceConfigurationId	string	Underhållskonfigurations-ID som tilldelats den elastiska poolen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske.
properties.maxSizeBytes	integer	Lagringsgränsen för databasens elastiska pool i byte.
properties.minCapacity	number	Minimal kapacitet som den serverlösa poolen inte krymper under, om den inte är pausad
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	Inställningarna per databas för den elastiska poolen.
properties.state	ElasticPoolState	Status för den elastiska poolen.
properties.zoneRedundant	boolean	Oavsett om den här elastiska poolen är zonredundant eller inte, vilket innebär att replikerna i den elastiska poolen sprids över flera tillgänglighetszoner.
sku	Sku	SKU:n för elastisk pool. Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure-region använder Capabilities_ListByLocation du REST-API:et eller följande kommando: az sql elastic-pool list-editions -l <location> -o table
tags	object	Resurstaggar.
type	string	Resurstyp.

ElasticPoolLicenseType

Licenstypen som ska gälla för den här elastiska poolen.

Name	Typ	Description
BasePrice	string
LicenseIncluded	string

ElasticPoolPerDatabaseSettings

Per databasinställningar för en elastisk pool.

Name	Typ	Description
maxCapacity	number	Den maximala kapaciteten som en databas kan använda.
minCapacity	number	Den minsta kapaciteten som alla databaser garanteras.

ElasticPoolState

Status för den elastiska poolen.

Name	Typ	Description
Creating	string
Disabled	string
Ready	string

Sku

En ARM-resurs-SKU.

Name	Typ	Description
capacity	integer	Kapacitet för den specifika SKU:n.
family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
name	string	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.
size	string	Storleken på den specifika SKU:n
tier	string	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.