Elastic Pools - Get
Ruft einen elastischen Pool ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2023-08-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
elastic
|
path | True |
string |
Der Name des elastischen Pools. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen. |
server
|
path | True |
string |
Der Name des Servers. |
subscription
|
path | True |
string |
Die Abonnement-ID, die ein Azure-Abonnement identifiziert. |
api-version
|
query | True |
string |
Die API-Version, die für die Anforderung verwendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Gelungen |
|
Other Status Codes |
Fehlerantworten: ***
|
Beispiele
Get a Hyperscale elastic pool |
Get an elastic pool |
Get an elastic pool with Availability Zone |
Get an elastic pool with preferred enclave type parameter |
Get an elastic pool with serverless properties |
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=2023-08-01
Beispiel für eine Antwort
{
"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=2023-08-01
Beispiel für eine Antwort
{
"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"
}
}
Get an elastic pool with Availability Zone
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=2023-08-01
Beispiel für eine Antwort
{
"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",
"availabilityZone": "1"
}
}
Get an elastic pool with preferred enclave type parameter
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=2023-08-01
Beispiel für eine Antwort
{
"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": "GP_Gen5",
"tier": "GeneralPurpose",
"family": "Gen5",
"capacity": 4
},
"properties": {
"state": "Ready",
"creationDate": "2022-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,
"preferredEnclaveType": "VBS"
}
}
Get an elastic pool with serverless properties
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=2023-08-01
Beispiel für eine Antwort
{
"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_S_Gen5_2",
"tier": "GeneralPurpose",
"capacity": 2
},
"properties": {
"creationDate": "2017-10-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 5242880000,
"minCapacity": 0.5,
"autoPauseDelay": 60,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 1,
"autoPauseDelay": 60
},
"zoneRedundant": true,
"licenseType": "LicenseIncluded",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
Definitionen
Name | Beschreibung |
---|---|
Always |
Typ der Enklave auf dem elastischen Pool angefordert. |
Availability |
Gibt die Verfügbarkeitszone an, an die das primäre Replikat des Pools angeheftet ist. |
Elastic |
Ein elastischer Pool. |
Elastic |
Der Lizenztyp, der für diesen elastischen Pool gilt. |
Elastic |
Pro Datenbankeinstellungen eines elastischen Pools. |
Elastic |
Der Zustand des elastischen Pools. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
Sku |
Eine ARM-Ressourcen-SKU. |
AlwaysEncryptedEnclaveType
Typ der Enklave auf dem elastischen Pool angefordert.
Wert | Beschreibung |
---|---|
Default | |
VBS |
AvailabilityZoneType
Gibt die Verfügbarkeitszone an, an die das primäre Replikat des Pools angeheftet ist.
Wert | Beschreibung |
---|---|
1 | |
2 | |
3 | |
NoPreference |
ElasticPool
Ein elastischer Pool.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID. |
kind |
string |
Art des elastischen Pools. Dies sind Metadaten, die für die Azure-Portaloberfläche verwendet werden. |
location |
string |
Ressourcenspeicherort. |
name |
string |
Ressourcenname. |
properties.autoPauseDelay |
integer (int32) |
Die Zeit in Minuten, nach der der elastische Pool automatisch angehalten wird. Ein Wert von -1 bedeutet, dass die automatische Pause deaktiviert ist. |
properties.availabilityZone |
Gibt die Verfügbarkeitszone an, an die das primäre Replikat des Pools angeheftet ist. |
|
properties.creationDate |
string (date-time) |
Das Erstellungsdatum des elastischen Pools (ISO8601 Format). |
properties.highAvailabilityReplicaCount |
integer (int32) |
Die Anzahl der sekundären Replikate, die dem elastischen Business Critical-, Premium- oder Hyperscale Edition-Pool zugeordnet sind, der verwendet wird, um hohe Verfügbarkeit bereitzustellen. Gilt nur für hyperskalenlastische Pools. |
properties.licenseType |
Der Lizenztyp, der für diesen elastischen Pool gilt. |
|
properties.maintenanceConfigurationId |
string |
Die Wartungskonfigurations-ID, die dem elastischen Pool zugewiesen ist. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates auftreten. |
properties.maxSizeBytes |
integer (int64) |
Der Speichergrenzwert für den datenbanklastischen Pool in Byte. |
properties.minCapacity |
number (double) |
Minimale Kapazität, die serverlose Pools nicht verkleinern, wenn nicht angehalten |
properties.perDatabaseSettings |
Die Einstellungen pro Datenbank für den elastischen Pool. |
|
properties.preferredEnclaveType |
Typ der Enklave auf dem elastischen Pool angefordert. |
|
properties.state |
Der Zustand des elastischen Pools. |
|
properties.zoneRedundant |
boolean |
Unabhängig davon, ob dieser elastische Pool zonenredundant ist, bedeutet dies, dass die Replikate dieses elastischen Pools über mehrere Verfügbarkeitszonen verteilt werden. |
sku |
Die SKU des elastischen Pools. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Ebene/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die
|
|
tags |
object |
Ressourcentags. |
type |
string |
Ressourcentyp. |
ElasticPoolLicenseType
Der Lizenztyp, der für diesen elastischen Pool gilt.
Wert | Beschreibung |
---|---|
BasePrice | |
LicenseIncluded |
ElasticPoolPerDatabaseSettings
Pro Datenbankeinstellungen eines elastischen Pools.
Name | Typ | Beschreibung |
---|---|---|
autoPauseDelay |
integer (int32) |
Automatische Pausenverzögerung pro Datenbank innerhalb des Pools |
maxCapacity |
number (double) |
Die maximale Kapazität jeder Datenbank kann verbrauchen. |
minCapacity |
number (double) |
Die Mindestkapazität aller Datenbanken ist gewährleistet. |
ElasticPoolState
Der Zustand des elastischen Pools.
Wert | Beschreibung |
---|---|
Creating | |
Disabled | |
Ready |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
Sku
Eine ARM-Ressourcen-SKU.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer (int32) |
Kapazität der jeweiligen SKU. |
family |
string |
Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU 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 |
Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium. |