Freigeben über


Databases - List By Server

Ruft eine Liste der Datenbanken ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

serverName
path True

string

Name des Servers

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

$skipToken
query

string

Antworten

Name Typ Beschreibung
200 OK

DatabaseListResult

Azure-Operation erfolgreich abgeschlossen.

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Gets a list of databases configured with enclave type.
Gets a list of databases.

Gets a list of databases configured with enclave type.

Beispielanforderung

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

Beispiel für eine Antwort

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

Gets a list of databases.

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
AlwaysEncryptedEnclaveType

Typ der in der Datenbank angeforderten Enklave, d. h. Standard- oder VBS-Enklaven.

AvailabilityZoneType

Gibt die Verfügbarkeitszone an, an die die Datenbank angeheftet ist.

BackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird.

CatalogCollationType

Sortierung des Metadatenkatalogs.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

CreateMode

Gibt den Modus der Datenbankerstellung an.

Standard: regelmäßige Datenbankerstellung.

Kopie: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden.

Sekundär: Erstellt eine Datenbank als sekundäres Replikat einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden.

PointInTimeRestore: Erstellt eine Datenbank durch Wiederherstellen einer Zeitsicherung einer vorhandenen Datenbank. "sourceDatabaseId" muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden, und "restorePointInTime" muss angegeben werden.

Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen.

Wiederherstellen: Erstellt eine Datenbank durch Wiederherstellen einer Sicherung einer gelöschten Datenbank. sourceDatabaseId muss angegeben werden. Wenn "sourceDatabaseId" die ursprüngliche Ressourcen-ID der Datenbank ist, muss "sourceDatabaseDeletionDate" angegeben werden. Andernfalls muss "sourceDatabaseId" die wiederherstellbare verworfene Datenbankressourcen-ID sein, und "sourceDatabaseDeletionDate" wird ignoriert. restorePointInTime kann auch angegeben werden, um sie von einem früheren Zeitpunkt wiederherzustellen.

RestoreLongTermRetentionBackup: Erstellt eine Datenbank, indem sie aus einem langfristigen Aufbewahrungstresor wiederhergestellt wird. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, Secondary und RestoreLongTermRetentionBackup werden für DataWarehouse Edition nicht unterstützt.

Database

Eine Datenbankressource.

DatabaseIdentity

Azure Active Directory Identitätskonfiguration für eine Ressource.

DatabaseIdentityType

Der Identitätstyp

DatabaseKey

Schlüssel auf Datenbankebene, der für die Verschlüsselung ruhender Daten verwendet wird.

DatabaseKeyType

Der Datenbankschlüsseltyp. Nur unterstützter Wert ist "AzureKeyVault".

DatabaseLicenseType

Der lizenztyp, der für diese Datenbank gilt. LicenseIncluded, wenn du eine Lizenz brauchst, oder BasePrice, wenn du eine Lizenz hast und für die Azure-Hybridvorteil berechtigt bist.

DatabaseListResult

Die Antwort eines Datenbanklistenvorgangs.

DatabaseReadScale

Der Status des schreibgeschützten Routings. Wenn aktiviert, können Verbindungen, bei denen die Anwendungsabsicht in ihrer Verbindungszeichenfolge auf Readonly gesetzt ist, an ein readonly-sekundäres Replikat im selben Bereich weitergeleitet werden. Gilt nicht für eine Hyperscale-Datenbank innerhalb eines elastischen Pools.

DatabaseStatus

Der Status der Datenbank.

DatabaseUserIdentity

Azure Active Directory Identitätskonfiguration für eine Ressource.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

FreeLimitExhaustionBehavior

Gibt das Verhalten an, wenn monatliche kostenlose Grenzwerte für die kostenlose Datenbank erschöpft sind.

AutoPause: Die Datenbank wird automatisch angehalten, wenn die freien Grenzwerte für den Rest des Monats erschöpft sind.

