Managed Databases - Get

Riferimento

Service:: SQL Database

API Version:: 2021-11-01

Ottiene un database gestito.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-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 contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure 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		Risposte di errore: 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

Nome

Tipo

Descrizione

200 OK

ManagedDatabase

È stato recuperato correttamente il database gestito specificato.

Other Status Codes

Risposte di errore:

404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 ResourceNotFound: la risorsa richiesta non è stata trovata.

Esempio

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


import com.azure.core.util.Context;

/** 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", 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

Sample Response

Status code:: 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"
}

Definizioni

Nome	Descrizione
CatalogCollationType	Regole di confronto del catalogo dei metadati.
ManagedDatabase	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 le regole di confronto StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa del database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId richiesto).
ManagedDatabaseStatus	Stato del database.

CatalogCollationType

Regole di confronto del catalogo dei metadati.

Nome	Tipo	Descrizione
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

ManagedDatabase

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 dei 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 le regole di confronto StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa del database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId richiesto).
properties.creationDate	string	Data di creazione del database.
properties.defaultSecondaryLocation	string	Area geografica associata.
properties.earliestRestorePoint	string	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.lastBackupName	string	Cognome del file di backup per il ripristino del 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 rimosso ripristinabile da ripristinare durante la creazione del database.
properties.restorePointInTime	string	Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Specifica il punto nel tempo (ISO8601 formato) 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.storageContainerSasToken	string	Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica il token sas 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 delle risorse.
type	string	Tipo di risorsa.

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 le regole di confronto StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa del database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId richiesto).

Nome	Tipo	Descrizione
Default	string
PointInTimeRestore	string
Recovery	string
RestoreExternalBackup	string
RestoreLongTermRetentionBackup	string

ManagedDatabaseStatus

Stato del database.

Nome	Tipo	Descrizione
Creating	string
Inaccessible	string
Offline	string
Online	string
Restoring	string
Shutdown	string
Updating	string

Managed Databases - Get

Parametri dell'URI

Risposte

Esempio

Gets a managed database

Sample Request

Sample Response

Definizioni

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus

Risorse aggiuntive