Databases - List By Server

Veritabanlarının listesini alır.

HTTP
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases?api-version=2021-11-01
HTTP
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases?$skipToken={$skipToken}&api-version=2021-11-01

URI Parametreleri

Name İçinde Gerekli Tür Description
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ü.

$skipToken
query

string

Yanıtlar

Name Tür Description
200 OK

DatabaseListResult

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.

Örnekler

Gets a list of databases.

Örnek isteği

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

Örnek yanıt

JSON
{
  "value": [
    {
      "sku": {
        "name": "BC_Gen4",
        "tier": "BusinessCritical",
        "capacity": 2
      },
      "kind": "v12.0,user,vcore",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 268435456000,
        "status": "Online",
        "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
        "creationDate": "2017-06-07T04:41:33.937Z",
        "currentServiceObjectiveName": "BC_Gen4_2",
        "requestedServiceObjectiveName": "BC_Gen4_2",
        "defaultSecondaryLocation": "North Europe",
        "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
        "licenseType": "LicenseIncluded",
        "maxLogSizeBytes": 104857600,
        "isInfraEncryptionEnabled": false,
        "zoneRedundant": false,
        "readScale": "Enabled",
        "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
        "currentSku": {
          "name": "BC_Gen4",
          "tier": "BusinessCritical",
          "capacity": 2
        },
        "currentBackupStorageRedundancy": "Zone",
        "requestedBackupStorageRedundancy": "Zone",
        "isLedgerOn": false
      },
      "location": "southeastasia",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
      "name": "testdb",
      "type": "Microsoft.Sql/servers/databases"
    },
    {
      "sku": {
        "name": "System0",
        "tier": "System",
        "capacity": 0
      },
      "kind": "v12.0,system",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 32212254720,
        "status": "Online",
        "databaseId": "e6be351f-2cc9-4604-9e52-b0b28b2710b0",
        "creationDate": "2017-06-07T04:23:42.537Z",
        "currentServiceObjectiveName": "System0",
        "requestedServiceObjectiveName": "System0",
        "defaultSecondaryLocation": "North Europe",
        "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
        "isInfraEncryptionEnabled": false,
        "zoneRedundant": false,
        "readScale": "Disabled",
        "currentSku": {
          "name": "System0",
          "tier": "System",
          "capacity": 0
        },
        "currentBackupStorageRedundancy": "Local",
        "requestedBackupStorageRedundancy": "Local",
        "isLedgerOn": false
      },
      "location": "southeastasia",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/master",
      "name": "master",
      "type": "Microsoft.Sql/servers/databases"
    }
  ]
}

Tanımlar

Name Description
BackupStorageRedundancy

Bu veritabanı için yedeklemeleri 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: 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.

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ını oluştururken uygulanacak örnek şemanın adı.

SecondaryType

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

Sku

ARM Kaynağı SKU'su.

BackupStorageRedundancy

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

Değer Description
Geo
GeoZone
Local
Zone

CatalogCollationType

Meta veri kataloğu harmanlaması.

Değer Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

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.

Değer Description
Copy
Default
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
Secondary

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 :

Azure CLI
az sql db list-editions -l <location> -o table
PowerShell
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ü

Değer Description
None
UserAssigned

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.

Değer Description
BasePrice
LicenseIncluded

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.

Değer Description
Disabled
Enabled

DatabaseStatus

Veritabanının durumu.

Değer Description
AutoClosed
Copying
Creating
Disabled
EmergencyMode
Inaccessible
Offline
OfflineChangingDwPerformanceTiers
OfflineSecondary
Online
OnlineChangingDwPerformanceTiers
Paused
Pausing
Recovering
RecoveryPending
Restoring
Resuming
Scaling
Shutdown
Standby
Starting
Stopped
Stopping
Suspect

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ını oluştururken uygulanacak örnek şemanın adı.

Değer Description
AdventureWorksLT
WideWorldImportersFull
WideWorldImportersStd

SecondaryType

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

Değer Description
Geo
Named

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