BillForUsage: Die Datenbank wird weiterhin online sein, wenn die freien Grenzwerte erschöpft sind, und jegliche Überlastung wird in Rechnung gestellt.

SampleName

Der Name des Beispielschemas, das beim Erstellen dieser Datenbank angewendet werden soll.

SecondaryType

Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datenbank handelt. Gültige Werte sind Geo, Named and Standby.

Sku

Eine ARM-Ressourcen-SKU.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

AlwaysEncryptedEnclaveType

Typ der in der Datenbank angeforderten Enklave, d. h. Standard- oder VBS-Enklaven.

Wert Beschreibung
Default

Vorgabe

VBS

VBS

AvailabilityZoneType

Gibt die Verfügbarkeitszone an, an die die Datenbank angeheftet ist.

Wert Beschreibung
NoPreference

Keine Präferenz

1

1

2

2

3

3

BackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird.

Wert Beschreibung
Geo

Geo

Local

Lokal

Zone

Zone

GeoZone

GeoZone

CatalogCollationType

Sortierung des Metadatenkatalogs.

Wert Beschreibung
DATABASE_DEFAULT

DATABASE_DEFAULT

SQL_Latin1_General_CP1_CI_AS

SQL_Latin1_General_CP1_CI_AS

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
User
Application
ManagedIdentity
Key

CreateMode

Gibt den Modus der Datenbankerstellung an.

Standard: regelmäßige Datenbankerstellung.

Kopie: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden.

Sekundär: Erstellt eine Datenbank als sekundäres Replikat einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden.

PointInTimeRestore: Erstellt eine Datenbank durch Wiederherstellen einer Zeitsicherung einer vorhandenen Datenbank. "sourceDatabaseId" muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden, und "restorePointInTime" muss angegeben werden.

Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen.

Wiederherstellen: Erstellt eine Datenbank durch Wiederherstellen einer Sicherung einer gelöschten Datenbank. sourceDatabaseId muss angegeben werden. Wenn "sourceDatabaseId" die ursprüngliche Ressourcen-ID der Datenbank ist, muss "sourceDatabaseDeletionDate" angegeben werden. Andernfalls muss "sourceDatabaseId" die wiederherstellbare verworfene Datenbankressourcen-ID sein, und "sourceDatabaseDeletionDate" wird ignoriert. restorePointInTime kann auch angegeben werden, um sie von einem früheren Zeitpunkt wiederherzustellen.

RestoreLongTermRetentionBackup: Erstellt eine Datenbank, indem sie aus einem langfristigen Aufbewahrungstresor wiederhergestellt wird. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, Secondary und RestoreLongTermRetentionBackup werden für DataWarehouse Edition nicht unterstützt.

Wert Beschreibung
Default

Vorgabe

Copy

Copy

Secondary

Secondary

PointInTimeRestore

PointInTimeRestore

Restore

Wiederherstellen

Recovery

Wiederherstellung

RestoreExternalBackup

RestoreExternalBackup

RestoreExternalBackupSecondary

RestoreExternalBackupSecondary

RestoreLongTermRetentionBackup

RestoreLongTermRetentionBackup

OnlineSecondary

OnlineSekundarstufe

Database

Eine Datenbankressource.

Name Typ Beschreibung
id

string (arm-id)

Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

DatabaseIdentity

Die Azure Active Directory-Identität der Datenbank.

kind

string

Art der Datenbank. Dies sind Metadaten, die für das Azure-Portal-Erlebnis verwendet werden.

location

string

Der geografische Standort, an dem sich die Ressource befindet

managedBy

string

Ressource, die die Datenbank verwaltet.

name

string

Der Name der Ressource

properties.autoPauseDelay

integer (int32)

Die Zeit in Minuten, nach der die Datenbank automatisch angehalten wird. Ein Wert von -1 bedeutet, dass die automatische Pause deaktiviert ist.

properties.availabilityZone

AvailabilityZoneType

Gibt die Verfügbarkeitszone an, an die die Datenbank angeheftet ist.

properties.catalogCollation

