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
elasticPoolName
path True

string

Nome del pool elastico.

resourceGroupName
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.

serverName
path True

string

Nome del server.

subscriptionId
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

ElasticPoolLicenseType

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

ElasticPoolPerDatabaseSettings

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

SKU della risorsa ARM.

tags

object

Tag delle risorse.

Risposte

Nome Tipo Descrizione
200 OK

ElasticPool

Aggiornamento del pool elastico

202 Accepted

Accettato

Other Status Codes

Risposte di errore:

  • 400 ElasticPoolOverStorageUsage : tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico.

  • 400 InvalidSku: l'utente ha specificato uno SKU non valido.

  • 400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato.

  • 400 ServerQuotaExceeded: il server ha raggiunto il limite per l'unità elaborate del database consentita.

  • 400 ElasticPoolAlreadyExists: il server contiene già un pool elastico con il nome specificato.

  • 400 SubscriptionVcoreQuotaExceeded- Impossibile eseguire l'operazione perché la sottoscrizione supera la quota vCore consentita.

  • 400 InvalidInputValueForEdition - L'edizione specificata non è supportata per il provisioning del pool elastico.

  • 400 ElasticPoolDtuBelowLimit: il valore DTU richiesto è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDtuAboveLimit: il valore DTU richiesto è troppo elevato per il livello di servizio del pool elastico richiesto.

  • 400 InvalidMaxSize - Dimensioni massime non valide.

  • 400 ElasticPoolDbDtuMaxBelowLimit: il valore massimo richiesto per DTU database è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDbDtuMaxAboveLimit: il valore massimo richiesto per DTU del database è troppo elevato per il livello di servizio del pool elastico richiesto.

  • 400 InvalidInputValueForDatabaseDtuMax- Tentativo di impostare il numero massimo di DTU per database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 ElasticPoolDbDtuMinAboveLimit: il min DTU richiesto per database è troppo elevato per il livello di servizio richiesto.

  • 400 ElasticPoolOverStorage: tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico.

  • 400 InvalidInputValueForDatabaseDtuMin - Tentativo di impostare il valore minimo DTU per database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - Tentativo di fornire il valore minimo di DTU per i database nel pool elastico che supera le DTU richieste del pool elastico.

  • 400 ElasticPoolDtuUnsupported : l'utente ha tentato di creare o aggiornare un pool elastico con una capacità DTU non supportata.

  • 400 ElasticPoolStorageAboveLimitGB: tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 ElasticPoolsNotEnabled: i pool elastici non sono stati abilitati in questa area.

  • 400 ElasticPoolNotEmpty - Richiesta di eliminazione di un pool elastico non vuoto.

  • 400 ElasticPoolStorageBelowLimitGB : tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 ElasticPoolStorageNotAllowedGB : tentativo di impostare il limite di archiviazione del pool elastico in gb che non corrisponde ai valori consentiti.

  • 400 ElasticPoolDatabaseLimit: il pool elastico ha raggiunto il limite per il numero di database.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - Tentativo di ridurre il limite di archiviazione del pool elastico al di sotto dell'utilizzo di archiviazione.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Tentativo di impostare il valore minimo DTU per database superiore al numero massimo di DTU per database.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings: il numero di database e il numero minimo di VCore per database non possono superare i VCore richiesti del pool elastico.

  • 400 ElasticPoolStorageBelowLimitMB: tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 ElasticPoolStorageNotAllowedMB - Tentativo di impostare il limite di archiviazione del pool elastico in mb che non corrisponde ai valori consentiti.

  • 400 ElasticPoolCapacityStorageNotAllowedMB - Tentativo di impostare il limite di archiviazione del pool elastico in mb che non corrisponde ai valori consentiti.

  • 400 ElasticPoolStorageAboveLimitMB : tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 RegionDoesNotSupportVersion: un utente ha tentato di creare un server di una versione specificata in un percorso in cui tale versione del server non è supportata.

  • 400 InvalidTier: l'utente ha specificato un livello non valido.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded: il database di origine non può avere un'edizione superiore rispetto al database di destinazione.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded: il database di destinazione non può avere un'edizione inferiore rispetto al database di origine.

  • 400 ElasticPoolUpdateHkNotAllowed: il pool elastico non può abbassare il livello di servizio da Premium a Standard o Basic perché uno o più database usano oggetti ottimizzati per la memoria.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - L'operazione non è consentita perché l'operazione di copia o failover per il database '{0}' nel server '{1}' è attualmente in corso.

  • 400 RegionDoesNotAllowProvisioning: il percorso selezionato non accetta nuovi server di database di Windows Azure SQL. Questa modifica può essere modificata in un secondo momento.

  • 400 ElasticPoolOverFileSpace - Spazio file insufficiente nel pool elastico.

  • 400 ElasticPoolDbDtuMinBelowLimit: il valore minimo richiesto per DTU del database è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDbVcoreMaxBelowLimit: il valore massimo richiesto per database VCore è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDbVcoreMaxAboveLimit: il valore massimo richiesto per database VCore max è troppo elevato per il livello di servizio del pool elastico richiesto.

  • 400 InvalidInputValueForDatabaseVcoreMax - Tentativo di impostare il valore massimo VCore per ogni database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 ElasticPoolDbVcoreMinBelowLimit: il valore richiesto per ogni VCore del database è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 InvalidInputValueForDatabaseVcoreMin - Tentativo di impostare il valore VCore min per database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Tentativo di impostare il collegamento GeoDR o aggiornare SLO per il database abilitato per l'enclave è supportato solo quando entrambi i database vengono eseguiti nell'hardware della serie DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Tentativo di impostare il valore VCore min per database superiore al valore massimo VCore per ogni database.

  • 400 InvalidLicenseType: l'utente ha tentato di creare o aggiornare un database o un pool elastico con tipo di licenza non supportato.

  • 400 ProvisioningDisabled - Visualizza il messaggio di errore dall'autorizzazione dell'operazione delle risorse, come è, senza modifiche

  • 400 InvalidPublicMaintenanceConfiguration : l'utente ha tentato di specificare la configurazione di manutenzione pubblica che non può essere convertita in ID interno (area non valida o errata).

  • 400 InvalidResourceRequestBody: le proprietà della risorsa o della risorsa nel corpo della richiesta sono vuote o non valide.

  • 400 InvalidResourceId - Identificatore di risorsa non valido.

  • 400 InvalidSkuName - Nome SKU non valido.

  • 400 MismatchedSkuNameAndCapacity - Mancata corrispondenza tra nome SKU e capacità.

  • 400 MismatchedSkuNameAndTier - Mancata corrispondenza tra nome SKU e livello.

  • 400 MismatchedSkuNameAndFamily - Mancata corrispondenza tra nome SKU e famiglia.

  • 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrispondeva alla sottoscrizione nell'URL.

  • 400 ElasticPoolOverStorageUsage : tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico.

  • 400 InvalidSku: l'utente ha specificato uno sku non valido.

  • 400 InvalidTierSkuCombination: il livello specificato non supporta lo sku specificato.

  • 400 ServerQuotaExceeded: il server ha raggiunto il limite per l'unità velocità effettiva del database consentita.

  • 400 ElasticPoolAlreadyExists : il server contiene già un pool elastico con il nome specificato.

  • 400 SubscriptionVcoreQuotaExceeded- Impossibile eseguire l'operazione perché la sottoscrizione supera la quota vCore consentita.

  • 400 InvalidInputValueForEdition - L'edizione specificata non è supportata per il provisioning del pool elastico.

  • 400 ElasticPoolDtuBelowLimit: il valore DTU richiesto è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDtuAboveLimit: il valore DTU richiesto è troppo elevato per il livello di servizio del pool elastico richiesto.

  • 400 InvalidMaxSize - Dimensioni massime non valide.

  • 400 ElasticPoolDbDtuMaxBelowLimit : il valore massimo DTU richiesto per database DTU è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDbDtuMaxAboveLimit: il valore massimo DTU richiesto per database DTU è troppo elevato per il livello di servizio del pool elastico richiesto.

  • 400 InvalidInputValueForDatabaseDtuMax - Tentativo di impostare il valore massimo DTU per ogni database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 ElasticPoolDbDtuMinAboveLimit: il valore DTU richiesto per ogni database è troppo elevato per il livello di servizio richiesto.

  • 400 ElasticPoolOverStorage : tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico.

  • 400 InvalidInputValueForDatabaseDtuMin - Tentativo di impostare il valore DTU min per database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - Tentativo di fornire il numero minimo DTU per i database nel pool elastico che supera le DTU richieste del pool elastico.

  • 400 ElasticPoolDtuUnsupported : l'utente ha tentato di creare o aggiornare un pool elastico con una capacità DTU non supportata.

  • 400 ElasticPoolStorageAboveLimitGB - Tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 ElasticPoolsNotEnabled : i pool elastici non sono stati abilitati in questa area.

  • 400 ElasticPoolNotEmpty - Richiedere di eliminare un pool elastico non vuoto.

  • 400 ElasticPoolStorageBelowLimitGB - Tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 ElasticPoolStorageNotAllowedGB - Tentativo di impostare il limite di archiviazione del pool elastico in gb che non corrisponde ai valori consentiti.

  • 400 ElasticPoolDatabaseLimit: il pool elastico ha raggiunto il limite per il numero di database.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - Tentativo di ridurre il limite di archiviazione del pool elastico al di sotto dell'utilizzo dell'archiviazione.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Tentativo di impostare il numero minimo DTU per database superiore al massimo DTU per database.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings: il numero di database e VCore min per database non può superare i VCore richiesti del pool elastico.

  • 400 ElasticPoolStorageBelowLimitMB - Tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 ElasticPoolStorageNotAllowedMB - Tentativo di impostare il limite di archiviazione del pool elastico in mb che non corrisponde ai valori consentiti.

  • 400 ElasticPoolCapacityStorageNotAllowedMB - Tentativo di impostare il limite di archiviazione del pool elastico in mb che non corrisponde ai valori consentiti.

  • 400 ElasticPoolStorageAboveLimitMB - Tentativo di impostare il limite di archiviazione del pool elastico al di sotto del limite supportato.

  • 400 RegionDoesNotSupportVersion: un utente ha tentato di creare un server di una versione specificata in un percorso in cui tale versione del server non è supportata.

  • 400 InvalidTier: l'utente ha specificato un livello non valido.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded: il database di origine non può avere edizioni superiori rispetto al database di destinazione.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded: il database di destinazione non può avere un'edizione inferiore rispetto al database di origine.

  • 400 ElasticPoolUpdateHkNotAllowed : il pool elastico non può ridurre il livello di servizio da Premium a Standard o Basic perché uno o più dei relativi database usano oggetti ottimizzati per la memoria.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - L'operazione non è consentita perché l'operazione di copia o failover per il database '' nel server '{0}{1}' è attualmente in corso.

  • 400 RegionDoesNotAllowProvisioning - La posizione selezionata non accetta nuovi server di database di Windows Azure SQL. Questo può cambiare in un secondo momento.

  • 400 ElasticPoolOverFileSpace - Spazio file insufficiente nel pool elastico.

  • 400 ElasticPoolDbDtuMinBelowLimit : il valore richiesto per DTU del database è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDbVcoreMaxBelowLimit: il valore massimo richiesto per database VCore è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 ElasticPoolDbVcoreMaxAboveLimit: il valore massimo richiesto per database VCore max è troppo elevato per il livello di servizio del pool elastico richiesto.

  • 400 InvalidInputValueForDatabaseVcoreMax - Tentativo di impostare il valore massimo VCore per ogni database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 ElasticPoolDbVcoreMinBelowLimit: il valore richiesto per ogni VCore del database è troppo basso per il livello di servizio del pool elastico richiesto.

  • 400 InvalidInputValueForDatabaseVcoreMin - Tentativo di impostare il valore VCore min per database per il pool di risorse che non corrisponde ai valori consentiti.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Tentativo di impostare il collegamento GeoDR o aggiornare SLO per il database abilitato per l'enclave è supportato solo quando entrambi i database vengono eseguiti nell'hardware della serie DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Tentativo di impostare il valore VCore min per database superiore al valore massimo VCore per ogni database.

  • 400 InvalidLicenseType: l'utente ha tentato di creare o aggiornare un database o un pool elastico con tipo di licenza non supportato.

  • 400 ProvisioningDisabled - Visualizza il messaggio di errore dall'autorizzazione dell'operazione delle risorse, come è, senza modifiche

  • 400 InvalidPublicMaintenanceConfiguration : l'utente ha tentato di specificare la configurazione di manutenzione pubblica che non può essere convertita in ID interno (area non valida o errata).

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 ElasticPoolNotFound: il pool elastico specificato non esiste per il server specificato.

  • 404 OperationIdNotFound: l'operazione con ID non esiste.

  • 404 ElasticPoolNotFound: il pool elastico specificato non esiste per il server specificato.

  • 405 NotSupported : questa funzionalità non è supportata.

  • 405 NotSupported : questa funzionalità non è supportata.

  • 409 ElasticPoolBusy: un'operazione di gestione è stata tentata in un pool elastico occupato.

  • 409 ServerDisabled - Il server è disabilitato.

  • 409 SimultaneEChangeNotAllowed - Le operazioni di modifica dell'obiettivo del servizio non possono essere eseguite in entrambi i database di una relazione di replica contemporaneamente.

  • 409 ElasticPoolUpdateLinksNotInCatchup - Impossibile aggiornare il pool elastico mentre uno dei relativi database esegue un'operazione di failover di copia o replica geografica.

  • 409 OperationCancelled: l'operazione è stata annullata dall'utente.

  • 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.

  • 409 ElasticPoolBusy: un'operazione di gestione è stata tentata in un pool elastico occupato.

  • 409 ServerDisabled - Il server è disabilitato.

  • 409 SimultaneEChangeNotAllowed - Le operazioni di modifica dell'obiettivo del servizio non possono essere eseguite in entrambi i database di una relazione di replica contemporaneamente.

  • 409 ElasticPoolUpdateLinksNotInCatchup - Impossibile aggiornare il pool elastico mentre uno dei relativi database esegue un'operazione di failover di copia o replica geografica.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 500 ElasticPoolFailedMoveDbToElasticPool - Impossibile spostare il database nel pool elastico a causa di vincoli di risorse interni. Può trattarsi di una condizione temporanea, riprovare.

  • 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione.

  • 500 ElasticPoolFailedMoveDbToElasticPool - Impossibile spostare il database nel pool elastico a causa di vincoli di risorse interni. Può trattarsi di una condizione temporanea, riprovare.

  • 503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile.

  • 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 503 ServiceTemporarilyUnavailable - Funzionalità temporaneamente non disponibile.

  • 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Assigns maintenance configuration to an elastic pool.
