Elastic Pools - Create Or Update
Hiermee wordt een elastische pool gemaakt of bijgewerkt.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
elastic
|
path | True |
string |
De naam van de elastische pool. |
resource
|
path | True |
string |
De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal. |
server
|
path | True |
string |
De naam van de server. |
subscription
|
path | True |
string |
De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd. |
api-version
|
query | True |
string |
De API-versie die moet worden gebruikt voor de aanvraag. |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
location | True |
string |
Resourcelocatie. |
properties.highAvailabilityReplicaCount |
integer |
Het aantal secundaire replica's dat is gekoppeld aan de elastische pool dat wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools. |
|
properties.licenseType |
Het licentietype dat moet worden toegepast voor deze elastische pool. |
||
properties.maintenanceConfigurationId |
string |
Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Deze configuratie definieert de periode waarop de onderhoudsupdates worden uitgevoerd. |
|
properties.maxSizeBytes |
integer |
De opslaglimiet voor de elastische databasegroep in bytes. |
|
properties.minCapacity |
number |
Minimale capaciteit van de serverloze pool wordt niet kleiner, indien niet onderbroken |
|
properties.perDatabaseSettings |
De instellingen per database voor de elastische pool. |
||
properties.zoneRedundant |
boolean |
Of deze elastische pool zone-redundant is of niet, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones. |
|
sku |
De elastische pool-SKU. De lijst met SKU's kan verschillen per regio en ondersteuningsaanbieding. Als u wilt bepalen welke SKU's (inclusief de SKU-naam, laag/editie, familie en capaciteit) beschikbaar zijn voor uw abonnement in een Azure-regio, gebruikt u de
|
||
tags |
object |
Resourcetags. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De elastische pool is bijgewerkt |
|
201 Created |
De elastische pool gemaakt |
|
202 Accepted |
Geaccepteerd |
|
Other Status Codes |
Foutreacties: ***
|
Voorbeelden
Create or update elastic pool with all parameter
Voorbeeldaanvraag
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
}
}
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
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
}
}
Voorbeeldrespons
{
"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
}
}
Definities
Name | Description |
---|---|
Elastic |
Een elastische pool. |
Elastic |
Het licentietype dat moet worden toegepast voor deze elastische pool. |
Elastic |
Per database-instellingen van een elastische pool. |
Elastic |
De status van de elastische pool. |
Sku |
Een ARM-resource-SKU. |
ElasticPool
Een elastische pool.
Name | Type | Description |
---|---|---|
id |
string |
Resource-id. |
kind |
string |
Soort elastische pool. Dit zijn metagegevens die worden gebruikt voor de Azure Portal ervaring. |
location |
string |
Resourcelocatie. |
name |
string |
Resourcenaam. |
properties.creationDate |
string |
De aanmaakdatum van de elastische pool (ISO8601-indeling). |
properties.highAvailabilityReplicaCount |
integer |
Het aantal secundaire replica's dat is gekoppeld aan de elastische pool dat wordt gebruikt om hoge beschikbaarheid te bieden. Alleen van toepassing op elastische Hyperscale-pools. |
properties.licenseType |
Het licentietype dat moet worden toegepast voor deze elastische pool. |
|
properties.maintenanceConfigurationId |
string |
Onderhoudsconfiguratie-id die is toegewezen aan de elastische pool. Deze configuratie definieert de periode waarop de onderhoudsupdates worden uitgevoerd. |
properties.maxSizeBytes |
integer |
De opslaglimiet voor de elastische databasegroep in bytes. |
properties.minCapacity |
number |
Minimale capaciteit van de serverloze pool wordt niet kleiner, indien niet onderbroken |
properties.perDatabaseSettings |
De instellingen per database voor de elastische pool. |
|
properties.state |
De status van de elastische pool. |
|
properties.zoneRedundant |
boolean |
Of deze elastische pool zone-redundant is of niet, wat betekent dat de replica's van deze elastische pool worden verdeeld over meerdere beschikbaarheidszones. |
sku |
De elastische pool-SKU. De lijst met SKU's kan verschillen per regio en ondersteuningsaanbieding. Als u wilt bepalen welke SKU's (inclusief de SKU-naam, laag/editie, familie en capaciteit) beschikbaar zijn voor uw abonnement in een Azure-regio, gebruikt u de
|
|
tags |
object |
Resourcetags. |
type |
string |
Resourcetype. |
ElasticPoolLicenseType
Het licentietype dat moet worden toegepast voor deze elastische pool.
Name | Type | Description |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ElasticPoolPerDatabaseSettings
Per database-instellingen van een elastische pool.
Name | Type | Description |
---|---|---|
maxCapacity |
number |
De maximale capaciteit die een database kan gebruiken. |
minCapacity |
number |
De minimale capaciteit voor alle databases is gegarandeerd. |
ElasticPoolState
De status van de elastische pool.
Name | Type | Description |
---|---|---|
Creating |
string |
|
Disabled |
string |
|
Ready |
string |
Sku
Een ARM-resource-SKU.
Name | Type | Description |
---|---|---|
capacity |
integer |
Capaciteit van de specifieke SKU. |
family |
string |
Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd. |
name |
string |
De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. |
size |
string |
Grootte van de specifieke SKU |
tier |
string |
De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. |