Elastic Pools - List By Server

Service:

SQL Database

API-versie:

2021-11-01

Hiermee haalt u alle elastische pools in een server op.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
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.
$skip	query		integer int64	Het aantal elementen in de verzameling dat moet worden overgeslagen.

Antwoorden

Name	Type	Description
200 OK	ElasticPoolListResult	Geslaagd
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 aangevraagde servicelaag voor elastische pools. 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: er wordt geprobeerd het maximum aantal DTU's 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: er wordt geprobeerd het minimum aantal DTU's per database in te stellen voor de resourcegroep die niet overeenkomt met de toegestane waarden. 400 ElasticPoolInconsistentDtuGuaranteeSettings - Poging 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 : er wordt geprobeerd 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 : er wordt geprobeerd 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 : er wordt geprobeerd 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 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 : een poging om de opslaglimiet voor elastische pools in mb in te stellen die niet overeenkomt met de toegestane waarden. 400 ElasticPoolCapacityStorageNotAllowedMB : er wordt geprobeerd de opslaglimiet voor elastische pools 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 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 aangevraagde servicelaag voor elastische pools. 400 ElasticPoolDbVcoreMaxBelowLimit - Het aangevraagde VCore-maximum per database is te laag voor de servicelaag van de aangevraagde elastische pool. 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 servicelaag van de aangevraagde elastische pool. 400 InvalidInputValueForDatabaseVcoreMin: er wordt geprobeerd 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 enclavedatabase wordt alleen ondersteund wanneer beide databases worden uitgevoerd op hardware uit de DC-serie. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax : er wordt geprobeerd de VCore min 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 resourcebewerkings autoriseren 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 (onjuist 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. 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 - Wijzigingsbewerkingen voor servicedoelstelling 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. 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 maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 ElasticPoolFailedMoveDbToElasticPool - Kan de database niet verplaatsen naar een 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. 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

Get all elastic pools in a server

Voorbeeldaanvraag

HTTP

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

Java

/**
 * Samples for ElasticPools ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolListByServer.json
     */
    /**
     * Sample code: Get all elastic pools in a server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAllElasticPoolsInAServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().listByServer("sqlcrudtest-2369",
            "sqlcrudtest-8069", null, com.azure.core.util.Context.NONE);
    }
}

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

Voorbeeldrespons

Statuscode:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-2729",
      "name": "sqlcrudtest-2729",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "GP_Gen4_2",
        "tier": "GeneralPurpose",
        "capacity": 2
      },
      "properties": {
        "creationDate": "2017-02-10T01:27:21.32Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0.25,
          "maxCapacity": 1
        },
        "zoneRedundant": true,
        "licenseType": "LicenseIncluded"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-3191",
      "name": "sqlcrudtest-3191",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "BasicPool",
        "tier": "Basic",
        "capacity": 50
      },
      "properties": {
        "creationDate": "2017-02-10T01:26:26.45Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0,
          "maxCapacity": 5
        }
      }
    },
    {
      "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
        }
      }
    }
  ]
}

Definities

Name	Description
ElasticPool	Een elastische pool.
ElasticPoolLicenseType	Het licentietype dat moet worden toegepast voor deze elastische pool.
ElasticPoolListResult	Het resultaat van een aanvraag voor een lijst met elastische pools.
ElasticPoolPerDatabaseSettings	Per database-instellingen van een elastische pool.
ElasticPoolState	De status van de 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 waarop de onderhoudsupdates worden uitgevoerd.
properties.maxSizeBytes	integer	De opslaglimiet voor de elastische databasegroep in bytes.
properties.minCapacity	number	Minimale capaciteit van de serverloze pool wordt niet kleiner, 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 zone-redundant 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

ElasticPoolListResult

Het resultaat van een aanvraag voor een lijst met elastische pools.

Name	Type	Description
nextLink	string	Koppeling om de volgende pagina met resultaten op te halen.
value	ElasticPool[]	Matrix met resultaten.

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 voor alle databases is gegarandeerd.

ElasticPoolState

De status van de elastische pool.

Name	Type	Description
Creating	string
Disabled	string
Ready	string

Sku

Een ARM-resource-SKU.

Name	Type	Description
capacity	integer	Capaciteit van de specifieke SKU.
family	string	Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die 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.