CatalogCollationType

Sortierung des Metadatenkatalogs.

properties.collation

string

Die Sortierung der Datenbank.

properties.createMode

CreateMode

Gibt den Modus der Datenbankerstellung an.

Standard: regelmäßige Datenbankerstellung.

Kopie: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden.

Sekundär: Erstellt eine Datenbank als sekundäres Replikat einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden.

PointInTimeRestore: Erstellt eine Datenbank durch Wiederherstellen einer Zeitsicherung einer vorhandenen Datenbank. "sourceDatabaseId" muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden, und "restorePointInTime" muss angegeben werden.

Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen.

Wiederherstellen: Erstellt eine Datenbank durch Wiederherstellen einer Sicherung einer gelöschten Datenbank. sourceDatabaseId muss angegeben werden. Wenn "sourceDatabaseId" die ursprüngliche Ressourcen-ID der Datenbank ist, muss "sourceDatabaseDeletionDate" angegeben werden. Andernfalls muss "sourceDatabaseId" die wiederherstellbare verworfene Datenbankressourcen-ID sein, und "sourceDatabaseDeletionDate" wird ignoriert. restorePointInTime kann auch angegeben werden, um sie von einem früheren Zeitpunkt wiederherzustellen.

RestoreLongTermRetentionBackup: Erstellt eine Datenbank, indem sie aus einem langfristigen Aufbewahrungstresor wiederhergestellt wird. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, Secondary und RestoreLongTermRetentionBackup werden für DataWarehouse Edition nicht unterstützt.

properties.creationDate

string (date-time)

Das Erstellungsdatum der Datenbank (ISO8601 Format).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird.

properties.currentServiceObjectiveName

string

Der aktuelle Zielname der Dienstebene der Datenbank.

properties.currentSku

Sku

Der Name und die Ebene der SKU.

properties.databaseId

string (uuid)

Die ID der Datenbank.

properties.defaultSecondaryLocation

string

Der sekundäre Standardbereich für diese Datenbank.

properties.earliestRestoreDate

string (date-time)

Dadurch wird das früheste Startdatum und die früheste Wiederherstellungszeit für diese Datenbank (ISO8601 Format) aufgezeichnet.

properties.elasticPoolId

string (arm-id)

Der Ressourcenbezeichner des elastischen Pools, der diese Datenbank enthält.

properties.encryptionProtector

string

Der Azure Key Vault-URI der Datenbank, wenn er mit den vom Kunden verwalteten Datenbankschlüsseln konfiguriert ist.

properties.encryptionProtectorAutoRotation

boolean

Das Kennzeichen zum Aktivieren oder Deaktivieren der automatischen Drehung des AKV-Schlüssels der Datenbankverschlüsselungskomponente.

properties.failoverGroupId

string

Failovergruppenressourcenbezeichner, zu dem diese Datenbank gehört.

properties.federatedClientId

string (uuid)

Client-ID, die für mandantenübergreifendes CMK-Szenario verwendet wird

properties.freeLimitExhaustionBehavior

FreeLimitExhaustionBehavior

Gibt das Verhalten an, wenn monatliche kostenlose Grenzwerte für die kostenlose Datenbank erschöpft sind.

AutoPause: Die Datenbank wird automatisch angehalten, wenn die freien Grenzwerte für den Rest des Monats erschöpft sind.

BillForUsage: Die Datenbank wird weiterhin online sein, wenn die freien Grenzwerte erschöpft sind, und jegliche Überlastung wird in Rechnung gestellt.

properties.highAvailabilityReplicaCount

integer (int32)

Die Anzahl der sekundären Replikate, die der Business Critical-, Premium- oder Hyperscale-Edition-Datenbank zugeordnet sind, die verwendet werden, um hohe Verfügbarkeit bereitzustellen. Gilt nicht für eine Hyperscale-Datenbank innerhalb eines elastischen Pools.

properties.isInfraEncryptionEnabled

boolean

Die Infrastrukturverschlüsselung ist für diese Datenbank aktiviert.

