Elastic Pools - Create Or Update

  • Başvuru
Service:
SQL Database
API Version:
2021-11-01

Elastik havuz oluşturur veya güncelleştirir.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01

URI Parametreleri

Name İçinde Gerekli Tür Description
elasticPoolName
 path True

string

Elastik havuzun adı.
resourceGroupName
 path True

string

Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName
 path True

string

Sunucunun adı.
subscriptionId
 path True

string

Azure aboneliğini tanımlayan abonelik kimliği.
api-version
 query True

string

İstek için kullanılacak API sürümü.

İstek Gövdesi

Name Gerekli Tür Description
location True

string

Kaynak konumu.
properties.highAvailabilityReplicaCount

integer

Yüksek kullanılabilirlik sağlamak için kullanılan elastik havuzla ilişkili ikincil çoğaltmaların sayısı. Yalnızca Hiper Ölçek elastik havuzları için geçerlidir.
properties.licenseType

ElasticPoolLicenseType

Bu elastik havuz için uygulanacak lisans türü.
properties.maintenanceConfigurationId

string

Elastik havuza atanan bakım yapılandırma kimliği. Bu yapılandırma, bakım güncelleştirmelerinin gerçekleşeceği süreyi tanımlar.
properties.maxSizeBytes

integer

Veritabanı elastik havuzunun bayt cinsinden depolama sınırı.
properties.minCapacity

number

Duraklatılmadıysa sunucusuz havuzun altta küçülmediği en düşük kapasite
properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Elastik havuzun veritabanı başına ayarları.
properties.zoneRedundant

boolean

Bu elastik havuzun alanlar arası yedekli olup olmadığı, bu elastik havuzun çoğaltmalarının birden çok kullanılabilirlik alanına yayılacağı anlamına gelir.
sku

Sku

Elastik havuz SKU'su.

SKU'ların listesi bölgeye ve destek teklifine göre farklılık gösterebilir. Bir Azure bölgesindeki aboneliğinizde kullanılabilen SKU'ları (SKU adı, katman/sürüm, aile ve kapasite dahil) belirlemek için REST API'yi Capabilities_ListByLocation veya aşağıdaki komutu kullanın:

az sql elastic-pool list-editions -l <location> -o table
tags

object

Kaynak etiketleri.

Yanıtlar

Name Tür Description
200 OK

ElasticPool

Elastik havuz güncelleştirildi
201 Created

ElasticPool

Elastik havuz oluşturuldu
202 Accepted

Kabul edildi
Other Status Codes

