Managed Databases - Get

Referência

Serviço:: SQL Database

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

Obtém uma base de dados gerida.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados.
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	ManagedDatabase	Obteve com êxito a base de dados gerida especificada.
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 subscrição especificados. 404 ResourceNotFound – o recurso pedido não foi encontrado.

Name

Tipo

Description

200 OK

ManagedDatabase

Obteve com êxito a base de dados gerida especificada.

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 subscrição especificados.
404 ResourceNotFound – o recurso pedido 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 da amostra

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

Name	Description
CatalogCollationType	Agrupamento do catálogo de metadados.
ManagedDatabase	Um recurso de base de dados gerida.
ManagedDatabaseCreateMode	Modo de criação de bases de dados geridas. 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).
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 bases de dados geridas. 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 de restauro mais antigo no tempo para restauro para um ponto anterior no tempo.
properties.failoverGroupId	string	Identificador de recursos 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 restauro desta 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 da base de dados removido recuperável 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 bases de dados geridas. 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

ManagedDatabaseStatus

Enumeration

Estado da base de dados.

Valor	Description
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating

Partilhar via

Managed Databases - Get

Parâmetros do URI

Respostas

Exemplos

Gets a managed database

Pedido de amostra

Resposta da amostra

Definições

CatalogCollationType

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus

Recursos adicionais