properties.isLedgerOn

boolean

Ob es sich bei dieser Datenbank um eine Ledgerdatenbank handelt, was bedeutet, dass alle Tabellen in der Datenbank Sachtabellen sind. Hinweis: Der Wert dieser Eigenschaft kann nicht geändert werden, nachdem die Datenbank erstellt wurde.

properties.keys

<string,  DatabaseKey>

Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen

properties.licenseType

DatabaseLicenseType

Der lizenztyp, der für diese Datenbank gilt. LicenseIncluded, wenn du eine Lizenz brauchst, oder BasePrice, wenn du eine Lizenz hast und für die Azure-Hybridvorteil berechtigt bist.

properties.longTermRetentionBackupResourceId

string (arm-id)

Der Ressourcenbezeichner der langfristigen Aufbewahrungssicherung, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.maintenanceConfigurationId

string

Der Datenbank zugewiesene Wartungskonfigurations-ID. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates auftreten.

properties.manualCutover

boolean

Unabhängig davon, ob die vom Kunden kontrollierte manuelle Übernahme während des Aktualisierungsdatenbankvorgangs auf die Hyperscale-Ebene erfolgen muss.

Diese Eigenschaft gilt nur beim Skalieren der Datenbank von Business Critical/General Purpose/Premium/Standard tier to Hyperscale tier.

Wenn "manualCutover" angegeben ist, wartet der Skalierungsvorgang auf die Benutzereingabe, um den Übernahmevorgang in die Hyperscale-Datenbank auszulösen.

Um den Übernahmevorgang auszulösen, geben Sie bitte den Parameter "performCutover" an, wenn der Skalierungsvorgang im Wartezustand liegt.

properties.maxLogSizeBytes

integer (int64)

Die maximale Protokollgröße für diese Datenbank.

properties.maxSizeBytes

integer (int64)

Die maximale Größe der Datenbank, die in Byte ausgedrückt wird.

properties.minCapacity

number (double)

Minimale Kapazität, die die Datenbank immer zugewiesen hat, wenn sie nicht angehalten wird

properties.pausedDate

string (date-time)

Das Datum, an dem die Datenbank durch die Benutzerkonfiguration oder -aktion (ISO8601 Format) angehalten wurde. Null, wenn die Datenbank bereit ist.

properties.performCutover

boolean

Um den vom Kunden gesteuerten manuellen Übernahmevorgang während des Wartezustands auszulösen, während der Skalierungsvorgang ausgeführt wird.

Dieser Eigenschaftsparameter gilt nur für Skalierungsvorgänge, die zusammen mit dem Parameter "manualCutover" initiiert werden.

Diese Eigenschaft gilt nur, wenn die Skalierungsdatenbank von Business Critical/General Purpose/Premium/Standard-Stufe auf Hyperscale-Ebene bereits ausgeführt wird.

Wenn "performCutover" angegeben ist, löst der Skalierungsvorgang den Übernahmevorgang aus und führt eine Rollenänderung in der Hyperscale-Datenbank aus.

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

Typ der in der Datenbank angeforderten Enklave, d. h. Standard- oder VBS-Enklaven.

properties.readScale

DatabaseReadScale

Der Status des schreibgeschützten Routings. Wenn aktiviert, können Verbindungen, bei denen die Anwendungsabsicht in ihrer Verbindungszeichenfolge auf Readonly gesetzt ist, an ein readonly-sekundäres Replikat im selben Bereich weitergeleitet werden. Gilt nicht für eine Hyperscale-Datenbank innerhalb eines elastischen Pools.

properties.recoverableDatabaseId

string (arm-id)

Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.recoveryServicesRecoveryPointId

string (arm-id)

Der Ressourcenbezeichner des Wiederherstellungspunkts, der dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet werden soll.

properties.requestedServiceObjectiveName

string

Der angeforderte Zielname der Dienstebene der Datenbank.

properties.restorableDroppedDatabaseId

