Managed Databases - Get

Servizio:: SQL Database

Versione API:: 2023-08-01

Ottiene un database gestito.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
managedInstanceName	path	True	string	Nome dell'istanza gestita.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedDatabase	È stato recuperato correttamente il database gestito specificato.
Other Status Codes	ErrorResponse	Risposte di errore: 400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto 400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

Nome

Tipo

Descrizione

200 OK

ManagedDatabase

È stato recuperato correttamente il database gestito specificato.

Other Status Codes

ErrorResponse

Risposte di errore:

400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto
400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato
404 ResourceNotFound: la risorsa richiesta non è stata trovata.

Esempio

Gets a managed database

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
CatalogCollationType	Regole di confronto del catalogo di metadati.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ManagedDatabase	Una risorsa di database gestita.
ManagedDatabaseCreateMode	Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).
ManagedDatabaseStatus	Stato del database.

CatalogCollationType

Enumerazione

Regole di confronto del catalogo di metadati.

Valore	Descrizione
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ManagedDatabase

Oggetto

Una risorsa di database gestita.

Nome	Tipo	Descrizione
id	string	ID risorsa.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.autoCompleteRestore	boolean	Indica se completare automaticamente il ripristino di questo database gestito.
properties.catalogCollation	CatalogCollationType	Regole di confronto del catalogo di metadati.
properties.collation	string	Regole di confronto del database gestito.
properties.createMode	ManagedDatabaseCreateMode	Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).
properties.creationDate	string (date-time)	Data di creazione del database.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	L'ID risorsa del database rimosso tra sottoscrizioni ripristinabili per il ripristino durante la creazione di questo database.
properties.crossSubscriptionSourceDatabaseId	string	Identificatore della risorsa del database di origine tra sottoscrizioni associato all'operazione di creazione del database.
properties.crossSubscriptionTargetManagedInstanceId	string	ID istanza gestita di destinazione usato nel ripristino tra sottoscrizioni.
properties.defaultSecondaryLocation	string	Area geografica associata.
properties.earliestRestorePoint	string (date-time)	Punto di ripristino meno recente nel tempo per il ripristino temporizzato.
properties.failoverGroupId	string	Identificatore di risorsa gruppo di failover dell'istanza a cui appartiene il database gestito.
properties.isLedgerOn	boolean	Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.
properties.lastBackupName	string	Cognome del file di backup per il ripristino di questo database gestito.
properties.longTermRetentionBackupResourceId	string	Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito.
properties.recoverableDatabaseId	string	Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.
properties.restorableDroppedDatabaseId	string	ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database.
properties.restorePointInTime	string (date-time)	Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.
properties.sourceDatabaseId	string	Identificatore della risorsa del database di origine associato all'operazione di creazione del database.
properties.status	ManagedDatabaseStatus	Stato del database.
properties.storageContainerIdentity	string	Condizionale. Se createMode è RestoreExternalBackup, questo valore viene usato. Specifica l'identità usata per l'autenticazione del contenitore di archiviazione. Può essere 'SharedAccessSignature' o 'ManagedIdentity'; se non è specificato 'SharedAccessSignature' viene utilizzato.
properties.storageContainerSasToken	string	Condizionale. Se createMode è RestoreExternalBackup e storageContainerIdentity non è ManagedIdentity, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione.
properties.storageContainerUri	string	Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica l'URI del contenitore di archiviazione in cui vengono archiviati i backup per questo ripristino.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa.

ManagedDatabaseCreateMode

Enumerazione

Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).

Valore	Descrizione
Default
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Enumerazione

Stato del database.

Valore	Descrizione
Online
Offline
Shutdown
Creating
Inaccessible
Restoring
Updating
Stopping
Stopped
Starting
DbMoving
DbCopying

Condividi tramite

Managed Databases - Get

Parametri dell'URI

Risposte

Esempio

Gets a managed database

Esempio di richiesta

Risposta di esempio

Definizioni

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus