Aracılığıyla paylaş


Databases - List By Elastic Pool

Elastik havuzdaki veritabanlarının listesini alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}/databases?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

DatabaseListResult

Elastik havuzdaki veritabanlarının listesi başarıyla alındı.

Other Status Codes

Hata Yanıtları: **

  • 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı

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

  • 404 CannotFindObject - Nesne mevcut olmadığından veya izinleriniz olmadığından bulunamıyor

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

  • 404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

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

  • 504 RequestTimeout - Hizmet isteği izin verilen zaman aşımını aştı.

Örnekler

Gets a list of databases in an elastic pool.

Örnek isteği

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/pool1/databases?api-version=2021-11-01

Örnek yanıt

{
  "value": [
    {
      "sku": {
        "name": "ElasticPool",
        "tier": "Standard"
      },
      "kind": "v12.0,user",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 268435456000,
        "elasticPoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/Pool1",
        "status": "Online",
        "databaseId": "bfe0735f-bc87-447f-b2c2-481f4b100614",
        "creationDate": "2017-07-12T22:08:39.163Z",
        "currentServiceObjectiveName": "ElasticPool",
        "defaultSecondaryLocation": "North Europe",
        "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
      },
      "location": "southeastasia",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/DB001",
      "name": "DB001",
      "type": "Microsoft.Sql/servers/databases"
    },
    {
      "sku": {
        "name": "ElasticPool",
        "tier": "Standard"
      },
      "kind": "v12.0,user",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 268435456000,
        "elasticPoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/Pool1",
        "status": "Online",
        "databaseId": "82246152-3177-4357-b81c-a16d87ce3593",
        "creationDate": "2017-07-12T22:10:10.773Z",
        "currentServiceObjectiveName": "ElasticPool",
        "defaultSecondaryLocation": "North Europe",
        "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
      },
      "location": "southeastasia",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/DB002",
      "name": "DB002",
      "type": "Microsoft.Sql/servers/databases"
    }
  ]
}

Tanımlar

Name Description
BackupStorageRedundancy

Bu veritabanının yedeklerini depolamak için kullanılan depolama hesabı türü.

CatalogCollationType

Meta veri kataloğu harmanlaması.

CreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: normal veritabanı oluşturma.

Kopyala: Veritabanını var olan bir veritabanının kopyası olarak oluşturur. sourceDatabaseId, kaynak veritabanının kaynak kimliği olarak belirtilmelidir.

İkincil: Veritabanını var olan bir veritabanının ikincil çoğaltması olarak oluşturur. sourceDatabaseId, mevcut birincil veritabanının kaynak kimliği olarak belirtilmelidir.

PointInTimeRestore: Mevcut bir veritabanının belirli bir nokta yedeklemesini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId mevcut veritabanının kaynak kimliği olarak belirtilmelidir ve restorePointInTime belirtilmelidir.

Kurtarma: Coğrafi olarak çoğaltılmış bir yedeklemeyi geri yükleyerek bir veritabanı oluşturur. geri yüklenecek kurtarılabilir veritabanı kaynak kimliği olarak sourceDatabaseId belirtilmelidir.

Geri Yükleme: Silinen bir veritabanının yedeğini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId belirtilmelidir. sourceDatabaseId veritabanının özgün kaynak kimliğiyse sourceDatabaseDeletionDate belirtilmelidir. Aksi takdirde sourceDatabaseId geri yüklenebilir bırakılan veritabanı kaynak kimliği olmalıdır ve sourceDatabaseDeletionDate yoksayılır. zamanın önceki bir noktasından geri yüklemek için restorePointInTime da belirtilebilir.

RestoreLongTermRetentionBackup: Uzun süreli saklama kasasından geri yükleyerek bir veritabanı oluşturur. recoveryServicesRecoveryPointResourceId, kurtarma noktası kaynak kimliği olarak belirtilmelidir.

Copy, Secondary ve RestoreLongTermRetentionBackup, DataWarehouse sürümü için desteklenmez.

Database

Veritabanı kaynağı.

DatabaseIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

DatabaseIdentityType

Kimlik türü

DatabaseLicenseType

Bu veritabanı için uygulanacak lisans türü. LicenseIncludedlisansa ihtiyacınız varsa veya BasePrice lisansınız varsa ve Azure Hibrit Avantajı için uygunsanız.

DatabaseListResult

Veritabanlarının listesi.

DatabaseReadScale

Salt okunur yönlendirmenin durumu. Etkinleştirilirse, uygulama amacı bağlantı dizesi salt okunur olarak ayarlanmış bağlantılar aynı bölgedeki salt okunur ikincil çoğaltmaya yönlendirilebilir. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.

