Databases - List By Server

Lekéri az adatbázisok listáját.

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

URI-paraméterek

Name In Kötelező Típus Description
resourceGroupName
path True

string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True

string

A kiszolgáló neve.

subscriptionId
path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True

string

A kéréshez használandó API-verzió.

$skipToken
query

string

Válaszok

Name Típus Description
200 OK

DatabaseListResult

Sikerült lekérni az adatbázisok listáját.

Other Status Codes

Hibaválaszok: ***

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

  • 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

Példák

Gets a list of databases.

Sample Request

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

Sample Response

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

Definíciók

Name Description
BackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.

CatalogCollationType

A metaadat-katalógus rendezése.

CreateMode

Megadja az adatbázis-létrehozás módját.

Alapértelmezett: normál adatbázis-létrehozás.

Másolás: létrehoz egy adatbázist egy meglévő adatbázis másolataként. A sourceDatabaseId értéket a forrásadatbázis erőforrás-azonosítójaként kell megadni.

Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. A sourceDatabaseId értéket a meglévő elsődleges adatbázis erőforrás-azonosítójaként kell megadni.

PointInTimeRestore: Adatbázist hoz létre egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. A sourceDatabaseId értéket meg kell adni a meglévő adatbázis erőforrás-azonosítójaként, és meg kell adni a restorePointInTime értéket.

Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A sourceDatabaseId értéket meg kell adni a visszaállítandó helyreállítható adatbázis-erőforrás-azonosítóként.

Visszaállítás: Adatbázist hoz létre egy törölt adatbázis biztonsági másolatának visszaállításával. meg kell adni a sourceDatabaseId értéket. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor a sourceDatabaseDeletionDate értéket kell megadni. Ellenkező esetben a sourceDatabaseId fájlnak a visszaállítható elvetett adatbázis-erőforrás-azonosítónak kell lennie, és a sourceDatabaseDeletionDate paraméter figyelmen kívül lesz hagyva. A restorePointInTime egy korábbi időpontból történő visszaállításhoz is megadható.

RestoreLongTermRetentionBackup: Létrehoz egy adatbázist egy hosszú távú megőrzési tárolóból történő visszaállítással. recoveryServicesRecoveryPointResourceId értéket kell megadni a helyreállítási pont erőforrás-azonosítójaként.

A Copy, a Secondary és a RestoreLongTermRetentionBackup nem támogatott a DataWarehouse-kiadásban.

Database

Adatbázis-erőforrás.

DatabaseIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

DatabaseIdentityType

Az identitás típusa

DatabaseLicenseType

Az adatbázishoz alkalmazandó licenctípus. LicenseIncludedha licencre van szüksége, vagy BasePrice ha rendelkezik licenccel, és jogosult a Azure Hybrid Benefit.

DatabaseListResult

Az adatbázisok listája.

DatabaseReadScale

Az írásvédett útválasztás állapota. Ha engedélyezve van, azokat a kapcsolatokat, amelyeknél az alkalmazás szándéka a kapcsolati karakterlánc írásvédettre van állítva, átirányíthatja egy, ugyanabban a régióban lévő, olvasható másodlagos replikára. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.

DatabaseStatus

Az adatbázis állapota.

DatabaseUserIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

SampleName

Az adatbázis létrehozásakor alkalmazandó mintaséma neve.

SecondaryType

Az adatbázis másodlagos típusa, ha másodlagos. Az érvényes értékek a Geo és a Named.

Sku

ARM-erőforrás-termékváltozat.

BackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.

Name Típus Description
Geo

string

GeoZone

string

Local

string

Zone

string

CatalogCollationType

A metaadat-katalógus rendezése.

Name Típus Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

CreateMode

Megadja az adatbázis-létrehozás módját.

Alapértelmezett: normál adatbázis-létrehozás.

Másolás: létrehoz egy adatbázist egy meglévő adatbázis másolataként. A sourceDatabaseId értéket a forrásadatbázis erőforrás-azonosítójaként kell megadni.

Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. A sourceDatabaseId értéket a meglévő elsődleges adatbázis erőforrás-azonosítójaként kell megadni.

PointInTimeRestore: Adatbázist hoz létre egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. A sourceDatabaseId értéket meg kell adni a meglévő adatbázis erőforrás-azonosítójaként, és meg kell adni a restorePointInTime értéket.

Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A sourceDatabaseId értéket meg kell adni a visszaállítandó helyreállítható adatbázis-erőforrás-azonosítóként.

