Freigeben über

Elastic Pools - Get

  • Referenz
Dienst:
SQL Database
API-Version:
2021-11-01

Ruft einen Pool für elastische Datenbanken ab

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
elasticPoolName
 path True

string

Der Name des Pools für elastische Datenbanken.
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.

Antworten

Name Typ Beschreibung
200 OK

ElasticPool

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.

  • 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden.

  • 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 a Hyperscale elastic pool
Get an elastic pool

Get a Hyperscale elastic pool

Beispielanforderung

GET 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

Beispiel für eine Antwort

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

Get an elastic pool

Beispielanforderung

GET 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

Beispiel für eine Antwort

Statuscode:
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_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

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

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.