Managed Databases - Get

Referência

Serviço:: SQL Database

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

Obtém um banco de dados gerenciado.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
databaseName	path	True	string	O nome do banco de dados.
managedInstanceName	path	True	string	O nome da instância gerenciada.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Respostas

Nome	Tipo	Description
200 OK	ManagedDatabase	Recuperou com êxito o banco de dados gerenciado especificado.
Other Status Codes		Respostas de erro: *** 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 ResourceNotFound – O recurso solicitado não foi encontrado.

Nome

Tipo

Description

200 OK

ManagedDatabase

Recuperou com êxito o banco de dados gerenciado especificado.

Other Status Codes

Respostas de erro: ***

404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado
404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.
404 ResourceNotFound – O recurso solicitado não foi encontrado.

Exemplos

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


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

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

Definições

Nome	Description
CatalogCollationType	Ordenação do catálogo de metadados.
ManagedDatabase	Um recurso de banco de dados gerenciado.
ManagedDatabaseCreateMode	Modo de criação de banco de dados gerenciado. PointInTimeRestore: crie um banco de dados restaurando um backup pontual de um banco de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime devem ser especificados. RestoreExternalBackup: crie um banco de dados restaurando de arquivos de backup externos. Collation, StorageContainerUri e StorageContainerSasToken devem ser especificados. Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. RecoverableDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável para restauração. RestoreLongTermRetentionBackup: crie um banco de dados restaurando de um backup de retenção de longo prazo (longTermRetentionBackupResourceId necessário).
ManagedDatabaseStatus	Status do banco de dados.

CatalogCollationType

Ordenação do catálogo de metadados.

Nome	Tipo	Description
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

ManagedDatabase

Um recurso de banco de dados gerenciado.

Nome	Tipo	Description
id	string	ID do recurso.
location	string	Local do recurso.
name	string	Nome do recurso.
properties.autoCompleteRestore	boolean	Se deseja concluir automaticamente a restauração desse banco de dados gerenciado.
properties.catalogCollation	CatalogCollationType	Ordenação do catálogo de metadados.
properties.collation	string	Ordenação do banco de dados gerenciado.
properties.createMode	ManagedDatabaseCreateMode	Modo de criação de banco de dados gerenciado. PointInTimeRestore: crie um banco de dados restaurando um backup pontual de um banco de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime devem ser especificados. RestoreExternalBackup: crie um banco de dados restaurando de arquivos de backup externos. Collation, StorageContainerUri e StorageContainerSasToken devem ser especificados. Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. RecoverableDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável para restauração. RestoreLongTermRetentionBackup: crie um banco de dados restaurando de um backup de retenção de longo prazo (longTermRetentionBackupResourceId necessário).
properties.creationDate	string	Data de criação do banco de dados.
properties.defaultSecondaryLocation	string	Região emparelhada geograficamente.
properties.earliestRestorePoint	string	Ponto de restauração mais antigo no tempo para restauração pontual.
properties.failoverGroupId	string	Identificador de recurso do Grupo de Failover de Instância ao qual esse banco de dados gerenciado pertence.
properties.lastBackupName	string	Sobrenome do arquivo de backup para restauração desse banco de dados gerenciado.
properties.longTermRetentionBackupResourceId	string	O nome do backup de Retenção de Longo Prazo a ser usado para restauração desse banco de dados gerenciado.
properties.recoverableDatabaseId	string	O identificador de recurso do banco de dados recuperável associado à operação de criação desse banco de dados.
properties.restorableDroppedDatabaseId	string	A ID do recurso de banco de dados descartada restaurável a ser restaurada ao criar esse banco de dados.
properties.restorePointInTime	string	Condicional. Se createMode for PointInTimeRestore, esse valor será necessário. Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.
properties.sourceDatabaseId	string	O identificador de recurso do banco de dados de origem associado à operação de criação desse banco de dados.
properties.status	ManagedDatabaseStatus	Status do banco de dados.
properties.storageContainerSasToken	string	Condicional. Se createMode for RestoreExternalBackup, esse valor será necessário. Especifica o token sas do contêiner de armazenamento.
properties.storageContainerUri	string	Condicional. Se createMode for RestoreExternalBackup, esse valor será necessário. Especifica o URI do contêiner de armazenamento em que os backups para essa restauração são armazenados.
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

ManagedDatabaseCreateMode

Modo de criação de banco de dados gerenciado. PointInTimeRestore: crie um banco de dados restaurando um backup pontual de um banco de dados existente. SourceDatabaseName, SourceManagedInstanceName e PointInTime devem ser especificados. RestoreExternalBackup: crie um banco de dados restaurando de arquivos de backup externos. Collation, StorageContainerUri e StorageContainerSasToken devem ser especificados. Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. RecoverableDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável para restauração. RestoreLongTermRetentionBackup: crie um banco de dados restaurando de um backup de retenção de longo prazo (longTermRetentionBackupResourceId necessário).

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

ManagedDatabaseStatus

Status do banco de dados.

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

Compartilhar via

Managed Databases - Get

Parâmetros de URI

Respostas

Exemplos

Gets a managed database

Solicitação de exemplo

Resposta de exemplo

Definições

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus

Recursos adicionais