Visszaállítás: Adatbázist hoz létre egy törölt adatbázis biztonsági másolatának visszaállításával. meg kell adni a sourceDatabaseId értéket. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor a sourceDatabaseDeletionDate értéket kell megadni. Ellenkező esetben a sourceDatabaseId fájlnak a visszaállítható elvetett adatbázis-erőforrás-azonosítónak kell lennie, és a sourceDatabaseDeletionDate paraméter figyelmen kívül lesz hagyva. A restorePointInTime egy korábbi időpontból történő visszaállításhoz is megadható.

RestoreLongTermRetentionBackup: Létrehoz egy adatbázist egy hosszú távú megőrzési tárolóból történő visszaállítással. recoveryServicesRecoveryPointResourceId értéket kell megadni a helyreállítási pont erőforrás-azonosítójaként.

A Copy, a Secondary és a RestoreLongTermRetentionBackup nem támogatott a DataWarehouse-kiadásban.

Name Típus Description
Copy

string

Default

string

OnlineSecondary

string

PointInTimeRestore

string

Recovery

string

Restore

string

RestoreExternalBackup

string

RestoreExternalBackupSecondary

string

RestoreLongTermRetentionBackup

string

Secondary

string

Database

Adatbázis-erőforrás.

Name Típus Description
id

string

Erőforrás-azonosító.

identity

DatabaseIdentity

Az adatbázis Azure Active Directory-identitása.

kind

string

Az adatbázis típusa. Ez a Azure Portal élményhez használt metaadatok.

location

string

Erőforrás helye.

managedBy

string

Az adatbázist kezelő erőforrás.

name

string

Erőforrás neve.

properties.autoPauseDelay

integer

Az adatbázis automatikus szüneteltetése utáni percekben megadott idő. A -1 érték azt jelenti, hogy az automatikus szüneteltetés le van tiltva

properties.catalogCollation

CatalogCollationType

A metaadat-katalógus rendezése.

properties.collation

string

Az adatbázis rendezése.

properties.createMode

CreateMode

Megadja az adatbázis-létrehozás módját.

Alapértelmezett: normál adatbázis-létrehozás.

Másolás: létrehoz egy adatbázist egy meglévő adatbázis másolataként. A sourceDatabaseId értéket a forrásadatbázis erőforrás-azonosítójaként kell megadni.

Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. A sourceDatabaseId értéket a meglévő elsődleges adatbázis erőforrás-azonosítójaként kell megadni.

PointInTimeRestore: Adatbázist hoz létre egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. A sourceDatabaseId értéket meg kell adni a meglévő adatbázis erőforrás-azonosítójaként, és meg kell adni a restorePointInTime értéket.

Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A sourceDatabaseId értéket meg kell adni a visszaállítandó helyreállítható adatbázis-erőforrás-azonosítóként.

Visszaállítás: Adatbázist hoz létre egy törölt adatbázis biztonsági másolatának visszaállításával. meg kell adni a sourceDatabaseId értéket. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor a sourceDatabaseDeletionDate értéket kell megadni. Ellenkező esetben a sourceDatabaseId fájlnak a visszaállítható elvetett adatbázis-erőforrás-azonosítónak kell lennie, és a sourceDatabaseDeletionDate paraméter figyelmen kívül lesz hagyva. A restorePointInTime egy korábbi időpontból történő visszaállításhoz is megadható.

RestoreLongTermRetentionBackup: Létrehoz egy adatbázist egy hosszú távú megőrzési tárolóból történő visszaállítással. recoveryServicesRecoveryPointResourceId értéket kell megadni a helyreállítási pont erőforrás-azonosítójaként.

A Copy, a Secondary és a RestoreLongTermRetentionBackup nem támogatott a DataWarehouse-kiadásban.

properties.creationDate

string

Az adatbázis létrehozásának dátuma (ISO8601 formátum).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.

properties.currentServiceObjectiveName

string

Az adatbázis aktuális szolgáltatásiszint-célkitűzésének neve.

properties.currentSku

Sku

A termékváltozat neve és szintje.

properties.databaseId

string

Az adatbázis azonosítója.

properties.defaultSecondaryLocation

string

Az adatbázis alapértelmezett másodlagos régiója.

properties.earliestRestoreDate

string

Ez rögzíti az adatbázishoz (ISO8601 formátumban) elérhető legkorábbi visszaállítási dátumot és időpontot.