DatabaseStatus

Veritabanının durumu.

DatabaseUserIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

SampleName

Bu veritabanı oluşturulurken uygulanacak örnek şemanın adı.

SecondaryType

İkincil bir veritabanıysa, veritabanının ikincil türü. Geçerli değerler Coğrafi ve Adlandırılmış değerlerdir.

Sku

ARM Kaynağı SKU'su.

BackupStorageRedundancy

Bu veritabanının yedeklerini depolamak için kullanılan depolama hesabı türü.

Name Tür Description
Geo

string

GeoZone

string

Local

string

Zone

string

CatalogCollationType

Meta veri kataloğu harmanlaması.

Name Tür Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

CreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: normal veritabanı oluşturma.

Kopyala: Veritabanını var olan bir veritabanının kopyası olarak oluşturur. sourceDatabaseId, kaynak veritabanının kaynak kimliği olarak belirtilmelidir.

İkincil: Veritabanını var olan bir veritabanının ikincil çoğaltması olarak oluşturur. sourceDatabaseId, mevcut birincil veritabanının kaynak kimliği olarak belirtilmelidir.

PointInTimeRestore: Mevcut bir veritabanının belirli bir nokta yedeklemesini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId mevcut veritabanının kaynak kimliği olarak belirtilmelidir ve restorePointInTime belirtilmelidir.

Kurtarma: Coğrafi olarak çoğaltılmış bir yedeklemeyi geri yükleyerek bir veritabanı oluşturur. geri yüklenecek kurtarılabilir veritabanı kaynak kimliği olarak sourceDatabaseId belirtilmelidir.

Geri Yükleme: Silinen bir veritabanının yedeğini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId belirtilmelidir. sourceDatabaseId veritabanının özgün kaynak kimliğiyse sourceDatabaseDeletionDate belirtilmelidir. Aksi takdirde sourceDatabaseId geri yüklenebilir bırakılan veritabanı kaynak kimliği olmalıdır ve sourceDatabaseDeletionDate yoksayılır. zamanın önceki bir noktasından geri yüklemek için restorePointInTime da belirtilebilir.

RestoreLongTermRetentionBackup: Uzun süreli saklama kasasından geri yükleyerek bir veritabanı oluşturur. recoveryServicesRecoveryPointResourceId, kurtarma noktası kaynak kimliği olarak belirtilmelidir.

Copy, Secondary ve RestoreLongTermRetentionBackup, DataWarehouse sürümü için desteklenmez.

Name Tür Description
Copy

string

Default

string

OnlineSecondary

string

PointInTimeRestore

string

Recovery

string

Restore

string

RestoreExternalBackup

string

RestoreExternalBackupSecondary

string

RestoreLongTermRetentionBackup

string

Secondary

string

Database

Veritabanı kaynağı.

Name Tür Description
id

string

Kaynak Kimliği.

identity

DatabaseIdentity

Veritabanının Azure Active Directory kimliği.

kind

string

Bir tür veritabanı. Bu, Azure portal deneyimi için kullanılan meta verilerdir.

location

string

Kaynak konumu.

managedBy

string

Veritabanını yöneten kaynak.

name

string

Kaynak adı.

properties.autoPauseDelay

integer

Veritabanının otomatik olarak duraklatıldığı dakika cinsinden süre. -1 değeri, otomatik duraklamanın devre dışı bırakıldığını gösterir

properties.catalogCollation

CatalogCollationType

Meta veri kataloğu harmanlaması.

properties.collation

string

Veritabanının harmanlaması.

properties.createMode

CreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: normal veritabanı oluşturma.

Kopyala: Varolan bir veritabanının kopyası olarak bir veritabanı oluşturur. sourceDatabaseId, kaynak veritabanının kaynak kimliği olarak belirtilmelidir.

İkincil: Mevcut bir veritabanının ikincil çoğaltması olarak bir veritabanı oluşturur. sourceDatabaseId, mevcut birincil veritabanının kaynak kimliği olarak belirtilmelidir.

PointInTimeRestore: Mevcut bir veritabanının belirli bir nokta yedeklemesini geri yükleyerek bir veritabanı oluşturur. mevcut veritabanının kaynak kimliği olarak sourceDatabaseId belirtilmelidir ve restorePointInTime belirtilmelidir.

Kurtarma: Coğrafi olarak çoğaltılmış bir yedeklemeyi geri yükleyerek bir veritabanı oluşturur. geri yüklenecek kurtarılabilir veritabanı kaynak kimliği olarak sourceDatabaseId belirtilmelidir.

