Managed Databases - Get

Dienst:: SQL Database

API-Version:: 2023-08-01

Ruft eine verwaltete Datenbank ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2023-08-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	ErrorResponse	Fehlerantworten: *** 400 ManagedInstanceStoppingOrStopped – Konfliktierender Vorgang, der während der Instanz beendet/beendet wird 400 ManagedInstanceStarting – Konfliktierender Vorgang, der während der Instanz im Startzustand liegt 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

Name

Typ

Beschreibung

200 OK

ManagedDatabase

Die angegebene verwaltete Datenbank wurde erfolgreich abgerufen.

Other Status Codes

ErrorResponse

Fehlerantworten: ***

400 ManagedInstanceStoppingOrStopped – Konfliktierender Vorgang, der während der Instanz beendet/beendet wird
400 ManagedInstanceStarting – Konfliktierender Vorgang, der während der Instanz im Startzustand liegt
404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.
404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.
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=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ManagedDatabaseGet.json
// this example is just showing the usage of "ManagedDatabases_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedDatabaseResource created on azure
// for more information of creating ManagedDatabaseResource, please refer to the document of ManagedDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Test1";
string managedInstanceName = "managedInstance";
string databaseName = "managedDatabase";
ResourceIdentifier managedDatabaseResourceId = ManagedDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName, databaseName);
ManagedDatabaseResource managedDatabase = client.GetManagedDatabaseResource(managedDatabaseResourceId);

// invoke the operation
ManagedDatabaseResource result = await managedDatabase.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedDatabaseData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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",
    "isLedgerOn": false
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Definitionen

Name	Beschreibung
CatalogCollationType	Sortierung des Metadatenkatalogs.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
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

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

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

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

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.crossSubscriptionRestorableDroppedDatabaseId	string	Die wiederherstellbare, abonnementübergreifende Datenbankressourcen-ID, die beim Erstellen dieser Datenbank wiederhergestellt werden soll.
properties.crossSubscriptionSourceDatabaseId	string	Der Ressourcenbezeichner der abonnementübergreifenden Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.
properties.crossSubscriptionTargetManagedInstanceId	string	Ziel-ID für verwaltete Instanzen, die bei der Wiederherstellung des Abonnements verwendet werden.
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.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.lastBackupName	string	Letzter Sicherungsdateiname für die Wiederherstellung dieser verwalteten Datenbank.
properties.longTermRetentionBackupResourceId	string	Der Name der Langfristigen Aufbewahrungssicherung, 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 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	Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.
properties.status	ManagedDatabaseStatus	Status der Datenbank.
properties.storageContainerIdentity	string	Konditional. Wenn createMode "RestoreExternalBackup" ist, wird dieser Wert verwendet. Gibt die Identität an, die für die Speichercontainerauthentifizierung verwendet wird. Kann "SharedAccessSignature" oder "ManagedIdentity" sein; wenn "SharedAccessSignature" nicht angegeben wird, wird angenommen.
properties.storageContainerSasToken	string	Konditional. Wenn createMode "RestoreExternalBackup" ist und "storageContainerIdentity" nicht "ManagedIdentity" 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
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Enumeration

Status der Datenbank.

Wert	Beschreibung
Online
Offline
Shutdown
Creating
Inaccessible
Restoring
Updating
Stopping
Stopped
Starting
DbMoving
DbCopying

Freigeben über

Managed Databases - Get

URI-Parameter

Antworten

Beispiele

Gets a managed database

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus