Managed Databases - List By Instance

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Obtém uma lista de bases de dados geridas.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
managedInstanceName	path	True	string	O nome da instância gerida.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	ManagedDatabaseListResult	Foi obtida com êxito a lista de bases de dados.
Other Status Codes		Respostas de Erro: *** 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.

Name

Tipo

Description

200 OK

ManagedDatabaseListResult

Foi obtida com êxito a lista de bases de dados.

Other Status Codes

Respostas de Erro: ***

404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.

Exemplos

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

Resposta da amostra

Código de estado:: 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"
    }
  ]
}

Definições

Name	Description
CatalogCollationType	Agrupamento do catálogo de metadados.
ManagedDatabase	Um recurso de base de dados gerida.
ManagedDatabaseCreateMode	Modo de criação de base de dados gerida. PointInTimeRestore: crie uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime têm de ser especificados. RestoreExternalBackup: crie uma base de dados ao restaurar a partir de ficheiros de cópia de segurança externos. O agrupamento, StorageContainerUri e StorageContainerSasToken têm de ser especificados. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. RecoverableDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. RestoreLongTermRetentionBackup: crie uma base de dados ao restaurar a partir de uma cópia de segurança de retenção de longo prazo (longTermRetentionBackupResourceId necessário).
ManagedDatabaseListResult	Uma lista de bases de dados geridas.
ManagedDatabaseStatus	Estado da base de dados.

CatalogCollationType

Enumeration

Agrupamento do catálogo de metadados.

Valor	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ManagedDatabase

Object

Um recurso de base de dados gerida.

Name	Tipo	Description
id	string	ID do Recurso.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.autoCompleteRestore	boolean	Se pretende concluir automaticamente o restauro desta base de dados gerida.
properties.catalogCollation	CatalogCollationType	Agrupamento do catálogo de metadados.
properties.collation	string	Agrupamento da base de dados gerida.
properties.createMode	ManagedDatabaseCreateMode	Modo de criação de base de dados gerida. PointInTimeRestore: crie uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime têm de ser especificados. RestoreExternalBackup: crie uma base de dados ao restaurar a partir de ficheiros de cópia de segurança externos. O agrupamento, StorageContainerUri e StorageContainerSasToken têm de ser especificados. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. RecoverableDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. RestoreLongTermRetentionBackup: crie uma base de dados ao restaurar a partir de uma cópia de segurança de retenção de longo prazo (longTermRetentionBackupResourceId necessário).
properties.creationDate	string	Data de criação da base de dados.
properties.defaultSecondaryLocation	string	Região emparelhada geográfica.
properties.earliestRestorePoint	string	Ponto anterior no tempo de restauro para restauro para um ponto anterior no tempo.
properties.failoverGroupId	string	Identificador de recurso do Grupo de Ativação Pós-falha de Instância a que esta base de dados gerida pertence.
properties.lastBackupName	string	Último nome de ficheiro de cópia de segurança para restaurar esta base de dados gerida.
properties.longTermRetentionBackupResourceId	string	O nome da cópia de segurança de Retenção de Longo Prazo a utilizar para restaurar esta base de dados gerida.
properties.recoverableDatabaseId	string	O identificador de recursos da base de dados recuperável associada à operação de criação desta base de dados.
properties.restorableDroppedDatabaseId	string	O ID de recurso de base de dados removido restauráveis para restaurar ao criar esta base de dados.
properties.restorePointInTime	string	Condicional. Se createMode for PointInTimeRestore, este valor é necessário. Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados.
properties.sourceDatabaseId	string	O identificador de recursos da base de dados de origem associada à operação de criação desta base de dados.
properties.status	ManagedDatabaseStatus	Estado da base de dados.
properties.storageContainerSasToken	string	Condicional. Se createMode for RestoreExternalBackup, este valor é necessário. Especifica o token sas do contentor de armazenamento.
properties.storageContainerUri	string	Condicional. Se createMode for RestoreExternalBackup, este valor é necessário. Especifica o URI do contentor de armazenamento onde as cópias de segurança para este restauro são armazenadas.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

ManagedDatabaseCreateMode

Enumeration

Modo de criação de base de dados gerida. PointInTimeRestore: crie uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime têm de ser especificados. RestoreExternalBackup: crie uma base de dados ao restaurar a partir de ficheiros de cópia de segurança externos. O agrupamento, StorageContainerUri e StorageContainerSasToken têm de ser especificados. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. RecoverableDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. RestoreLongTermRetentionBackup: crie uma base de dados ao restaurar a partir de uma cópia de segurança de retenção de longo prazo (longTermRetentionBackupResourceId necessário).

Valor	Description
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseListResult

Object

Uma lista de bases de dados geridas.

Name	Tipo	Description
nextLink	string	Ligação para obter a página seguinte dos resultados.
value	ManagedDatabase[]	Matriz de resultados.

ManagedDatabaseStatus

Enumeration

Estado da base de dados.

Valor	Description
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating

Partilhar via

Managed Databases - List By Instance

Parâmetros do URI

Respostas

Exemplos

List databases by managed instances

Pedido de amostra

Resposta da amostra

Definições

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseListResult

ManagedDatabaseStatus

Recursos adicionais