Geri Yükleme: Silinen bir veritabanının yedeğini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId belirtilmelidir. Veritabanının özgün kaynak kimliği sourceDatabaseId ise sourceDatabaseDeletionDate belirtilmelidir. Aksi takdirde sourceDatabaseId geri yüklenebilir bırakılan veritabanı kaynak kimliği olmalıdır ve sourceDatabaseDeletionDate yoksayılır. restorePointInTime, zamanın önceki bir noktasından geri yüklemek için de belirtilebilir.

RestoreLongTermRetentionBackup: Uzun süreli saklama kasasından geri yükleyerek bir veritabanı oluşturur. kurtarma noktası kaynak kimliği olarak recoveryServicesRecoveryPointResourceId belirtilmelidir.

Copy, Secondary ve RestoreLongTermRetentionBackup, DataWarehouse sürümü için desteklenmez.

properties.creationDate

string

Veritabanının oluşturulma tarihi (ISO8601 biçimi).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Bu veritabanı için yedeklemeleri depolamak için kullanılan depolama hesabı türü.

properties.currentServiceObjectiveName

string

Veritabanının geçerli hizmet düzeyi hedef adı.

properties.currentSku

Sku

SKU'nun adı ve katmanı.

properties.databaseId

string

Veritabanının kimliği.

properties.defaultSecondaryLocation

string

Bu veritabanı için varsayılan ikincil bölge.

properties.earliestRestoreDate

string

Bu, bu veritabanı için geri yüklemenin sağlandığında en erken başlangıç tarihini ve saatini kaydeder (ISO8601 biçimi).

properties.elasticPoolId

string

Bu veritabanını içeren elastik havuzun kaynak tanımlayıcısı.

properties.failoverGroupId

string

Bu veritabanının ait olduğu Yük Devretme Grubu kaynak tanımlayıcısı.

properties.federatedClientId

string

Veritabanı CMK senaryosu başına kiracılar arası için kullanılan İstemci kimliği

properties.highAvailabilityReplicaCount

integer

Veritabanıyla ilişkilendirilmiş ve yüksek kullanılabilirlik sağlamak için kullanılan ikincil çoğaltmaların sayısı. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.

properties.isInfraEncryptionEnabled

boolean

Bu veritabanı için infra şifrelemesi etkinleştirildi.

properties.isLedgerOn

boolean

Bu veritabanının bir kayıt defteri veritabanı olup olmadığı, veritabanındaki tüm tabloların kayıt defteri tabloları olduğu anlamına gelir. Not: Veritabanı oluşturulduktan sonra bu özelliğin değeri değiştirilemez.

properties.licenseType

DatabaseLicenseType

Bu veritabanı için uygulanacak lisans türü. LicenseIncludedlisansa ihtiyacınız varsa veya BasePrice lisansınız varsa ve Azure Hibrit Avantajı için uygunsanız.

properties.longTermRetentionBackupResourceId

string

Bu veritabanının oluşturma işlemiyle ilişkili uzun süreli saklama yedeğinin kaynak tanımlayıcısı.

properties.maintenanceConfigurationId

string

Veritabanına 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.maxLogSizeBytes

integer

Bu veritabanı için en büyük günlük boyutu.

properties.maxSizeBytes

integer

Veritabanının bayt cinsinden ifade edilen en büyük boyutu.

properties.minCapacity

number

Duraklatılmadıysa, veritabanının her zaman ayıracağı en düşük kapasite

properties.pausedDate

string

Veritabanının kullanıcı yapılandırması veya eylemi (ISO8601 biçimi) tarafından duraklatıldığı tarih. Veritabanı hazırsa null.

properties.readScale

DatabaseReadScale

Salt okunur yönlendirmenin durumu. Etkinleştirilirse, uygulama amacı bağlantı dizesi salt okunur olarak ayarlanmış bağlantılar aynı bölgedeki salt okunur ikincil çoğaltmaya yönlendirilebilir. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.

properties.recoverableDatabaseId

string

Bu veritabanının oluşturma işlemiyle ilişkili kurtarılabilir veritabanının kaynak tanımlayıcısı.

properties.recoveryServicesRecoveryPointId

string

Bu veritabanının oluşturma işlemiyle ilişkili kurtarma noktasının kaynak tanımlayıcısı.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Bu veritabanının yedeklerini depolamak için kullanılacak depolama hesabı türü.

properties.requestedServiceObjectiveName

string

Veritabanının istenen hizmet düzeyi hedef adı.

properties.restorableDroppedDatabaseId

string

Bu veritabanının oluşturma işlemiyle ilişkili geri yüklenebilen bırakılan veritabanının kaynak tanımlayıcısı.

properties.restorePointInTime

string

Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir.