Hata Yanıtları: **

  • 400 ElasticPoolOverStorageUsage - Elastik havuzun depolama sınırına ulaşıldığında veritabanına veri yazmaya çalışılıyor.

  • 400 InvalidSku - Kullanıcı geçersiz bir sku belirtti.

  • 400 InvalidTierSkuCombination - Belirtilen katman belirtilen sku'yu desteklemiyor.

  • 400 ServerQuotaExceeded - Sunucu izin verilen Veritabanı Aktarım Hızı Birimi sınırına ulaştı.

  • 400 ElasticPoolAlreadyExists - Sunucu zaten belirtilen ada sahip bir elastik havuz içeriyor.

  • 400 SubscriptionVcoreQuotaExceeded - Abonelik izin verilen sanal çekirdek kotasını aşacağından işlem gerçekleştirilemedi.

  • 400 InvalidInputValueForEdition - Elastik havuz sağlama için belirtilen sürüm desteklenmiyor.

  • 400 ElasticPoolDtuBelowLimit - İstenen DTU değeri istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDtuAboveLimit - İstenen DTU değeri istenen elastik havuz hizmet katmanı için çok yüksek.

  • 400 InvalidMaxSize - Geçersiz maksimum boyut.

  • 400 ElasticPoolDbDtuMaxBelowLimit - Veritabanı başına istenen DTU üst sınır, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDbDtuMaxAboveLimit - Veritabanı başına istenen DTU üst sınır, istenen elastik havuz hizmet katmanı için çok yüksek.

  • 400 InvalidInputValueForDatabaseDtuMax - Kaynak Havuzu için veritabanı başına izin verilen değerlerle eşleşmeyen en yüksek DTU değerini ayarlamaya çalışılıyor.

  • 400 ElasticPoolDbDtuMinAboveLimit - Veritabanı başına istenen DTU dk istenen hizmet katmanı için çok yüksek.

  • 400 ElasticPoolOverStorage - Elastik havuzun depolama sınırına ulaşıldığında veritabanına veri yazmaya çalışma.

  • 400 InvalidInputValueForDatabaseDtuMin - Kaynak Havuzu için veritabanı başına izin verilen değerlerle eşleşmeyen DTU min değerini ayarlamaya çalışılıyor.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - Elastik havuzdaki elastik havuzun istenen DTU'larını aşan veritabanları için DTU min sağlamaya çalışılıyor.

  • 400 ElasticPoolDtuUnsupported - Kullanıcı desteklenmeyen bir DTU kapasitesine sahip bir elastik havuz oluşturmayı veya güncelleştirmeyi denedi.

  • 400 ElasticPoolStorageAboveLimitGB - Elastik havuz depolama sınırını desteklenen sınırın altında ayarlamaya çalışılıyor.

  • 400 ElasticPoolsNotEnabled - Elastik havuzlar bu bölgede etkinleştirilmedi.

  • 400 ElasticPoolNotEmpty - Boş olmayan bir elastik havuzu silme isteği.

  • 400 ElasticPoolStorageBelowLimitGB - Elastik havuz depolama sınırını desteklenen sınırın altına ayarlamaya çalışılıyor.

  • 400 ElasticPoolStorageNotAllowedGB - İzin verilen değerlerle eşleşmeyen elastik havuz depolama sınırını GB olarak ayarlamaya çalışılıyor.

  • 400 ElasticPoolDatabaseLimit - Elastik havuz veritabanı sayısı sınırına ulaştı.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - Elastik havuzun depolama sınırını depolama kullanımının altında azaltmaya çalışılıyor.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Veritabanı başına DTU min değerini veritabanı başına DTU maksimum değerinden daha yüksek ayarlamaya çalışılıyor.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - Veritabanı sayısı ve veritabanı başına en düşük sanal çekirdek sayısı, elastik havuzun istenen sanal çekirdeklerini aşamaz.

  • 400 ElasticPoolStorageBelowLimitMB - Elastik havuz depolama sınırını desteklenen sınırın altına ayarlamaya çalışılıyor.

  • 400 ElasticPoolStorageNotAllowedMB - İzin verilen değerlerle eşleşmeyen elastik havuz depolama sınırını MB olarak ayarlamaya çalışılıyor.

  • 400 ElasticPoolCapacityStorageNotAllowedMB - İzin verilen değerlerle eşleşmeyen elastik havuz depolama sınırını MB olarak ayarlamaya çalışılıyor.

  • 400 ElasticPoolStorageAboveLimitMB - Elastik havuz depolama sınırını desteklenen sınırın altında ayarlamaya çalışılıyor.

  • 400 RegionDoesNotSupportVersion - Kullanıcı, bu sunucu sürümünün desteklenmediği bir konumda belirtilen sürüme sahip bir sunucu oluşturmaya çalıştı.

  • 400 InvalidTier - Kullanıcı geçersiz bir katman belirtti.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - Kaynak veritabanının sürümü hedef veritabanından daha yüksek olamaz.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - Hedef veritabanının sürümü kaynak veritabanından daha düşük olamaz.

  • 400 ElasticPoolUpdateHkNotAllowed - Bir veya daha fazla veritabanı bellek için iyileştirilmiş nesneler kullandığından elastik havuz hizmet katmanını Premium'dan Standart veya Temel'e düşüremez.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - '' sunucusundaki{1} '{0}' veritabanı için kopyalama veya yük devretme işlemi şu anda devam ettiğinden işleme izin verilmiyor.

  • 400 RegionDoesNotAllowProvisioning - Seçilen konum yeni Windows Azure SQL Veritabanı sunucularını kabul ediyor. Bu durum daha sonra değişebilir.

  • 400 ElasticPoolOverFileSpace - Elastik havuzda yetersiz dosya alanı.

  • 400 ElasticPoolDbDtuMinBelowLimit - Veritabanı başına istenen DTU min, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDbVcoreMaxBelowLimit - Veritabanı başına istenen sanal çekirdek üst sınır, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDbVcoreMaxAboveLimit - Veritabanı başına istenen sanal çekirdek üst sınır, istenen elastik havuz hizmet katmanı için çok yüksek.

  • 400 InvalidInputValueForDatabaseVcoreMax - Kaynak Havuzu için veritabanı başına izin verilen değerlerle eşleşmeyen en yüksek sanal çekirdeği ayarlamaya çalışılıyor.

  • 400 ElasticPoolDbVcoreMinBelowLimit - Veritabanı başına istenen sanal çekirdek min, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 InvalidInputValueForDatabaseVcoreMin - Kaynak Havuzu için veritabanı başına izin verilen değerlerle eşleşmeyen sanal çekirdek min değerini ayarlamaya çalışılıyor.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Kapanım özellikli veritabanı için GeoDR bağlantısını ayarlama veya SLO'yu güncelleştirme girişimi, yalnızca her iki veritabanı da DC serisi donanım üzerinde çalışırken desteklenir.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Veritabanı başına sanal çekirdek min değerini veritabanı başına sanal çekirdek maksimum değerinden daha yüksek ayarlamaya çalışılıyor.

  • 400 InvalidLicenseType - Kullanıcı desteklenmeyen lisans türüne sahip bir veritabanı veya elastik havuz oluşturmayı veya güncelleştirmeyi denedi.

  • 400 ProvisioningDisabled - Kaynak işlem yetkilisinden gelen hata iletisini olduğu gibi, değişiklik yapmadan görüntüler

  • 400 InvalidPublicMaintenanceConfiguration - Kullanıcı iç kimliğine (yanlış biçimlendirilmiş veya yanlış bölge) dönüştürülemeyen genel bakım yapılandırmasını belirtmeye çalıştı.

  • 400 InvalidResourceRequestBody - İstek gövdesindeki kaynak veya kaynak özellikleri boş veya geçersiz.

  • 400 InvalidResourceId - Geçersiz kaynak tanımlayıcısı.

  • 400 InvalidSkuName - Geçersiz SKU adı.

  • 400 UyumsuzSkuNameAndCapacity - SKU adı ve kapasitesi arasındaki uyuşmazlık.

  • 400 UyumsuzSkuNameAndTier - SKU adı ve katmanı arasındaki uyuşmazlık.

  • 400 UyumsuzSkuNameAndFamily - SKU adı ve ailesi arasındaki uyuşmazlık.

  • 400 MismatchingSubscriptionWithUrl - Sağlanan abonelik Url'deki abonelikle eşleşmedi.

  • 400 ElasticPoolOverStorageUsage - Elastik havuzun depolama sınırına ulaşıldığında veritabanına veri yazmaya çalışma.

  • 400 InvalidSku - Kullanıcı geçersiz bir sku belirtti.

  • 400 InvalidTierSkuCombination - Belirtilen katman belirtilen sku'yu desteklemiyor.

  • 400 ServerQuotaExceeded - Sunucu izin verilen Veritabanı Aktarım Hızı Birimi sınırına ulaştı.

  • 400 ElasticPoolAlreadyExists - Sunucu zaten belirtilen ada sahip bir elastik havuz içeriyor.

  • 400 SubscriptionVcoreQuotaExceeded - Abonelik izin verilen sanal çekirdek kotasını aşacağından işlem gerçekleştirilemedi.

  • 400 InvalidInputValueForEdition - Belirtilen sürüm elastik havuz sağlama için desteklenmiyor.

  • 400 ElasticPoolDtuBelowLimit - İstenen DTU değeri istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDtuAboveLimit - İstenen DTU değeri istenen elastik havuz hizmet katmanı için çok yüksek.

  • 400 InvalidMaxSize - Geçersiz maksimum boyut.

  • 400 ElasticPoolDbDtuMaxBelowLimit - Veritabanı başına istenen DTU üst sınır, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDbDtuMaxAboveLimit - Veritabanı başına istenen DTU üst sınır, istenen elastik havuz hizmet katmanı için çok yüksek.

  • 400 InvalidInputValueForDatabaseDtuMax - kaynak havuzu için veritabanı başına izin verilen değerlerle eşleşmeyen en yüksek DTU değerini ayarlamaya çalışılıyor.

  • 400 ElasticPoolDbDtuMinAboveLimit - Veritabanı başına istenen DTU dk istenen hizmet katmanı için çok yüksek.

  • 400 ElasticPoolOverStorage - Elastik havuzun depolama sınırına ulaşıldığında veritabanına veri yazmaya çalışma.

  • 400 InvalidInputValueForDatabaseDtuMin - İzin verilen değerlerle eşleşmeyen Kaynak Havuzu için veritabanı başına DTU min değerini ayarlamaya çalışılıyor.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - Elastik havuzun istenen DTU'larını aşan elastik havuzdaki veritabanları için DTU min değeri sağlamaya çalışılıyor.

  • 400 ElasticPoolDtuUnsupported - Kullanıcı desteklenmeyen bir DTU kapasitesine sahip bir elastik havuz oluşturmayı veya güncelleştirmeyi denedi.

  • 400 ElasticPoolStorageAboveLimitGB - Elastik havuz depolama sınırını desteklenen sınırın altına ayarlamaya çalışılıyor.

  • 400 ElasticPoolsNotEnabled - Elastik havuzlar bu bölgede etkinleştirilmedi.

  • 400 ElasticPoolNotEmpty - Boş olmayan bir elastik havuzu silme isteği.

  • 400 ElasticPoolStorageBelowLimitGB - Elastik havuz depolama sınırını desteklenen sınırın altında ayarlamaya çalışılıyor.

  • 400 ElasticPoolStorageNotAllowedGB - İzin verilen değerlerle eşleşmeyen elastik havuz depolama sınırını GB olarak ayarlamaya çalışılıyor.

  • 400 ElasticPoolDatabaseLimit - Elastik havuz, veritabanı sayısı sınırına ulaştı.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - Elastik havuzun depolama sınırını depolama kullanımının altında azaltmaya çalışılıyor.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Veritabanı başına DTU min değerini veritabanı başına en yüksek DTU'dan daha yüksek bir değere ayarlamaya çalışılıyor.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - Veritabanı sayısı ve veritabanı başına en düşük sanal çekirdek sayısı, elastik havuzun istenen sanal çekirdeklerini aşamaz.

  • 400 ElasticPoolStorageBelowLimitMB - Elastik havuz depolama sınırını desteklenen sınırın altına ayarlamaya çalışılıyor.

  • 400 ElasticPoolStorageNotAllowedMB - İzin verilen değerlerle eşleşmeyen elastik havuz depolama sınırını MB olarak ayarlamaya çalışılıyor.

  • 400 ElasticPoolCapacityStorageNotAllowedMB - İzin verilen değerlerle eşleşmeyen elastik havuz depolama sınırını MB olarak ayarlamaya çalışılıyor.

  • 400 ElasticPoolStorageAboveLimitMB - Elastik havuz depolama sınırını desteklenen sınırın altına ayarlamaya çalışılıyor.

  • 400 RegionDoesNotSupportVersion - Kullanıcı, bu sunucu sürümünün desteklenmediği bir konumda belirtilen sürümün sunucusunu oluşturmayı denedi.

  • 400 InvalidTier - Kullanıcı geçersiz bir katman belirtti.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - Kaynak veritabanı hedef veritabanından daha yüksek bir sürüme sahip olamaz.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - Hedef veritabanının sürümü kaynak veritabanından daha düşük olamaz.

  • 400 ElasticPoolUpdateHkNotAllowed - Bir veya daha fazla veritabanı bellek için iyileştirilmiş nesneler kullandığından elastik havuz hizmet katmanını Premium'dan Standart veya Temel'e düşüremez.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - '{1}' sunucusundaki '{0}' veritabanı için kopyalama veya yük devretme işlemi şu anda devam ettiğinden işleme izin verilmiyor.

  • 400 RegionDoesNotAllowProvisioning - Seçilen konum yeni Windows Azure SQL Veritabanı sunucularını kabul ediyor. Bu durum daha sonra değişebilir.

  • 400 ElasticPoolOverFileSpace - Elastik havuzda yetersiz dosya alanı.

  • 400 ElasticPoolDbDtuMinBelowLimit - Veritabanı başına istenen DTU min, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDbVcoreMaxBelowLimit - Veritabanı başına istenen sanal çekirdek üst sınır, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 ElasticPoolDbVcoreMaxAboveLimit - Veritabanı başına istenen sanal çekirdek üst sınır, istenen elastik havuz hizmet katmanı için çok yüksek.

  • 400 InvalidInputValueForDatabaseVcoreMax - Kaynak Havuzu için veritabanı başına izin verilen değerlerle eşleşmeyen sanal çekirdek üst değerini ayarlamaya çalışılıyor.

  • 400 ElasticPoolDbVcoreMinBelowLimit - Veritabanı başına istenen sanal çekirdek min, istenen elastik havuz hizmet katmanı için çok düşük.

  • 400 InvalidInputValueForDatabaseVcoreMin - İzin verilen değerlerle eşleşmeyen Kaynak Havuzu için veritabanı başına en düşük sanal çekirdek ayarlamaya çalışılıyor.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Enklav özellikli veritabanı için GeoDR bağlantısını ayarlama veya SLO'yu güncelleştirme girişimi, yalnızca her iki veritabanı da DC serisi donanım üzerinde çalışırken desteklenir.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Veritabanı başına sanal çekirdek min değerini veritabanı başına sanal çekirdek maksimum değerinden daha yüksek ayarlamaya çalışılıyor.

  • 400 InvalidLicenseType - Kullanıcı desteklenmeyen lisans türüne sahip bir veritabanı veya elastik havuz oluşturmayı veya güncelleştirmeyi denedi.

  • 400 ProvisioningDisabled - Kaynak işlemi yetkilisinden gelen hata iletisini olduğu gibi, değişiklik olmadan görüntüler

  • 400 InvalidPublicMaintenanceConfiguration - Kullanıcı iç kimliğine (yanlış biçimlendirilmiş veya yanlış bölge) dönüştürülemeyen genel bakım yapılandırmasını belirtmeye çalıştı.

  • 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı

  • 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.

  • 404 ElasticPoolNotFound - Belirtilen sunucu için belirtilen elastik havuz yok.

  • 404 OperationIdNotFound - Kimlikli işlem yok.

  • 404 ElasticPoolNotFound - Belirtilen sunucu için belirtilen elastik havuz yok.

  • 405 Desteklenmiyor - Bu işlev desteklenmiyor.

  • 405 Desteklenmiyor - Bu işlev desteklenmiyor.

  • 409 ElasticPoolBusy - Meşgul bir elastik havuzda yönetim işlemi denendi.

  • 409 ServerDisabled - Sunucu devre dışı bırakıldı.

  • 409 SimultaneousSkuChangeNotAllowed - Hizmet hedefi değişiklik işlemleri bir çoğaltma ilişkisinin her iki veritabanında aynı anda çalıştırılamaz.

  • 409 ElasticPoolUpdateLinksNotInCatchup - Veritabanlarından biri kopyalama veya coğrafi çoğaltma yük devretme işlemi gerçekleştirirken elastik havuz güncelleştirilemiyor.

  • 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi.

  • 409 İşlem Kesildi - Aynı kaynakta başka bir işlem tarafından kesildiği için kaynak üzerindeki işlem tamamlanamadı.

  • 409 ElasticPoolBusy - Meşgul bir elastik havuzda yönetim işlemi denendi.

  • 409 ServerDisabled - Sunucu devre dışı bırakıldı.

  • 409 SimultaneousSkuChangeNotAllowed - Hizmet hedefi değişiklik işlemleri bir çoğaltma ilişkisinin her iki veritabanında aynı anda çalıştırılamaz.

  • 409 ElasticPoolUpdateLinksNotInCatchup - Veritabanlarından biri kopyalama veya coğrafi çoğaltma yük devretme işlemi gerçekleştirirken elastik havuz güncelleştirilemiyor.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 500 ElasticPoolFailedMoveDbToElasticPool - İç kaynak kısıtlamaları nedeniyle veritabanı elastik havuza taşınamadı. Bu geçici bir koşul olabilir, lütfen yeniden deneyin.

  • 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin.

  • 500 ElasticPoolFailedMoveDbToElasticPool - İç kaynak kısıtlamaları nedeniyle veritabanı elastik havuza taşınamadı. Bu geçici bir koşul olabilir, lütfen yeniden deneyin.

  • 503 ServiceTemporarilyUnavailable - Özellik geçici olarak kullanılamıyor.

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 503 ServiceTemporarilyUnavailable - Özellik geçici olarak kullanılamıyor.

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

