Elastic Pools - List By Server

Dienst:

SQL Database

API-Version:

2021-11-01

Ruft alle Pools für elastische Datenbanken auf einem Server ab.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.
$skip	query		integer int64	Die Anzahl der zu überspringenden Elemente in der Auflistung.

Antworten

Name	Typ	Beschreibung
200 OK	ElasticPoolListResult	Erfolgreich
Other Status Codes		Fehlerantworten: *** 400 ElasticPoolOverStorageUsage: Versucht, Daten in eine Datenbank zu schreiben, wenn das Speicherlimit des Pools für elastische Datenbanken erreicht wurde. 400 InvalidSku: Der Benutzer hat eine ungültige SKU angegeben. 400 InvalidTierSkuCombination: Die angegebene Ebene unterstützt die angegebene SKU nicht. 400 ServerQuotaExceeded: Der Server hat sein Limit für die zulässige Datenbankdurchsatzeinheit erreicht. 400 ElasticPoolAlreadyExists: Der Server enthält bereits einen Pool für elastische Datenbanken mit dem angegebenen Namen. 400 SubscriptionVcoreQuotaExceeded: Der Vorgang konnte nicht ausgeführt werden, da das Abonnement das zulässige vCore-Kontingent überschreiten würde. 400 InvalidInputValueForEdition: Die angegebene Edition wird für die Bereitstellung von Pools für elastische Datenbanken nicht unterstützt. 400 ElasticPoolDtuBelowLimit: Der angeforderte DTU-Wert ist zu niedrig für die angeforderte Dienstebene des Pools für elastische Datenbanken. 400 ElasticPoolDtuAboveLimit: Der angeforderte DTU-Wert ist zu hoch für die angeforderte Dienstebene des Pools für elastische Datenbanken. 400 InvalidMaxSize : Ungültige maximale Größe. 400 ElasticPoolDbDtuMaxBelowLimit: Die angeforderte DTU max pro Datenbank ist für die angeforderte Pooldienstebene für elastische Datenbanken zu niedrig. 400 ElasticPoolDbDtuMaxAboveLimit: Die angeforderte DTU max pro Datenbank ist zu hoch für die angeforderte Dienstebene des Pools für elastische Datenbanken. 400 InvalidInputValueForDatabaseDtuMax: Versucht, die DTU max pro Datenbank für den Ressourcenpool festzulegen, der nicht mit den zulässigen Werten übereinstimmt. 400 ElasticPoolDbDtuMinAboveLimit: Die angeforderte DTU-Mindestanzahl pro Datenbank ist für die angeforderte Dienstebene zu hoch. 400 ElasticPoolOverStorage: Versucht, Daten in eine Datenbank zu schreiben, wenn das Speicherlimit des Pools für elastische Datenbanken erreicht wurde. 400 InvalidInputValueForDatabaseDtuMin: Versucht, die DTU-Mindestanzahl pro Datenbank für den Ressourcenpool festzulegen, der nicht mit den zulässigen Werten übereinstimmt. 400 ElasticPoolInconsistentDtuGuaranteeSettings: Versucht, DTU min für Datenbanken im Pool für elastische Datenbanken bereitzustellen, die die angeforderten DTUs des Pools für elastische Datenbanken überschreitet. 400 ElasticPoolDtuUnsupported: Der Benutzer hat versucht, einen Pool für elastische Datenbanken mit einer DTU-Kapazität zu erstellen oder zu aktualisieren, die nicht unterstützt wird. 400 ElasticPoolStorageAboveLimitGB: Versucht, das Speicherlimit für elastische Pools unterhalb des unterstützten Grenzwerts festzulegen. 400 ElasticPoolsNotEnabled: Pools für elastische Datenbanken wurden in dieser Region nicht aktiviert. 400 ElasticPoolNotEmpty: Anforderung zum Löschen eines Pools für elastische Datenbanken, der nicht leer ist. 400 ElasticPoolStorageBelowLimitGB: Versucht, das Speicherlimit für elastische Pools unterhalb des unterstützten Grenzwerts festzulegen. 400 ElasticPoolStorageNotAllowedGB: Versucht, das Speicherlimit für elastische Pools in GB festzulegen, das nicht mit den zulässigen Werten übereinstimmt. 400 ElasticPoolDatabaseLimit: Der Pool für elastische Datenbanken hat sein Limit für die Anzahl der Datenbanken erreicht. 400 ElasticPoolDecreaseStorageLimitBelowUsage: Versucht, das Speicherlimit des Pools für elastische Datenbanken unter die Speicherauslastung zu senken. 400 InvalidInputValueDatabaseDtuMinLargerThanMax: Versucht, die DTU min pro Datenbank höher als die DTU max pro Datenbank festzulegen. 400 ElasticPoolInconsistentVcoreGuaranteeSettings: Die Anzahl von Datenbanken und VCore min pro Datenbank darf die angeforderten VCores des Pools für elastische Datenbanken nicht überschreiten. 400 ElasticPoolStorageBelowLimitMB: Versucht, das Speicherlimit für elastische Pools unterhalb des unterstützten Grenzwerts festzulegen. 400 ElasticPoolStorageNotAllowedMB: Versucht, das Speicherlimit für elastische Pools in MB festzulegen, das nicht mit den zulässigen Werten übereinstimmt. 400 ElasticPoolCapacityStorageNotAllowedMB: Versucht, das Speicherlimit für elastische Pools in MB festzulegen, das nicht mit den zulässigen Werten übereinstimmt. 400 ElasticPoolStorageAboveLimitMB: Versucht, das Speicherlimit für elastische Pools unterhalb des unterstützten Grenzwerts festzulegen. 400 RegionDoesNotSupportVersion: Ein Benutzer hat versucht, einen Server einer angegebenen Version an einem Speicherort zu erstellen, an dem diese Serverversion nicht unterstützt wird. 400 InvalidTier: Der Benutzer hat eine ungültige Ebene angegeben. 400 SourceDatabaseEditionCouldNotBeUpgraded: Die Quelldatenbank kann keine höhere Edition als die Zieldatenbank aufweisen. 400 TargetDatabaseEditionCouldNotBeDowngraded: Die Zieldatenbank kann keine niedrigere Edition als die Quelldatenbank aufweisen. 400 ElasticPoolUpdateHkNotAllowed: Der Pool für elastische Datenbanken kann seine Dienstebene nicht von Premium auf Standard oder Basic senken, da mindestens eine seiner Datenbanken speicheroptimierte Objekte verwendet. 400 UpdateNotAllowedIfGeoDrOperationInProgress: Der Vorgang ist nicht zulässig, da der Kopier- oder Failovervorgang für die Datenbank "{0}" auf dem Server "{1}" derzeit ausgeführt wird. 400 RegionDoesNotAllowProvisioning: Der ausgewählte Speicherort akzeptiert keine neuen Windows Azure SQL Datenbankserver. Dies kann sich zu einem späteren Zeitpunkt ändern. 400 ElasticPoolOverFileSpace: Unzureichender Dateispeicher im Pool für elastische Datenbanken. 400 ElasticPoolDbDtuMinBelowLimit: Die angeforderte DTU-Min. pro Datenbank ist für die angeforderte Pooldienstebene für elastische Datenbanken zu niedrig. 400 ElasticPoolDbVcoreMaxBelowLimit: Der angeforderte virtuelle Kern pro Datenbank ist für die angeforderte Pooldienstebene für elastische Datenbanken zu niedrig. 400 ElasticPoolDbVcoreMaxAboveLimit: Der angeforderte virtuelle Kern pro Datenbank ist für die angeforderte Pooldienstebene für elastische Datenbanken zu hoch. 400 InvalidInputValueForDatabaseVcoreMax: Versucht, den virtuellen Kern max pro Datenbank für den Ressourcenpool festzulegen, der nicht mit den zulässigen Werten übereinstimmt. 400 ElasticPoolDbVcoreMinBelowLimit: Die angeforderte Mindestanzahl pro Datenbank-VCore ist für die angeforderte Dienstebene des Pools für elastische Datenbanken zu niedrig. 400 InvalidInputValueForDatabaseVcoreMin: Versucht, die VCore-Mindestanzahl pro Datenbank für den Ressourcenpool festzulegen, der nicht mit den zulässigen Werten übereinstimmt. 400 PartnerDBNotCompatibleForSGXEnclave: Der Versuch, eine GeoDR-Verknüpfung festzulegen oder SLO für Enclave-fähige Datenbank zu aktualisieren, wird nur unterstützt, wenn beide Datenbanken auf Hardware der DC-Serie ausgeführt werden. 400 InvalidInputValueDatabaseVcoreMinLargerThanMax: Versucht, die VCore-Mindestanzahl pro Datenbank höher als die maximale VCore-Instanz pro Datenbank festzulegen. 400 InvalidLicenseType: Der Benutzer hat versucht, eine Datenbank oder einen Pool für elastische Datenbanken mit nicht unterstütztem Lizenztyp zu erstellen oder zu aktualisieren. 400 ProvisioningDisabled: Zeigt die Fehlermeldung vom Ressourcenbetriebsautorisierer unverändert an, ohne Änderungen 400 InvalidPublicMaintenanceConfiguration: Der Benutzer hat versucht, eine öffentliche Wartungskonfiguration anzugeben, die nicht in die interne ID konvertiert werden kann (fehlerhafte oder falsche Region). 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 ElasticPoolNotFound: Der angegebene Pool für elastische Datenbanken ist für den angegebenen Server nicht vorhanden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 405 NotSupported: Diese Funktionalität wird nicht unterstützt. 409 ElasticPoolBusy: Es wurde ein Verwaltungsvorgang für einen Pool für elastische Datenbanken versucht, der ausgelastet ist. 409 ServerDisabled: Server ist deaktiviert. 409 SimultaneousSkuChangeNotAllowed: Dienstzieländerungsvorgänge können nicht in beiden Datenbanken einer Replikationsbeziehung gleichzeitig ausgeführt werden. 409 ElasticPoolUpdateLinksNotInCatchup: Der Pool für elastische Datenbanken kann nicht aktualisiert werden, während eine seiner Datenbanken einen Kopier- oder Georeplikationsfailovervorgang ausführt. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 ElasticPoolFailedMoveDbToElasticPool: Fehler beim Verschieben der Datenbank in den Pool für elastische Datenbanken aufgrund interner Ressourceneinschränkungen. Dies kann eine vorübergehende Bedingung sein. Versuchen Sie es erneut. 500 OperationTimedOut: Timeout des Vorgangs und automatisches Rollback. Wiederholen Sie den Vorgang. 503 ServiceTemporarilyUnavailable: Feature vorübergehend nicht verfügbar. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Get all elastic pools in a server

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
ElasticPool	Ein Pool für elastische Datenbanken.
ElasticPoolLicenseType	Der Lizenztyp, der für diesen Pool für elastische Datenbanken angewendet werden soll.
ElasticPoolListResult	Das Ergebnis einer Poollistenanforderung für elastische Datenbanken.
ElasticPoolPerDatabaseSettings	Pro Datenbankeinstellungen eines Pools für elastische Datenbanken.
ElasticPoolState	Der Zustand des Pools für elastische Datenbanken.
Sku	Eine ARM-Ressourcen-SKU.