properties.resumedDate

string

Veritabanının kullanıcı eylemi veya veritabanı oturum açma (ISO8601 biçimi) tarafından sürdürüldiği tarih. Veritabanı duraklatıldıysa null.

properties.sampleName

SampleName

Bu veritabanını oluştururken uygulanacak örnek şemanın adı.

properties.secondaryType

SecondaryType

İkincil bir veritabanıysa, veritabanının ikincil türü. Geçerli değerler Geo ve Named değerleridir.

properties.sourceDatabaseDeletionDate

string

Veritabanının silindiği saati belirtir.

properties.sourceDatabaseId

string

Bu veritabanının oluşturma işlemiyle ilişkili kaynak veritabanının kaynak tanımlayıcısı.

properties.sourceResourceId

string

Bu veritabanının oluşturma işlemiyle ilişkili kaynağın kaynak tanımlayıcısı.

Bu özellik yalnızca DataWarehouse sürümü için desteklenir ve abonelikler arasında geri yüklemeye izin verir.

sourceResourceId belirtildiğinde sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId ve sourceDatabaseDeletionDate belirtilmemeli ve CreateMode PointInTimeRestore, Restore veya Recover olmalıdır.

createMode PointInTimeRestore olduğunda, sourceResourceId mevcut veritabanının veya mevcut SQL havuzunun kaynak kimliği olmalı ve restorePointInTime belirtilmelidir.

createMode Geri Yükleme olduğunda, sourceResourceId geri yüklenebilir bırakılan veritabanının veya geri yüklenebilir bırakılan SQL havuzunun kaynak kimliği olmalıdır.

createMode Kurtar olduğunda sourceResourceId kurtarılabilir veritabanının veya kurtarılabilir SQL havuzunun kaynak kimliği olmalıdır.

Kaynak abonelik hedef abonelikten farklı bir kiracıya aitse, "x-ms-authorization-auxiliary" üst bilgisi kaynak kiracı için kimlik doğrulama belirteci içermelidir. "x-ms-authorization-auxiliary" üst bilgisi hakkında daha fazla ayrıntı için bkz. https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

DatabaseStatus

Veritabanının durumu.

properties.zoneRedundant

boolean

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

sku

Sku

Veritabanı SKU'su.

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

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags

object

Kaynak etiketleri.

type

string

Kaynak türü.

DatabaseIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name Tür Description
tenantId

string

Azure Active Directory kiracı kimliği.

type

DatabaseIdentityType

Kimlik türü

userAssignedIdentities

<string,  DatabaseUserIdentity>

Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

DatabaseIdentityType

Kimlik türü

Name Tür Description
None

string

UserAssigned

string

DatabaseLicenseType

Bu veritabanı için uygulanacak lisans türü. LicenseIncludedlisansa ihtiyacınız varsa veya BasePrice lisansınız varsa ve Azure Hibrit Avantajı için uygunsanız.

Name Tür Description
BasePrice

string

LicenseIncluded

string

DatabaseListResult

Veritabanlarının listesi.

Name Tür Description
nextLink

string

Sonuçların sonraki sayfasını almak için bağlantı.

value

Database[]

Sonuç dizisi.

DatabaseReadScale

Salt okunur yönlendirmenin durumu. Etkinleştirilirse, uygulama amacı bağlantı dizesi salt okunur olarak ayarlanmış bağlantılar aynı bölgedeki salt okunur ikincil çoğaltmaya yönlendirilebilir. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.

Name Tür Description
Disabled

string

Enabled

string

DatabaseStatus

Veritabanının durumu.

Name Tür Description
AutoClosed

string

Copying

string

Creating

string

Disabled

string

EmergencyMode

string

Inaccessible

string

Offline

string

OfflineChangingDwPerformanceTiers

string

OfflineSecondary

string

Online

string

OnlineChangingDwPerformanceTiers

string

Paused

string

Pausing

string

Recovering

string

RecoveryPending

string

Restoring

string

Resuming

string

Scaling

string

Shutdown

string

Standby

string

Starting

string

Stopped

string

Stopping

string

Suspect

string

DatabaseUserIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name Tür Description
clientId

string

Azure Active Directory istemci kimliği.

principalId

string

Azure Active Directory asıl kimliği.

SampleName

Bu veritabanı oluşturulurken uygulanacak örnek şemanın adı.

Name Tür Description
AdventureWorksLT

string

WideWorldImportersFull

string

WideWorldImportersStd

string

SecondaryType

İkincil bir veritabanıysa, veritabanının ikincil türü. Geçerli değerler Coğrafi ve Adlandırılmış değerlerdir.

Name Tür Description
Geo

string

Named

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