Örnekler

Create or update elastic pool with all parameter
Create or update elastic pool with maintenance configuration parameter
Create or update elastic pool with minimum parameters
Create or update Hyperscale elastic pool with high availability replica count parameter

Create or update elastic pool with all parameter

Sample Request

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

Sample Response

Status code:
200 
{
  "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
    }
  }
}
Status code:
201 
{
  "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
    }
  }
}
Status code:
202

Create or update elastic pool with maintenance configuration parameter

Sample Request

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

Sample Response

Status code:
200 
{
  "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"
  }
}
Status code:
201 
{
  "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"
  }
}
Status code:
202

Create or update elastic pool with minimum parameters

Sample Request

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

Sample Response

Status code:
200 
{
  "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
    }
  }
}
Status code:
201 
{
  "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
    }
  }
}
Status code:
202

Create or update Hyperscale elastic pool with high availability replica count parameter

Sample Request

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

Sample Response

Status code:
200 
{
  "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
  }
}
Status code:
201 
{
  "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
  }
}
Status code:
202

Tanımlar

Name Description
ElasticPool

Elastik havuz.
ElasticPoolLicenseType

Bu elastik havuz için uygulanacak lisans türü.
ElasticPoolPerDatabaseSettings

Elastik havuzun veritabanı ayarlarına göre.
ElasticPoolState