Resets maintenance configuration of an elastic pool to default.
Update an elastic pool with all parameter
Update an elastic pool with minimum parameters
Update high availability replica count of a Hyperscale elastic pool.

Assigns maintenance configuration to an elastic pool.

Sample Request

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"
  }
}

Sample Response

{
  "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.

Sample Request

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"
  }
}

Sample Response

{
  "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

Sample Request

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"
  }
}

Sample Response

{
  "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

Sample Request

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

{}

Sample Response

{
  "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.

Sample Request

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": {
    "highAvailabilityReplicaCount": 2
  }
}

Sample Response

{
  "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
ElasticPool

Un pool elastico.

ElasticPoolLicenseType

Tipo di licenza da applicare per questo pool elastico.

ElasticPoolPerDatabaseSettings

Impostazioni per database di un pool elastico.

ElasticPoolState

Stato del pool elastico.

ElasticPoolUpdate

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

ElasticPoolLicenseType

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

ElasticPoolPerDatabaseSettings

Impostazioni per database per il pool elastico.

properties.state

ElasticPoolState

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

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 Capabilities_ListByLocation REST o il comando seguente:

az sql elastic-pool list-editions -l <location> -o table
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

ElasticPoolLicenseType

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

ElasticPoolPerDatabaseSettings

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

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.