string (arm-id)

Der Ressourcenbezeichner der wiederherstellbaren verworfenen Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.restorePointInTime

string (date-time)

Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.

properties.resumedDate

string (date-time)

Das Datum, an dem die Datenbank durch Benutzeraktion oder Datenbankanmeldung (ISO8601 Format) fortgesetzt wurde. Null, wenn die Datenbank angehalten wird.

properties.sampleName

SampleName

Der Name des Beispielschemas, das beim Erstellen dieser Datenbank angewendet werden soll.

properties.secondaryType

SecondaryType

Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datenbank handelt. Gültige Werte sind Geo, Named and Standby.

properties.sourceDatabaseDeletionDate

string (date-time)

Gibt die Uhrzeit an, zu der die Datenbank gelöscht wurde.

properties.sourceDatabaseId

string (arm-id)

Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.sourceResourceId

string (arm-id)

Der Ressourcenbezeichner der Quelle, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

Diese Eigenschaft wird nur für DataWarehouse Edition unterstützt und ermöglicht die Wiederherstellung über Abonnements hinweg.

Wenn "sourceResourceId" angegeben ist, darf "sourceDatabaseId", "recoverableDatabaseId", "restoreableDroppedDatabaseId" und "sourceDatabaseDeletionDate" nicht angegeben werden, und "CreateMode" muss "PointInTimeRestore", "Restore" oder "Recover" sein.

Wenn createMode PointInTimeRestore ist, muss sourceResourceId die Ressourcen-ID der vorhandenen Datenbank oder des vorhandenen SQL-Pools sein, und restorePointInTime muss angegeben werden.

Wenn createMode wiederhergestellt wird, muss sourceResourceId die Ressourcen-ID der wiederherstellbaren gelöschten Datenbank oder des wiederherstellbaren gelöschten SQL-Pools sein.

Wenn createMode wiederhergestellt wird, muss sourceResourceId die Ressourcen-ID der wiederherstellbaren Datenbank oder des wiederherstellbaren SQL-Pools sein.

Wenn das Quellabonnement zu einem anderen Mandanten als dem Zielabonnement gehört, muss der Header "x-ms-authorization-auxiliary" Authentifizierungstoken für den Quellmandanten enthalten. Weitere Informationen zum Header "x-ms-authorization-auxiliary" finden Sie unter https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

DatabaseStatus

Der Status der Datenbank.

properties.useFreeLimit

boolean

Gibt an, ob die Datenbank kostenlose monatliche Grenzwerte verwendet. In einer Datenbank in einem Abonnement zulässig.

properties.zoneRedundant

boolean

Gibt an, ob diese Datenbank zonenredundant ist, was bedeutet, dass die Replikate dieser Datenbank über mehrere Verfügbarkeitszonen verteilt werden.

sku

Sku

Die Datenbank-SKU.

Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu bestimmen, die Ihrem Abonnement in einer Azure Region zur Verfügung stehen, verwenden Sie die Capabilities_ListByLocation REST API oder einen der folgenden Befehle:

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

systemData

Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten"

DatabaseIdentity

Azure Active Directory Identitätskonfiguration für eine Ressource.

Name Typ Beschreibung
tenantId

string (uuid)

Das Azure Active Directory tenant id.

type

DatabaseIdentityType

Der Identitätstyp

userAssignedIdentities

<string,  DatabaseUserIdentity>

Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen

DatabaseIdentityType

Der Identitätstyp

Wert Beschreibung
None

Nichts

UserAssigned

UserAssigned

DatabaseKey

Schlüssel auf Datenbankebene, der für die Verschlüsselung ruhender Daten verwendet wird.

Name Typ Beschreibung
creationDate

string (date-time)

Das Erstellungsdatum des Datenbankschlüssels.

keyVersion

string

Die Version des Datenbankschlüssels.

subregion

string

Unterregion des Serverschlüssels.

thumbprint

string

Fingerabdruck des Datenbankschlüssels.

type

DatabaseKeyType

