Managed Databases - Get

Referencia

Service:: SQL Database

API Version:: 2021-11-01

Obtiene una base de datos administrada.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
databaseName	path	True	string	El nombre de la base de datos.
managedInstanceName	path	True	string	El nombre de la instancia administrada.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	ManagedDatabase	Recuperó correctamente la base de datos administrada especificada.
Other Status Codes		Respuestas de error: *** 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado. 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 ResourceNotFound: no se encontró el recurso solicitado.

Nombre

Tipo

Description

200 OK

ManagedDatabase

Recuperó correctamente la base de datos administrada especificada.

Other Status Codes

Respuestas de error: ***

404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado.
404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.
404 ResourceNotFound: no se encontró el recurso solicitado.

Ejemplos

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

Definiciones

Nombre	Description
CatalogCollationType	Intercalación del catálogo de metadatos.
ManagedDatabase	Un recurso de base de datos administrada.
ManagedDatabaseCreateMode	Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).
ManagedDatabaseStatus	Estado de la base de datos.

CatalogCollationType

Intercalación del catálogo de metadatos.

Nombre	Tipo	Description
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

ManagedDatabase

Un recurso de base de datos administrada.

Nombre	Tipo	Description
id	string	Identificador del recurso.
location	string	Ubicación del recurso
name	string	Nombre del recurso.
properties.autoCompleteRestore	boolean	Si se va a completar automáticamente la restauración de esta base de datos administrada.
properties.catalogCollation	CatalogCollationType	Intercalación del catálogo de metadatos.
properties.collation	string	Intercalación de la base de datos administrada.
properties.createMode	ManagedDatabaseCreateMode	Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).
properties.creationDate	string	Fecha de creación de la base de datos.
properties.defaultSecondaryLocation	string	Región emparejada geográfica.
properties.earliestRestorePoint	string	Un momento dado de restauración más antiguo para la restauración a un momento dado.
properties.failoverGroupId	string	Identificador de recursos del grupo de conmutación por error de instancia al que pertenece esta base de datos administrada.
properties.lastBackupName	string	Último nombre de archivo de copia de seguridad para la restauración de esta base de datos administrada.
properties.longTermRetentionBackupResourceId	string	Nombre de la copia de seguridad de retención a largo plazo que se usará para la restauración de esta base de datos administrada.
properties.recoverableDatabaseId	string	Identificador de recurso de la base de datos recuperable asociada a la operación de creación de esta base de datos.
properties.restorableDroppedDatabaseId	string	Identificador de recurso de base de datos eliminado que se puede restaurar al crear esta base de datos.
properties.restorePointInTime	string	Condicional. Si createMode es PointInTimeRestore, se requiere este valor. Especifica el momento dado (ISO8601 formato) de la base de datos de origen que se restaurará para crear la nueva base de datos.
properties.sourceDatabaseId	string	Identificador de recurso de la base de datos de origen asociada a la operación de creación de esta base de datos.
properties.status	ManagedDatabaseStatus	Estado de la base de datos.
properties.storageContainerSasToken	string	Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el token sas del contenedor de almacenamiento.
properties.storageContainerUri	string	Condicional. Si createMode es RestoreExternalBackup, se requiere este valor. Especifica el URI del contenedor de almacenamiento donde se almacenan las copias de seguridad de esta restauración.
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso.

ManagedDatabaseCreateMode

Modo de creación de base de datos administrada. PointInTimeRestore: cree una base de datos restaurando una copia de seguridad a un momento dado de una base de datos existente. SourceDatabaseName, SourceManagedInstanceName y PointInTime deben especificarse. RestoreExternalBackup: cree una base de datos mediante la restauración a partir de archivos de copia de seguridad externos. Se deben especificar intercalación, StorageContainerUri y StorageContainerSasToken. Recuperación: crea una base de datos restaurando una copia de seguridad con replicación geográfica. RecoverableDatabaseId debe especificarse como identificador de recurso de base de datos recuperable para restaurar. RestoreLongTermRetentionBackup: cree una base de datos mediante la restauración a partir de una copia de seguridad de retención a largo plazo (se requiere longTermRetentionBackupResourceId).

Nombre	Tipo	Description
Default	string
PointInTimeRestore	string
Recovery	string
RestoreExternalBackup	string
RestoreLongTermRetentionBackup	string

ManagedDatabaseStatus

Estado de la base de datos.

Nombre	Tipo	Description
Creating	string
Inaccessible	string
Offline	string
Online	string
Restoring	string
Shutdown	string
Updating	string

Managed Databases - Get

Parámetros de identificador URI

Respuestas

Ejemplos

Gets a managed database

Sample Request

Sample Response

Definiciones

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus

Recursos adicionales