Elastik havuzun durumu.
Sku

ARM Kaynağı SKU'su.

ElasticPool

Elastik havuz.

Name Tür Description
id

string

Kaynak Kimliği.
kind

string

Elastik havuz türü. Bu, Azure portal deneyimi için kullanılan meta verilerdir.
location

string

Kaynak konumu.
name

string

Kaynak adı.
properties.creationDate

string

Elastik havuzun oluşturulma tarihi (ISO8601 biçimi).
properties.highAvailabilityReplicaCount

integer

Yüksek kullanılabilirlik sağlamak için kullanılan elastik havuzla ilişkili ikincil çoğaltmaların sayısı. Yalnızca Hiper Ölçek elastik havuzları için geçerlidir.
properties.licenseType

ElasticPoolLicenseType

Bu elastik havuz için uygulanacak lisans türü.
properties.maintenanceConfigurationId

string

Elastik havuza atanan bakım yapılandırma kimliği. Bu yapılandırma, bakım güncelleştirmelerinin gerçekleşeceği süreyi tanımlar.
properties.maxSizeBytes

integer

Veritabanı elastik havuzunun bayt cinsinden depolama sınırı.
properties.minCapacity

number

Duraklatılmadıysa sunucusuz havuzun altta küçülmediği en düşük kapasite
properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

