Managed Databases - List By Instance

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Ruft eine Liste der verwalteten Datenbanken ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases?api-version=2021-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	ManagedDatabaseListResult	Die Liste der Datenbanken wurde erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

Name

Typ

Beschreibung

200 OK

ManagedDatabaseListResult

Die Liste der Datenbanken wurde erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden.
404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

Beispiele

List databases by managed instances

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/managedInstance/databases?api-version=2021-11-01


/**
 * Samples for ManagedDatabases ListByInstance.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseListByManagedInstance.
     * json
     */
    /**
     * Sample code: List databases by managed instances.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listDatabasesByManagedInstances(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().listByInstance("Test1", "managedInstance",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb1",
      "location": "southeastasia",
      "name": "testdb1",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "status": "Online"
      },
      "type": "Microsoft.Sql/managedInstances/databases"
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb2",
      "location": "southeastasia",
      "name": "testdb2",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "creationDate": "2017-08-04T15:00:17.73Z",
        "defaultSecondaryLocation": "North Europe",
        "status": "Online"
      },
      "type": "Microsoft.Sql/managedInstances/databases"
    }
  ]
}

Definitionen

Name	Beschreibung
CatalogCollationType	Sortierung des Metadatenkatalogs.
ManagedDatabase	Eine verwaltete Datenbankressource.
ManagedDatabaseCreateMode	Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).
ManagedDatabaseListResult	Eine Liste der verwalteten Datenbanken.
ManagedDatabaseStatus	Der Status der Datenbank.

CatalogCollationType

Sortierung des Metadatenkatalogs.

Name	Typ	Beschreibung
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

ManagedDatabase

Eine verwaltete Datenbankressource.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties.autoCompleteRestore	boolean	Gibt an, ob die Wiederherstellung dieser verwalteten Datenbank automatisch abgeschlossen werden soll.
properties.catalogCollation	CatalogCollationType	Sortierung des Metadatenkatalogs.
properties.collation	string	Sortierung der verwalteten Datenbank.
properties.createMode	ManagedDatabaseCreateMode	Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).
properties.creationDate	string	Erstellungsdatum der Datenbank.
properties.defaultSecondaryLocation	string	Geografische Region.
properties.earliestRestorePoint	string	Frühester Wiederherstellungspunkt für die Zeitpunktwiederherstellung.
properties.failoverGroupId	string	Ressourcenbezeichner der Instanzfailovergruppe, zu der diese verwaltete Datenbank gehört.
properties.lastBackupName	string	Name der letzten Sicherungsdatei für die Wiederherstellung dieser verwalteten Datenbank.
properties.longTermRetentionBackupResourceId	string	Der Name der Sicherung für die langfristige Aufbewahrung, die für die Wiederherstellung dieser verwalteten Datenbank verwendet werden soll.
properties.recoverableDatabaseId	string	Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.
properties.restorableDroppedDatabaseId	string	Die wiederherstellbare gelöschte Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll.
properties.restorePointInTime	string	Bedingte. Wenn createMode den Wert PointInTimeRestore aufweist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird.
properties.sourceDatabaseId	string	Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.
properties.status	ManagedDatabaseStatus	Der Status der Datenbank.
properties.storageContainerSasToken	string	Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt ist, ist dieser Wert erforderlich. Gibt das SAS-Token des Speichercontainers an.
properties.storageContainerUri	string	Bedingte. Wenn createMode auf RestoreExternalBackup festgelegt ist, ist dieser Wert erforderlich. Gibt den URI des Speichercontainers an, in dem Sicherungen für diese Wiederherstellung gespeichert werden.
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

ManagedDatabaseCreateMode

Erstellungsmodus für verwaltete Datenbanken. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitpunktsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie die Wiederherstellung aus externen Sicherungsdateien durchführen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherzustellende Datenbankressourcen-ID angegeben werden. RestoreLongTermRetentionBackup: Erstellen Sie eine Datenbank, indem Sie eine Wiederherstellung aus einer sicherung mit langfristiger Aufbewahrung durchführen (longTermRetentionBackupResourceId erforderlich).

Name	Typ	Beschreibung
Default	string
PointInTimeRestore	string
Recovery	string
RestoreExternalBackup	string
RestoreLongTermRetentionBackup	string

ManagedDatabaseListResult

Eine Liste der verwalteten Datenbanken.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	ManagedDatabase[]	Array von Ergebnissen.

ManagedDatabaseStatus

Der Status der Datenbank.

Name	Typ	Beschreibung
Creating	string
Inaccessible	string
Offline	string
Online	string
Restoring	string
Shutdown	string
Updating	string

Freigeben über

Managed Databases - List By Instance

URI-Parameter

Antworten

Beispiele

List databases by managed instances

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseListResult

ManagedDatabaseStatus

Zusätzliche Ressourcen