Elastic Pools - Update
Aktualizuje elastyczną pulę.
PATCH 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. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
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.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.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 zasobu usługi ARM. |
|
tags |
object |
Tagi zasobów. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Zaktualizowano pulę elastyczną |
|
202 Accepted |
Akceptowane Nagłówki Location: string |
|
Other Status Codes |
Odpowiedzi na błędy: ***
|
Przykłady
Assigns maintenance configuration to an elastic pool.
Przykładowe żądanie
PATCH 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
{
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
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": "BasicPool",
"tier": "Basic",
"capacity": 50
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 5242880000,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 5
},
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-08-01
Resets maintenance configuration of an elastic pool to default.
Przykładowe żądanie
PATCH 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
{
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
}
}
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": "BasicPool",
"tier": "Basic",
"capacity": 50
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 5242880000,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 5
}
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-08-01
Update an elastic pool with all parameter
Przykładowe żądanie
PATCH 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
{
"sku": {
"name": "BC_Gen4",
"tier": "BusinessCritical",
"capacity": 2
},
"properties": {
"perDatabaseSettings": {
"minCapacity": 0.25,
"maxCapacity": 1
},
"zoneRedundant": true,
"licenseType": "LicenseIncluded"
}
}
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": "BC_Gen4",
"tier": "BusinessCritical",
"capacity": 2
},
"properties": {
"creationDate": "2017-02-10T01:27:21.32Z",
"state": "Ready",
"maxSizeBytes": 5242880000,
"perDatabaseSettings": {
"minCapacity": 0.25,
"maxCapacity": 1
},
"zoneRedundant": true,
"licenseType": "LicenseIncluded"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-10-01
Update an elastic pool with minimum parameters
Przykładowe żądanie
PATCH 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": "BasicPool",
"tier": "Basic",
"capacity": 50
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 5242880000,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 5
}
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-10-01
Update an elastic pool with preferred enclave type parameter as Default
Przykładowe żądanie
PATCH 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
{
"sku": {
"name": "GP_Gen5_4"
},
"properties": {
"preferredEnclaveType": "Default"
}
}
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",
"preferredEnclaveType": "Default"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2022-08-01
Update an elastic pool with preferred enclave type parameter as VBS
Przykładowe żądanie
PATCH 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
{
"sku": {
"name": "GP_Gen5_4"
},
"properties": {
"preferredEnclaveType": "VBS"
}
}
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",
"preferredEnclaveType": "VBS"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2022-08-01
Update an elastic pool with serverless properties
Przykładowe żądanie
PATCH 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
{
"sku": {
"name": "GP_S_Gen5_2",
"tier": "GeneralPurpose",
"capacity": 2
},
"properties": {
"minCapacity": 0.5,
"autoPauseDelay": 60,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 2,
"autoPauseDelay": 80
}
}
}
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-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 102400,
"minCapacity": 0.5,
"autoPauseDelay": 60,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 2,
"autoPauseDelay": 80
}
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2023-05-01
Update high availability replica count of a Hyperscale elastic pool.
Przykładowe żądanie
PATCH 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
{
"properties": {
"highAvailabilityReplicaCount": 2
}
}
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
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2021-08-01
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. |
Elastic |
Aktualizacja elastycznej puli. |
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 |
ElasticPoolUpdate
Aktualizacja elastycznej puli.
Nazwa | Typ | Opis |
---|---|---|
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.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.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 zasobu usługi ARM. |
|
tags |
object |
Tagi zasobów. |
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. |