Elastik havuzun veritabanı başına ayarları.
properties.state

ElasticPoolState

Elastik havuzun durumu.
properties.zoneRedundant

boolean

Bu elastik havuzun alanlar arası yedekli olup olmadığı, bu elastik havuzun çoğaltmalarının birden çok kullanılabilirlik alanına yayılacağı anlamına gelir.
sku

Sku

Elastik havuz SKU'su.

SKU'ların listesi bölgeye ve destek teklifine göre farklılık gösterebilir. Bir Azure bölgesindeki aboneliğinizde kullanılabilen SKU'ları (SKU adı, katman/sürüm, aile ve kapasite dahil) belirlemek için REST API'yi Capabilities_ListByLocation veya aşağıdaki komutu kullanın:

az sql elastic-pool list-editions -l <location> -o table
tags

object

Kaynak etiketleri.
type

string

Kaynak türü.

ElasticPoolLicenseType

Bu elastik havuz için uygulanacak lisans türü.

Name Tür Description
BasePrice

string

LicenseIncluded

string

ElasticPoolPerDatabaseSettings

Elastik havuzun veritabanı ayarlarına göre.

Name Tür Description
maxCapacity

number

Herhangi bir veritabanının kullanabileceği maksimum kapasite.
minCapacity

number

Tüm veritabanları için minimum kapasite garanti edilir.

ElasticPoolState

Elastik havuzun durumu.

Name Tür Description
Creating

string

Disabled

string

Ready

string

Sku

ARM Kaynağı SKU'su.

Name Tür Description
capacity

integer

Belirli bir SKU'nun kapasitesi.
family

string

Hizmetin aynı SKU için farklı nesil donanımları varsa, bu durum burada yakalanabilir.
name

string

SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.
size

string

Belirli SKU'nun boyutu
tier

string

Belirli bir SKU'nun katmanı veya sürümü, örneğin Temel, Premium.