properties.elasticPoolId

string

Az adatbázist tartalmazó rugalmas készlet erőforrás-azonosítója.

properties.failoverGroupId

string

Feladatátvételi csoport erőforrás-azonosítója, amelyhez ez az adatbázis tartozik.

properties.federatedClientId

string

Az adatbázisonkénti bérlők közötti CMK-forgatókönyvhez használt ügyfél-azonosító

properties.highAvailabilityReplicaCount

integer

Az adatbázishoz társított másodlagos replikák száma, amelyek magas rendelkezésre állást biztosítanak. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.

properties.isInfraEncryptionEnabled

boolean

Az adatbázishoz engedélyezve van az infratitkosítás.

properties.isLedgerOn

boolean

Azt, hogy ez az adatbázis tranzakciónapló-adatbázis-e, vagyis az adatbázis összes táblája tranzakciónapló-tábla. Megjegyzés: a tulajdonság értéke nem módosítható az adatbázis létrehozása után.

properties.licenseType

DatabaseLicenseType

Az adatbázishoz alkalmazandó licenctípus. LicenseIncludedha licencre van szüksége, vagy BasePrice ha rendelkezik licenccel, és jogosult a Azure Hybrid Benefit.

properties.longTermRetentionBackupResourceId

string

Az adatbázis létrehozási műveletéhez társított hosszú távú megőrzési biztonsági mentés erőforrás-azonosítója.

properties.maintenanceConfigurationId

string

Az adatbázishoz rendelt karbantartási konfiguráció azonosítója. Ez a konfiguráció határozza meg a karbantartási frissítések bekövetkezési idejét.

properties.maxLogSizeBytes

integer

Az adatbázis maximális naplómérete.

properties.maxSizeBytes

integer

Az adatbázis maximális mérete bájtban kifejezve.

properties.minCapacity

number

Minimális kapacitás, amelyet az adatbázis mindig lefoglal, ha nincs szüneteltetve

properties.pausedDate

string

Az a dátum, amikor az adatbázist felhasználói konfiguráció vagy művelet (ISO8601 formátum) szüneteltette. Null érték, ha az adatbázis készen áll.

properties.readScale

DatabaseReadScale

Az írásvédett útválasztás állapota. Ha engedélyezve van, azokat a kapcsolatokat, amelyeknél az alkalmazás szándéka a kapcsolati karakterlánc írásvédettre van állítva, átirányíthatja egy, ugyanabban a régióban lévő, olvasható másodlagos replikára. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.

properties.recoverableDatabaseId

string

Az adatbázis létrehozási műveletéhez társított helyreállítható adatbázis erőforrás-azonosítója.

properties.recoveryServicesRecoveryPointId

string

Az adatbázis létrehozási műveletéhez társított helyreállítási pont erőforrás-azonosítója.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Az adatbázis biztonsági másolatainak tárolására használt tárfióktípus.

properties.requestedServiceObjectiveName

string

Az adatbázis kért szolgáltatásiszint-célkitűzésének neve.

properties.restorableDroppedDatabaseId

string

Az adatbázis létrehozási műveletéhez társított visszaállítható elvetett adatbázis erőforrás-azonosítója.

properties.restorePointInTime

string

Megadja annak a forrásadatbázisnak az időpontját (ISO8601 formátumát), amely az új adatbázis létrehozásához lesz visszaállítva.

properties.resumedDate

string

Az adatbázis felhasználói művelet vagy adatbázis-bejelentkezés (ISO8601 formátum) általi folytatásának dátuma. Null érték, ha az adatbázis szüneteltetve van.

properties.sampleName

SampleName

Az adatbázis létrehozásakor alkalmazandó mintaséma neve.

properties.secondaryType

SecondaryType

Az adatbázis másodlagos típusa, ha másodlagos. Az érvényes értékek a Geo és a Named.

properties.sourceDatabaseDeletionDate

string

Az adatbázis törlésének idejét adja meg.

properties.sourceDatabaseId

string

Az adatbázis létrehozási műveletéhez társított forrásadatbázis erőforrás-azonosítója.

properties.sourceResourceId

string

Az adatbázis létrehozási műveletéhez társított forrás erőforrás-azonosítója.

Ez a tulajdonság csak a DataWarehouse kiadás esetében támogatott, és lehetővé teszi a visszaállítást az előfizetések között.