Der Datenbankschlüsseltyp. Nur unterstützter Wert ist "AzureKeyVault".

DatabaseKeyType

Der Datenbankschlüsseltyp. Nur unterstützter Wert ist "AzureKeyVault".

Wert Beschreibung
AzureKeyVault

AzureKeyVault

DatabaseLicenseType

Der lizenztyp, der für diese Datenbank gilt. LicenseIncluded, wenn du eine Lizenz brauchst, oder BasePrice, wenn du eine Lizenz hast und für die Azure-Hybridvorteil berechtigt bist.

Wert Beschreibung
LicenseIncluded

LizenzEnthaltene Lizenz

BasePrice

BasePrice

DatabaseListResult

Die Antwort eines Datenbanklistenvorgangs.

Name Typ Beschreibung
nextLink

string (uri)

Der Link zur nächsten Seite der Elemente

value

Database[]

Die Datenbankelemente auf dieser Seite

DatabaseReadScale

Der Status des schreibgeschützten Routings. Wenn aktiviert, können Verbindungen, bei denen die Anwendungsabsicht in ihrer Verbindungszeichenfolge auf Readonly gesetzt ist, an ein readonly-sekundäres Replikat im selben Bereich weitergeleitet werden. Gilt nicht für eine Hyperscale-Datenbank innerhalb eines elastischen Pools.

Wert Beschreibung
Enabled

Aktiviert

Disabled

Deaktiviert

DatabaseStatus

Der Status der Datenbank.

Wert Beschreibung
Online

Online

Restoring

Wiederherstellen

RecoveryPending

WiederherstellungAusstehend

Recovering

Wiederherstellen

Suspect

Verdächtigter

Offline

Offline

Standby

Reserve

Shutdown

Herunterfahren

EmergencyMode

Notfallmodus

AutoClosed

AutoClosed

Copying

Kopieren

Creating

Erstellen

Inaccessible

Unzugänglich

OfflineSecondary

OfflineSekundär

Pausing

Anhalten

Paused

Angehalten

Resuming

Wird fortgesetzt

Scaling

Scaling

OfflineChangingDwPerformanceTiers

OfflineChangingDwPerformanceTiers

OnlineChangingDwPerformanceTiers

OnlineChangingDwPerformanceTiers

Disabled

Deaktiviert

Stopping

Anhalten

Stopped

Angehalten

Starting

Wird gestartet

DatabaseUserIdentity

Azure Active Directory Identitätskonfiguration für eine Ressource.

Name Typ Beschreibung
clientId

string (uuid)

Die Client-ID von Azure Active Directory.

principalId

string (uuid)

Die Azure Active Directory principal id.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

FreeLimitExhaustionBehavior

Gibt das Verhalten an, wenn monatliche kostenlose Grenzwerte für die kostenlose Datenbank erschöpft sind.

AutoPause: Die Datenbank wird automatisch angehalten, wenn die freien Grenzwerte für den Rest des Monats erschöpft sind.

BillForUsage: Die Datenbank wird weiterhin online sein, wenn die freien Grenzwerte erschöpft sind, und jegliche Überlastung wird in Rechnung gestellt.

Wert Beschreibung
AutoPause

AutoPause

BillOverUsage

BillOverUsage

SampleName

Der Name des Beispielschemas, das beim Erstellen dieser Datenbank angewendet werden soll.

Wert Beschreibung
AdventureWorksLT

AdventureWorksLT

WideWorldImportersStd

WideWorldImportersStd

WideWorldImportersFull

WideWorldImportersFull

SecondaryType

Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datenbank handelt. Gültige Werte sind Geo, Named and Standby.

Wert Beschreibung
Geo

Geo

Named

Benannt

Standby

Reserve

Sku

Eine ARM-Ressourcen-SKU.

Name Typ Beschreibung
capacity

integer (int32)

Kapazität der jeweiligen SKU.

family

string

Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden.

name

string

Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3.

size

string

Größe der jeweiligen SKU

tier

string

Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.