Elastic Pools - Update
Consente di aggiornare un pool elastico.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
elastic
|
path | True |
string |
Nome del pool elastico. |
resource
|
path | True |
string |
Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale. |
server
|
path | True |
string |
Nome del server. |
subscription
|
path | True |
string |
ID sottoscrizione che identifica una sottoscrizione di Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare per la richiesta. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
properties.highAvailabilityReplicaCount |
integer |
Numero di repliche secondarie associate al pool elastico utilizzato per garantire la disponibilità elevata. Applicabile solo ai pool elastici Hyperscale. |
properties.licenseType |
Tipo di licenza da applicare per questo pool elastico. |
|
properties.maintenanceConfigurationId |
string |
ID di configurazione della manutenzione assegnato al pool elastico. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. |
properties.maxSizeBytes |
integer |
Limite di archiviazione per il pool elastico del database in byte. |
properties.minCapacity |
number |
Capacità minima che il pool serverless non verrà ridotto al di sotto, se non sospeso |
properties.perDatabaseSettings |
Impostazioni per database per il pool elastico. |
|
properties.zoneRedundant |
boolean |
Indipendentemente dal fatto che questo pool elastico sia con ridondanza della zona, ovvero le repliche di questo pool elastico verranno distribuite in più zone di disponibilità. |
sku |
SKU della risorsa ARM. |
|
tags |
object |
Tag delle risorse. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornamento del pool elastico |
|
202 Accepted |
Accettato |
|
Other Status Codes |
Risposte di errore:
|
Esempio
Assigns maintenance configuration to an elastic pool.
Esempio di richiesta
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=2021-11-01
{
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
Risposta di esempio
{
"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"
}
}
Resets maintenance configuration of an elastic pool to default.
Esempio di richiesta
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=2021-11-01
{
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
}
}
Risposta di esempio
{
"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
}
}
}
Update an elastic pool with all parameter
Esempio di richiesta
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=2021-11-01
{
"sku": {
"name": "BC_Gen4",
"tier": "BusinessCritical",
"capacity": 2
},
"properties": {
"perDatabaseSettings": {
"minCapacity": 0.25,
"maxCapacity": 1
},
"zoneRedundant": true,
"licenseType": "LicenseIncluded"
}
}
Risposta di esempio
{
"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"
}
}
Update an elastic pool with minimum parameters
Esempio di richiesta
Risposta di esempio
{
"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
}
}
}
Update high availability replica count of a Hyperscale elastic pool.
Esempio di richiesta
Risposta di esempio
{
"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
}
}
Definizioni
Nome | Descrizione |
---|---|
Elastic |
Un pool elastico. |
Elastic |
Tipo di licenza da applicare per questo pool elastico. |
Elastic |
Impostazioni per database di un pool elastico. |
Elastic |
Stato del pool elastico. |
Elastic |
Aggiornamento del pool elastico. |
Sku |
SKU della risorsa ARM. |
ElasticPool
Un pool elastico.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
kind |
string |
Tipo di pool elastico. Si tratta di metadati usati per l'esperienza di portale di Azure. |
location |
string |
Percorso della risorsa. |
name |
string |
Nome risorsa. |
properties.creationDate |
string |
Data di creazione del pool elastico (formato ISO8601). |
properties.highAvailabilityReplicaCount |
integer |
Numero di repliche secondarie associate al pool elastico utilizzato per garantire la disponibilità elevata. Applicabile solo ai pool elastici Hyperscale. |
properties.licenseType |
Tipo di licenza da applicare per questo pool elastico. |
|
properties.maintenanceConfigurationId |
string |
ID di configurazione della manutenzione assegnato al pool elastico. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. |
properties.maxSizeBytes |
integer |
Limite di archiviazione per il pool elastico del database in byte. |
properties.minCapacity |
number |
Capacità minima che il pool serverless non verrà ridotto al di sotto, se non sospeso |
properties.perDatabaseSettings |
Impostazioni per database per il pool elastico. |
|
properties.state |
Stato del pool elastico. |
|
properties.zoneRedundant |
boolean |
Indipendentemente dal fatto che questo pool elastico sia con ridondanza della zona, ovvero le repliche di questo pool elastico verranno distribuite in più zone di disponibilità. |
sku |
SKU del pool elastico. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API
|
|
tags |
object |
Tag delle risorse. |
type |
string |
Tipo di risorsa. |
ElasticPoolLicenseType
Tipo di licenza da applicare per questo pool elastico.
Nome | Tipo | Descrizione |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ElasticPoolPerDatabaseSettings
Impostazioni per database di un pool elastico.
Nome | Tipo | Descrizione |
---|---|---|
maxCapacity |
number |
Capacità massima che può essere utilizzata da un database. |
minCapacity |
number |
La capacità minima di tutti i database è garantita. |
ElasticPoolState
Stato del pool elastico.
Nome | Tipo | Descrizione |
---|---|---|
Creating |
string |
|
Disabled |
string |
|
Ready |
string |
ElasticPoolUpdate
Aggiornamento del pool elastico.
Nome | Tipo | Descrizione |
---|---|---|
properties.highAvailabilityReplicaCount |
integer |
Numero di repliche secondarie associate al pool elastico utilizzato per garantire la disponibilità elevata. Applicabile solo ai pool elastici Hyperscale. |
properties.licenseType |
Tipo di licenza da applicare per questo pool elastico. |
|
properties.maintenanceConfigurationId |
string |
ID di configurazione della manutenzione assegnato al pool elastico. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione. |
properties.maxSizeBytes |
integer |
Limite di archiviazione per il pool elastico del database in byte. |
properties.minCapacity |
number |
Capacità minima che il pool serverless non verrà ridotto al di sotto, se non sospeso |
properties.perDatabaseSettings |
Impostazioni per database per il pool elastico. |
|
properties.zoneRedundant |
boolean |
Indipendentemente dal fatto che questo pool elastico sia con ridondanza della zona, ovvero le repliche di questo pool elastico verranno distribuite in più zone di disponibilità. |
sku |
SKU della risorsa ARM. |
|
tags |
object |
Tag delle risorse. |
Sku
SKU della risorsa ARM.
Nome | Tipo | Descrizione |
---|---|---|
capacity |
integer |
Capacità dello SKU specifico. |
family |
string |
Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, può essere acquisito qui. |
name |
string |
Nome dello SKU, in genere una lettera + codice numerico, ad esempio P3. |
size |
string |
Dimensioni dello SKU specifico |
tier |
string |
Livello o edizione dello SKU specifico, ad esempio Basic, Premium. |