A sourceResourceId megadásakor a sourceDatabaseId, a recoverableDatabaseId, a restoreableDroppedDatabaseId és a sourceDatabaseDeletionDate nem adható meg, és a CreateMode paraméternek PointInTimeRestore, Restore vagy Recover értékűnek kell lennie.

Ha a createMode értéke PointInTimeRestore, a sourceResourceId értéknek a meglévő adatbázis vagy meglévő SQL-készlet erőforrás-azonosítójának kell lennie, és meg kell adni a restorePointInTime értéket.

Ha a createMode visszaállítás, a sourceResourceId azonosítónak a visszaállítható elvetett adatbázis vagy visszaállítható elvetett SQL-készlet erőforrás-azonosítójának kell lennie.

Ha a createMode értéke Helyreállítás, a sourceResourceId paraméternek a helyreállítható adatbázis vagy helyreállítható SQL-készlet erőforrás-azonosítójának kell lennie.

Ha a forrás-előfizetés egy másik bérlőhöz tartozik, mint a célelőfizetés, az "x-ms-authorization-auxiliary" fejlécnek tartalmaznia kell a forrásbérlőhöz tartozó hitelesítési jogkivonatot. További információ az "x-ms-authorization-auxiliary" fejlécről: https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

DatabaseStatus

Az adatbázis állapota.

properties.zoneRedundant

boolean

Azt jelzi, hogy az adatbázis zónaredundáns-e, ami azt jelenti, hogy az adatbázis replikái több rendelkezésre állási zónában is el lesznek osztva.

sku

Sku

Az adatbázis termékváltozata.

A termékváltozatok listája régiónként és támogatási ajánlatonként változhat. Az Előfizetéséhez egy Azure-régióban elérhető termékváltozatok (beleértve a termékváltozat nevét, szintjét/kiadását, családját és kapacitását) meghatározásához használja a Capabilities_ListByLocation REST API-t vagy az alábbi parancsok egyikét:

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

object

Erőforráscímkék.

type

string

Erőforrástípus.

DatabaseIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name Típus Description
tenantId

string

Az Azure Active Directory-bérlő azonosítója.

type

DatabaseIdentityType

Az identitás típusa

userAssignedIdentities

<string,  DatabaseUserIdentity>

A felhasználó által hozzárendelt használandó identitások erőforrás-azonosítói

DatabaseIdentityType

Az identitás típusa

Name Típus Description
None

string

UserAssigned

string

DatabaseLicenseType

Az adatbázishoz alkalmazandó licenctípus. LicenseIncludedha licencre van szüksége, vagy BasePrice ha rendelkezik licenccel, és jogosult a Azure Hybrid Benefit.

Name Típus Description
BasePrice

string

LicenseIncluded

string

DatabaseListResult

Az adatbázisok listája.

Name Típus Description
nextLink

string

Hivatkozás az eredmények következő oldalának lekéréséhez.

value

Database[]

Eredmények tömbje.

DatabaseReadScale

Az írásvédett útválasztás állapota. Ha engedélyezve van, azokat a kapcsolatokat, amelyeknél az alkalmazás szándéka a kapcsolati karakterlánc írásvédettre van állítva, átirányíthatja egy, ugyanabban a régióban lévő, olvasható másodlagos replikára. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.

Name Típus Description
Disabled

string

Enabled

string

DatabaseStatus

Az adatbázis állapota.

Name Típus 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

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name Típus Description
clientId

string

Az Azure Active Directory-ügyfél azonosítója.

principalId

string

Az Azure Active Directory egyszerű azonosítója.

SampleName

Az adatbázis létrehozásakor alkalmazandó mintaséma neve.

Name Típus Description
AdventureWorksLT

string

WideWorldImportersFull

string

WideWorldImportersStd

string

SecondaryType

Az adatbázis másodlagos típusa, ha másodlagos. Az érvényes értékek a Geo és a Named.

Name Típus Description
Geo

string

Named

string

Sku

ARM-erőforrás-termékváltozat.

Name Típus Description
capacity

integer

Az adott termékváltozat kapacitása.

family

string

Ha a szolgáltatás eltérő hardvergenerációval rendelkezik ugyanahhoz a termékváltozathoz, akkor az itt rögzíthető.

name

string

A termékváltozat neve, általában egy betű + szám kód, például P3.

size

string

Az adott termékváltozat mérete

tier

string

Az adott termékváltozat szintje vagy kiadása, például Alapszintű, Prémium.