ElasticPool

Ein Pool für elastische Datenbanken.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
kind	string	Art des Pools für elastische Datenbanken. Dies sind Metadaten, die für die Azure-Portal-Benutzeroberfläche verwendet werden.
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties.creationDate	string	Das Erstellungsdatum des Pools für elastische Datenbanken (ISO8601 Format).
properties.highAvailabilityReplicaCount	integer	Die Anzahl der sekundären Replikate, die dem Pool für elastische Datenbanken zugeordnet sind und zur Bereitstellung von Hochverfügbarkeit verwendet werden. Gilt nur für Pools für elastische Hyperscale-Datenbanken.
properties.licenseType	ElasticPoolLicenseType	Der Lizenztyp, der für diesen Pool für elastische Datenbanken angewendet werden soll.
properties.maintenanceConfigurationId	string	Wartungskonfigurations-ID, die dem Pool für elastische Datenbanken zugewiesen ist. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates durchgeführt werden.
properties.maxSizeBytes	integer	Das Speicherlimit für den Pool für elastische Datenbanken in Bytes.
properties.minCapacity	number	Minimale Kapazität, die der serverlose Pool nicht kleiner wird, wenn nicht angehalten
properties.perDatabaseSettings	ElasticPoolPerDatabaseSettings	Die Einstellungen pro Datenbank für den Pool für elastische Datenbanken.
properties.state	ElasticPoolState	Der Zustand des Pools für elastische Datenbanken.
properties.zoneRedundant	boolean	Unabhängig davon, ob dieser Pool für elastische Datenbanken zonenredundant ist, werden die Replikate dieses Pools für elastische Datenbanken auf mehrere Verfügbarkeitszonen verteilt.
sku	Sku	Die SKU des Pools für elastische Datenbanken. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder den folgenden Befehl, um die SKUs (einschließlich SKU-Name, Tarif/Edition, Familie und Kapazität) zu ermitteln, die Capabilities_ListByLocation für Ihr Abonnement in einer Azure-Region verfügbar sind: az sql elastic-pool list-editions -l <location> -o table
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

ElasticPoolLicenseType

Der Lizenztyp, der für diesen Pool für elastische Datenbanken angewendet werden soll.

Name	Typ	Beschreibung
BasePrice	string
LicenseIncluded	string

ElasticPoolListResult

Das Ergebnis einer Poollistenanforderung für elastische Datenbanken.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	ElasticPool[]	Array von Ergebnissen.

ElasticPoolPerDatabaseSettings

Pro Datenbankeinstellungen eines Pools für elastische Datenbanken.

Name	Typ	Beschreibung
maxCapacity	number	Die maximale Kapazität, die eine Datenbank nutzen kann.
minCapacity	number	Die Mindestkapazität für alle Datenbanken ist garantiert.

ElasticPoolState

Der Zustand des Pools für elastische Datenbanken.

Name	Typ	Beschreibung
Creating	string
Disabled	string
Ready	string

Sku

Eine ARM-Ressourcen-SKU.

Name	Typ	Beschreibung
capacity	integer	Kapazität der jeweiligen SKU.
family	string	Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden.
name	string	Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3.
size	string	Größe der jeweiligen SKU
tier	string	Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium.