Elastic Pools - Get

  • Başvuru
Hizmet:
SQL Database
API Sürümü:
2021-11-01

Elastik havuz alır.

GET 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ü.

Yanıtlar

Name Tür Description
200 OK

ElasticPool

Başarılı
Other Status Codes

Hata Yanıtları: ***

  • 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 ResourceNotFound - İstenen kaynak bulunamadı.

  • 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ı.

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

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında 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.

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

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

Örnekler

Get a Hyperscale elastic pool
Get an elastic pool

Get a Hyperscale elastic pool

Örnek isteği

GET 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

Örnek yanıt

Durum kodu:
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
  }
}

Get an elastic pool

Örnek isteği

GET 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

Örnek yanıt

Durum kodu:
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_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

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 gibi. 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şkilendirilmiş 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 dönemi tanımlar.
properties.maxSizeBytes

integer

Veritabanı elastik havuzu için bayt cinsinden depolama sınırı.
properties.minCapacity

number

Sunucusuz havuzun duraklatılmaması durumunda altta küçülmeyecek 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. Azure bölgesindeki aboneliğiniz için 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

Minimum kapasite tüm veritabanları 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 burada yakalanabilir.
name

string

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

string

Belirli bir SKU'nun boyutu
tier

string

Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.