Elastic Pools - Create Or Update
Erstellt oder aktualisiert einen Pool für elastische Datenbanken.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
elastic
|
path | True |
string |
Der Name des Pools für elastische Datenbanken. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden. |
server
|
path | True |
string |
Name des Servers |
subscription
|
path | True |
string |
Abonnement-ID für ein Azure-Abonnement. |
api-version
|
query | True |
string |
API-Version, die für die Anforderung verwendet werden soll. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
location | True |
string |
Ressourcenspeicherort |
properties.highAvailabilityReplicaCount |
integer |
Die Anzahl der sekundären Replikate, die dem Pool für elastische Datenbanken zugeordnet sind, die zur Bereitstellung von Hochverfügbarkeit verwendet werden. Gilt nur für Pools für elastische Hyperscale-Datenbanken. |
|
properties.licenseType |
Der Lizenztyp, der für diesen Pool für elastische Datenbanken angewendet werden soll. |
||
properties.maintenanceConfigurationId |
string |
Wartungskonfigurations-ID, die dem Pool für elastische Datenbanken zugewiesen ist. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates durchgeführt werden. |
|
properties.maxSizeBytes |
integer |
Das Speicherlimit für den Pool für elastische Datenbanken in Bytes. |
|
properties.minCapacity |
number |
Minimale Kapazität, unter der der serverlose Pool nicht kleiner wird, wenn sie nicht angehalten wird |
|
properties.perDatabaseSettings |
Die Einstellungen pro Datenbank für den Pool für elastische Datenbanken. |
||
properties.zoneRedundant |
boolean |
Unabhängig davon, ob dieser Pool für elastische Datenbanken zonenredundant ist, was bedeutet, dass die Replikate dieses Pools für elastische Datenbanken auf mehrere Verfügbarkeitszonen verteilt werden. |
|
sku |
Die SKU des Pools für elastische Datenbanken. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder den folgenden Befehl, um die SKUs (einschließlich SKU-Name, Tarif/Edition, Familie und Kapazität) zu ermitteln, die
|
||
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der Pool für elastische Datenbanken wurde aktualisiert. |
|
201 Created |
Erstellen des Pools für elastische Datenbanken |
|
202 Accepted |
Akzeptiert |
|
Other Status Codes |
Fehlerantworten: ***
|
Beispiele
Create or update elastic pool with all parameter
Beispielanforderung
PUT 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
{
"location": "Japan East",
"sku": {
"name": "GP_Gen4_2",
"tier": "GeneralPurpose",
"capacity": 2
},
"properties": {
"perDatabaseSettings": {
"minCapacity": 0.25,
"maxCapacity": 2
}
}
}
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_Gen4_2",
"tier": "GeneralPurpose",
"capacity": 2
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 5242880000,
"perDatabaseSettings": {
"minCapacity": 0.25,
"maxCapacity": 2
}
}
}
{
"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_Gen4_2",
"tier": "GeneralPurpose",
"capacity": 2
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 5242880000,
"perDatabaseSettings": {
"minCapacity": 0.25,
"maxCapacity": 2
}
}
}
Create or update elastic pool with maintenance configuration parameter
Beispielanforderung
PUT 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
{
"location": "Japan East",
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
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": "StandardPool",
"tier": "Standard",
"capacity": 100
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 102400,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 100
},
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
{
"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": "StandardPool",
"tier": "Standard",
"capacity": 100
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 102400,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 100
},
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
Create or update elastic pool with minimum parameters
Beispielanforderung
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": "StandardPool",
"tier": "Standard",
"capacity": 100
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 102400,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 100
}
}
}
{
"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": "StandardPool",
"tier": "Standard",
"capacity": 100
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 102400,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 100
}
}
}
Create or update Hyperscale elastic pool with high availability replica count parameter
Beispielanforderung
PUT 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
{
"location": "Japan East",
"sku": {
"name": "HS_Gen5_4"
},
"properties": {
"highAvailabilityReplicaCount": 2
}
}
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
}
}
{
"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
}
}
Definitionen
Name | Beschreibung |
---|---|
Elastic |
Ein Pool für elastische Datenbanken. |
Elastic |
Der Lizenztyp, der für diesen Pool für elastische Datenbanken angewendet werden soll. |
Elastic |
Einstellungen pro Datenbank eines Pools für elastische Datenbanken. |
Elastic |
Der Zustand des Pools für elastische Datenbanken. |
Sku |
Eine ARM-Ressourcen-SKU. |
ElasticPool
Ein Pool für elastische Datenbanken.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
kind |
string |
Art des Pools für elastische Datenbanken. Dies sind Metadaten, die für die Azure-Portal-Benutzeroberfläche verwendet werden. |
location |
string |
Ressourcenspeicherort |
name |
string |
Name der Ressource. |
properties.creationDate |
string |
Das Erstellungsdatum des Pools für elastische Datenbanken (ISO8601 Format). |
properties.highAvailabilityReplicaCount |
integer |
Die Anzahl der sekundären Replikate, die dem Pool für elastische Datenbanken zugeordnet sind, die zur Bereitstellung von Hochverfügbarkeit verwendet werden. Gilt nur für Pools für elastische Hyperscale-Datenbanken. |
properties.licenseType |
Der Lizenztyp, der für diesen Pool für elastische Datenbanken angewendet werden soll. |
|
properties.maintenanceConfigurationId |
string |
Wartungskonfigurations-ID, die dem Pool für elastische Datenbanken zugewiesen ist. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates durchgeführt werden. |
properties.maxSizeBytes |
integer |
Das Speicherlimit für den Pool für elastische Datenbanken in Bytes. |
properties.minCapacity |
number |
Minimale Kapazität, unter der der serverlose Pool nicht kleiner wird, wenn sie nicht angehalten wird |
properties.perDatabaseSettings |
Die Einstellungen pro Datenbank für den Pool für elastische Datenbanken. |
|
properties.state |
Der Zustand des Pools für elastische Datenbanken. |
|
properties.zoneRedundant |
boolean |
Unabhängig davon, ob dieser Pool für elastische Datenbanken zonenredundant ist, was bedeutet, dass die Replikate dieses Pools für elastische Datenbanken auf mehrere Verfügbarkeitszonen verteilt werden. |
sku |
Die SKU des Pools für elastische Datenbanken. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder den folgenden Befehl, um die SKUs (einschließlich SKU-Name, Tarif/Edition, Familie und Kapazität) zu ermitteln, die
|
|
tags |
object |
Ressourcentags. |
type |
string |
Der Ressourcentyp. |
ElasticPoolLicenseType
Der Lizenztyp, der für diesen Pool für elastische Datenbanken angewendet werden soll.
Name | Typ | Beschreibung |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ElasticPoolPerDatabaseSettings
Einstellungen pro Datenbank eines Pools für elastische Datenbanken.
Name | Typ | Beschreibung |
---|---|---|
maxCapacity |
number |
Die maximale Kapazität, die eine Datenbank nutzen kann. |
minCapacity |
number |
Die Mindestkapazität für alle Datenbanken ist garantiert. |
ElasticPoolState
Der Zustand des Pools für elastische Datenbanken.
Name | Typ | Beschreibung |
---|---|---|
Creating |
string |
|
Disabled |
string |
|
Ready |
string |
Sku
Eine ARM-Ressourcen-SKU.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer |
Kapazität der jeweiligen SKU. |
family |
string |
Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies 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 |
Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium. |