Managed Databases - List By Instance

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Obtiene una lista de bases de datos administradas.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
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	ManagedDatabaseListResult	Recuperó correctamente la lista de bases de datos.
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.

Nombre

Tipo

Description

200 OK

ManagedDatabaseListResult

Recuperó correctamente la lista de bases de datos.

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.

Ejemplos

List databases by managed instances

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/managedInstance/databases?api-version=2021-11-01


/**
 * Samples for ManagedDatabases ListByInstance.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseListByManagedInstance.
     * json
     */
    /**
     * Sample code: List databases by managed instances.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listDatabasesByManagedInstances(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().listByInstance("Test1", "managedInstance",
            com.azure.core.util.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

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "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"
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/databases/testdb2",
      "location": "southeastasia",
      "name": "testdb2",
      "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).
ManagedDatabaseListResult	Lista de bases de datos administradas.
ManagedDatabaseStatus	Estado de la base de datos.

CatalogCollationType

Enumeration

Intercalación del catálogo de metadatos.

Valor	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ManagedDatabase

Object

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

Enumeration

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).

Valor	Description
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseListResult

Object

Lista de bases de datos administradas.

Nombre	Tipo	Description
nextLink	string	Vínculo para recuperar la página siguiente de resultados.
value	ManagedDatabase[]	Matriz de resultados.

ManagedDatabaseStatus

Enumeration

Estado de la base de datos.

Valor	Description
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating

Compartir a través de

Managed Databases - List By Instance

Parámetros de identificador URI

Respuestas

Ejemplos

List databases by managed instances

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseListResult

ManagedDatabaseStatus

Recursos adicionales