Elastic Pools - Get
Pobiera elastyczną pulę.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2023-08-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
elastic
|
path | True |
string |
Nazwa puli elastycznej. |
resource
|
path | True |
string |
Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu. |
server
|
path | True |
string |
Nazwa serwera. |
subscription
|
path | True |
string |
Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla żądania. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Zakończyła się pomyślnie |
|
Other Status Codes |
Odpowiedzi na błędy: ***
|
Przykłady
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
Przykładowe żądanie
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
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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
Przykładowa odpowiedź
{
"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
Przykładowe żądanie
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
Przykładowa odpowiedź
{
"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"
}
}
Definicje
Nazwa | Opis |
---|---|
Always |
Typ enklawy żądanej w puli elastycznej. |
Availability |
Określa strefę dostępności, do których jest przypięta replika podstawowa puli. |
Elastic |
Elastyczna pula. |
Elastic |
Typ licencji do zastosowania dla tej elastycznej puli. |
Elastic |
Ustawienia poszczególnych baz danych elastycznej puli. |
Elastic |
Stan puli elastycznej. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Sku |
Jednostka SKU zasobu usługi ARM. |
AlwaysEncryptedEnclaveType
Typ enklawy żądanej w puli elastycznej.
Wartość | Opis |
---|---|
Default | |
VBS |
AvailabilityZoneType
Określa strefę dostępności, do których jest przypięta replika podstawowa puli.
Wartość | Opis |
---|---|
1 | |
2 | |
3 | |
NoPreference |
ElasticPool
Elastyczna pula.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
kind |
string |
Rodzaj elastycznej puli. Są to metadane używane w środowisku witryny Azure Portal. |
location |
string |
Lokalizacja zasobu. |
name |
string |
Nazwa zasobu. |
properties.autoPauseDelay |
integer (int32) |
Czas w minutach, po którym pula elastyczna jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone |
properties.availabilityZone |
Określa strefę dostępności, do których jest przypięta replika podstawowa puli. |
|
properties.creationDate |
string (date-time) |
Data utworzenia elastycznej puli (format ISO8601). |
properties.highAvailabilityReplicaCount |
integer (int32) |
Liczba replik pomocniczych skojarzonych z elastyczną pulą warstwy Krytyczne dla działania firmy, Premium lub Hiperskala, która jest używana do zapewnienia wysokiej dostępności. Dotyczy tylko elastycznych pul hiperskala. |
properties.licenseType |
Typ licencji do zastosowania dla tej elastycznej puli. |
|
properties.maintenanceConfigurationId |
string |
Identyfikator konfiguracji konserwacji przypisany do elastycznej puli. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji. |
properties.maxSizeBytes |
integer (int64) |
Limit magazynu dla elastycznej puli bazy danych w bajtach. |
properties.minCapacity |
number (double) |
Minimalna pojemność, którą pula bezserwerowa nie zmniejszy się poniżej, jeśli nie zostanie wstrzymana |
properties.perDatabaseSettings |
Ustawienia poszczególnych baz danych dla elastycznej puli. |
|
properties.preferredEnclaveType |
Typ enklawy żądanej w puli elastycznej. |
|
properties.state |
Stan puli elastycznej. |
|
properties.zoneRedundant |
boolean |
Niezależnie od tego, czy ta elastyczna pula jest strefowo nadmiarowa, co oznacza, że repliki tej elastycznej puli będą rozłożone na wiele stref dostępności. |
sku |
Jednostka SKU puli elastycznej. Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST
|
|
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. |
ElasticPoolLicenseType
Typ licencji do zastosowania dla tej elastycznej puli.
Wartość | Opis |
---|---|
BasePrice | |
LicenseIncluded |
ElasticPoolPerDatabaseSettings
Ustawienia poszczególnych baz danych elastycznej puli.
Nazwa | Typ | Opis |
---|---|---|
autoPauseDelay |
integer (int32) |
Automatyczne wstrzymywanie opóźnienia dla bazy danych w puli |
maxCapacity |
number (double) |
Maksymalna pojemność, jaką może zużywać dowolna baza danych. |
minCapacity |
number (double) |
Minimalna pojemność wszystkich baz danych jest gwarantowana. |
ElasticPoolState
Stan puli elastycznej.
Wartość | Opis |
---|---|
Creating | |
Disabled | |
Ready |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt błędu. |
Sku
Jednostka SKU zasobu usługi ARM.
Nazwa | Typ | Opis |
---|---|---|
capacity |
integer (int32) |
Pojemność określonej jednostki SKU. |
family |
string |
Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. |
name |
string |
Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. |
size |
string |
Rozmiar konkretnej jednostki SKU |
tier |
string |
Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. |