Managed Databases - Get

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Ruft eine verwaltete Datenbank ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	ManagedDatabase	Die angegebene verwaltete Datenbank 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. 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

Name

Typ

Beschreibung

200 OK

ManagedDatabase

Die angegebene verwaltete Datenbank 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.
404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

Beispiele

Gets a managed database

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


/**
 * Samples for ManagedDatabases Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseGet.json
     */
    /**
     * Sample code: Gets a managed database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getsAManagedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().getWithResponse("Test1", "managedInstance",
            "managedDatabase", 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

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

Definitionen

Name	Beschreibung
CatalogCollationType	Sortierung des Metadatenkatalogs.
ManagedDatabase	Eine verwaltete Datenbankressource.
ManagedDatabaseCreateMode	Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich).
ManagedDatabaseStatus	Status der Datenbank.

CatalogCollationType

Enumeration

Sortierung des Metadatenkatalogs.

Wert	Beschreibung
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ManagedDatabase

Objekt

Eine verwaltete Datenbankressource.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
location	string	Ressourcenspeicherort.
name	string	Ressourcenname.
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	Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich).
properties.creationDate	string (date-time)	Erstellungsdatum der Datenbank.
properties.defaultSecondaryLocation	string	Geo-gekoppelte Region.
properties.earliestRestorePoint	string (date-time)	Frühester Wiederherstellungspunkt für punkt in der Zeitwiederherstellung.
properties.failoverGroupId	string	Ressourcenbezeichner der Instanzfailovergruppe, zu der diese verwaltete Datenbank gehört.
properties.lastBackupName	string	Letzter Sicherungsdateiname für die Wiederherstellung dieser verwalteten Datenbank.
properties.longTermRetentionBackupResourceId	string (arm-id)	Der Name der Langfristigen Aufbewahrungssicherung, die für die Wiederherstellung dieser verwalteten Datenbank verwendet werden soll.
properties.recoverableDatabaseId	string (arm-id)	Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.
properties.restorableDroppedDatabaseId	string (arm-id)	Die wiederherstellbare verworfene Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll.
properties.restorePointInTime	string (date-time)	Konditional. Wenn createMode PointInTimeRestore ist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.
properties.sourceDatabaseId	string (arm-id)	Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.
properties.status	ManagedDatabaseStatus	Status der Datenbank.
properties.storageContainerSasToken	string	Konditional. Wenn createMode "RestoreExternalBackup" ist, ist dieser Wert erforderlich. Gibt das Sas-Token des Speichercontainers an.
properties.storageContainerUri	string	Konditional. Wenn createMode "RestoreExternalBackup" 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	Ressourcentyp.

ManagedDatabaseCreateMode

Enumeration

Verwalteter Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. SourceDatabaseName, SourceManagedInstanceName und PointInTime müssen angegeben werden. RestoreExternalBackup: Erstellen Sie eine Datenbank, indem Sie aus externen Sicherungsdateien wiederherstellen. Sortierung, StorageContainerUri und StorageContainerSasToken müssen angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. RecoverableDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. RestoreLongTermRetentionBackup: Erstellen Einer Datenbank durch Wiederherstellen einer langfristigen Aufbewahrungssicherung (longTermRetentionBackupResourceId erforderlich).

Wert	Beschreibung
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Enumeration

Status der Datenbank.

Wert	Beschreibung
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating

Freigeben über

Managed Databases - Get

URI-Parameter

Antworten

Beispiele

Gets a managed database

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus

Zusätzliche Ressourcen