Elastic Pools - Update
Uppdaterar en elastisk pool.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2023-08-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
elastic
|
path | True |
string |
Namnet på den elastiska poolen. |
resource
|
path | True |
string |
Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen. |
server
|
path | True |
string |
Namnet på servern. |
subscription
|
path | True |
string |
Det prenumerations-ID som identifierar en Azure-prenumeration. |
api-version
|
query | True |
string |
DEN API-version som ska användas för begäran. |
Begärandetext
Name | Typ | Description |
---|---|---|
properties.autoPauseDelay |
integer (int32) |
Tid i minuter efter vilken den elastiska poolen pausas automatiskt. Värdet -1 innebär att automatisk paus är inaktiverad |
properties.availabilityZone |
Anger tillgänglighetszonen som poolens primära replik är fäst vid. |
|
properties.highAvailabilityReplicaCount |
integer (int32) |
Antalet sekundära repliker som är associerade med den elastiska poolen Business Critical, Premium eller Hyperscale Edition som används för att ge hög tillgänglighet. Gäller endast för elastiska Hyperskala-pooler. |
properties.licenseType |
Licenstypen som ska tillämpas för den här elastiska poolen. |
|
properties.maintenanceConfigurationId |
string |
Underhållskonfigurations-ID som tilldelats den elastiska poolen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske. |
properties.maxSizeBytes |
integer (int64) |
Lagringsgränsen för databasens elastiska pool i byte. |
properties.minCapacity |
number (double) |
Minimal kapacitet som den serverlösa poolen inte krymper under, om den inte är pausad |
properties.perDatabaseSettings |
Inställningarna per databas för den elastiska poolen. |
|
properties.preferredEnclaveType |
Typ av enklav som begärs i den elastiska poolen. |
|
properties.zoneRedundant |
boolean |
Om den här elastiska poolen är zonredundant, vilket innebär att replikerna i den här elastiska poolen sprids över flera tillgänglighetszoner. |
sku |
En ARM-resurs-SKU. |
|
tags |
object |
Resurstaggar. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Den elastiska poolen har uppdaterats |
|
202 Accepted |
Accepterad Sidhuvuden Location: string |
|
Other Status Codes |
Felsvar: ***
|
Exempel
Assigns maintenance configuration to an elastic pool.
Exempelbegäran
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"
}
}
Exempelsvar
{
"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.
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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
{}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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
}
}
}
Exempelsvar
{
"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.
Exempelbegäran
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
}
}
Exempelsvar
{
"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
Definitioner
Name | Description |
---|---|
Always |
Typ av enklav som begärs i den elastiska poolen. |
Availability |
Anger tillgänglighetszonen som poolens primära replik är fäst vid. |
Elastic |
En elastisk pool. |
Elastic |
Licenstypen som ska tillämpas för den här elastiska poolen. |
Elastic |
Per databasinställningar för en elastisk pool. |
Elastic |
Status för den elastiska poolen. |
Elastic |
En uppdatering av elastisk pool. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Sku |
En ARM-resurs-SKU. |
AlwaysEncryptedEnclaveType
Typ av enklav som begärs i den elastiska poolen.
Värde | Description |
---|---|
Default | |
VBS |
AvailabilityZoneType
Anger tillgänglighetszonen som poolens primära replik är fäst vid.
Värde | Description |
---|---|
1 | |
2 | |
3 | |
NoPreference |
ElasticPool
En elastisk pool.
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID. |
kind |
string |
Typ av elastisk pool. Det här är metadata som används för Azure-portalen. |
location |
string |
Resursplats. |
name |
string |
Resursnamn. |
properties.autoPauseDelay |
integer (int32) |
Tid i minuter efter vilken den elastiska poolen pausas automatiskt. Värdet -1 innebär att automatisk paus är inaktiverad |
properties.availabilityZone |
Anger tillgänglighetszonen som poolens primära replik är fäst vid. |
|
properties.creationDate |
string (date-time) |
Skapandedatumet för den elastiska poolen (ISO8601 format). |
properties.highAvailabilityReplicaCount |
integer (int32) |
Antalet sekundära repliker som är associerade med den elastiska poolen Business Critical, Premium eller Hyperscale Edition som används för att ge hög tillgänglighet. Gäller endast för elastiska Hyperskala-pooler. |
properties.licenseType |
Licenstypen som ska tillämpas för den här elastiska poolen. |
|
properties.maintenanceConfigurationId |
string |
Underhållskonfigurations-ID som tilldelats den elastiska poolen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske. |
properties.maxSizeBytes |
integer (int64) |
Lagringsgränsen för databasens elastiska pool i byte. |
properties.minCapacity |
number (double) |
Minimal kapacitet som den serverlösa poolen inte krymper under, om den inte är pausad |
properties.perDatabaseSettings |
Inställningarna per databas för den elastiska poolen. |
|
properties.preferredEnclaveType |
Typ av enklav som begärs i den elastiska poolen. |
|
properties.state |
Status för den elastiska poolen. |
|
properties.zoneRedundant |
boolean |
Om den här elastiska poolen är zonredundant, vilket innebär att replikerna i den här elastiska poolen sprids över flera tillgänglighetszoner. |
sku |
SKU:n för elastisk pool. Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure-region använder du
|
|
tags |
object |
Resurstaggar. |
type |
string |
Resurstyp. |
ElasticPoolLicenseType
Licenstypen som ska tillämpas för den här elastiska poolen.
Värde | Description |
---|---|
BasePrice | |
LicenseIncluded |
ElasticPoolPerDatabaseSettings
Per databasinställningar för en elastisk pool.
Name | Typ | Description |
---|---|---|
autoPauseDelay |
integer (int32) |
Automatisk pausfördröjning för per databas i poolen |
maxCapacity |
number (double) |
Den maximala kapaciteten som en databas kan använda. |
minCapacity |
number (double) |
Den minsta kapaciteten som alla databaser garanteras. |
ElasticPoolState
Status för den elastiska poolen.
Värde | Description |
---|---|
Creating | |
Disabled | |
Ready |
ElasticPoolUpdate
En uppdatering av elastisk pool.
Name | Typ | Description |
---|---|---|
properties.autoPauseDelay |
integer (int32) |
Tid i minuter efter vilken den elastiska poolen pausas automatiskt. Värdet -1 innebär att automatisk paus är inaktiverad |
properties.availabilityZone |
Anger tillgänglighetszonen som poolens primära replik är fäst vid. |
|
properties.highAvailabilityReplicaCount |
integer (int32) |
Antalet sekundära repliker som är associerade med den elastiska poolen Business Critical, Premium eller Hyperscale Edition som används för att ge hög tillgänglighet. Gäller endast för elastiska Hyperskala-pooler. |
properties.licenseType |
Licenstypen som ska tillämpas för den här elastiska poolen. |
|
properties.maintenanceConfigurationId |
string |
Underhållskonfigurations-ID som tilldelats den elastiska poolen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske. |
properties.maxSizeBytes |
integer (int64) |
Lagringsgränsen för databasens elastiska pool i byte. |
properties.minCapacity |
number (double) |
Minimal kapacitet som den serverlösa poolen inte krymper under, om den inte är pausad |
properties.perDatabaseSettings |
Inställningarna per databas för den elastiska poolen. |
|
properties.preferredEnclaveType |
Typ av enklav som begärs i den elastiska poolen. |
|
properties.zoneRedundant |
boolean |
Om den här elastiska poolen är zonredundant, vilket innebär att replikerna i den här elastiska poolen sprids över flera tillgänglighetszoner. |
sku |
En ARM-resurs-SKU. |
|
tags |
object |
Resurstaggar. |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Ytterligare information. |
type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
Sku
En ARM-resurs-SKU.
Name | Typ | Description |
---|---|---|
capacity |
integer (int32) |
Kapacitet för den specifika SKU:n. |
family |
string |
Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här. |
name |
string |
Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3. |
size |
string |
Storleken på den specifika SKU:n |
tier |
string |
Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium. |