Managed Databases - Get

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2023-08-01

Pobiera zarządzaną bazę danych.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
managedInstanceName	path	True	string	Nazwa wystąpienia zarządzanego.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ManagedDatabase	Pomyślnie pobrano określoną zarządzaną bazę danych.
Other Status Codes	ErrorResponse	Odpowiedzi na błędy: *** 400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania 400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ResourceNotFound — żądany zasób nie został znaleziony.

Nazwa

Typ

Opis

200 OK

ManagedDatabase

Pomyślnie pobrano określoną zarządzaną bazę danych.

Other Status Codes

ErrorResponse

Odpowiedzi na błędy: ***

400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania
400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym
404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.
404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera
404 ResourceNotFound — żądany zasób nie został znaleziony.

Przykłady

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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
CatalogCollationType	Sortowanie wykazu metadanych.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ManagedDatabase	Zasób zarządzanej bazy danych.
ManagedDatabaseCreateMode	Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych w czasie. Należy określić parametr SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. Do przywrócenia należy określić identyfikator zasobu bazy danych z możliwością odzyskania. RestoreLongTermRetentionBackup: utwórz bazę danych, przywracając z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).
ManagedDatabaseStatus	Stan bazy danych.

CatalogCollationType

Wyliczanie

Sortowanie wykazu metadanych.

Wartość	Opis
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ManagedDatabase

Objekt

Zasób zarządzanej bazy danych.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.autoCompleteRestore	boolean	Czy automatyczne przywracanie tej zarządzanej bazy danych ma być ukończone automatycznie.
properties.catalogCollation	CatalogCollationType	Sortowanie wykazu metadanych.
properties.collation	string	Sortowanie zarządzanej bazy danych.
properties.createMode	ManagedDatabaseCreateMode	Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych w czasie. Należy określić parametr SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. Do przywrócenia należy określić identyfikator zasobu bazy danych z możliwością odzyskania. RestoreLongTermRetentionBackup: utwórz bazę danych, przywracając z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).
properties.creationDate	string (date-time)	Data utworzenia bazy danych.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	Przywracalny identyfikator zasobu bazy danych porzucony między subskrypcjami, który ma być przywracany podczas tworzenia tej bazy danych.
properties.crossSubscriptionSourceDatabaseId	string	Identyfikator zasobu źródłowej bazy danych między subskrypcjami skojarzony z operacją tworzenia tej bazy danych.
properties.crossSubscriptionTargetManagedInstanceId	string	Identyfikator docelowego wystąpienia zarządzanego używany w przywracaniu między subskrypcjami.
properties.defaultSecondaryLocation	string	Region sparowany geograficznie.
properties.earliestRestorePoint	string (date-time)	Najwcześniejszy punkt przywracania w czasie dla przywracania do punktu w czasie.
properties.failoverGroupId	string	Identyfikator zasobu grupy trybu failover wystąpienia, do którego należy ta zarządzana baza danych.
properties.isLedgerOn	boolean	Niezależnie od tego, czy ta baza danych jest bazą danych rejestru, co oznacza, że wszystkie tabele w bazie danych są tabelami rejestru. Uwaga: nie można zmienić wartości tej właściwości po utworzeniu bazy danych.
properties.lastBackupName	string	Ostatnia nazwa pliku kopii zapasowej na potrzeby przywracania tej zarządzanej bazy danych.
properties.longTermRetentionBackupResourceId	string	Nazwa kopii zapasowej długoterminowego przechowywania, która ma być używana do przywracania tej zarządzanej bazy danych.
properties.recoverableDatabaseId	string	Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych.
properties.restorableDroppedDatabaseId	string	Przywracalny identyfikator usuniętego zasobu bazy danych do przywrócenia podczas tworzenia tej bazy danych.
properties.restorePointInTime	string (date-time)	Warunkowy. Jeśli parametr createMode to PointInTimeRestore, ta wartość jest wymagana. Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych.
properties.sourceDatabaseId	string	Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych.
properties.status	ManagedDatabaseStatus	Stan bazy danych.
properties.storageContainerIdentity	string	Warunkowy. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest używana. Określa tożsamość używaną do uwierzytelniania kontenera magazynu. Może to być wartość "SharedAccessSignature" lub "ManagedIdentity"; jeśli nie określono parametru "SharedAccessSignature" przyjmuje się.
properties.storageContainerSasToken	string	Warunkowy. Jeśli parametr createMode to RestoreExternalBackup, a parametr storageContainerIdentity nie jest zarządzany, ta wartość jest wymagana. Określa token sas kontenera magazynu.
properties.storageContainerUri	string	Warunkowy. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa identyfikator URI kontenera magazynu, w którym są przechowywane kopie zapasowe dla tego przywracania.
tags	object	Tagi zasobów.
type	string	Typ zasobu.

ManagedDatabaseCreateMode

Wyliczanie

Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych w czasie. Należy określić parametr SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. Do przywrócenia należy określić identyfikator zasobu bazy danych z możliwością odzyskania. RestoreLongTermRetentionBackup: utwórz bazę danych, przywracając z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).

Wartość	Opis
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Wyliczanie

Stan bazy danych.

Wartość	Opis
Creating
DbCopying
DbMoving
Inaccessible
Offline
Online
Restoring
Shutdown
Starting
Stopped
Stopping
Updating

Udostępnij za pośrednictwem

Managed Databases - Get

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Gets a managed database

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus