Managed Databases - Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Atualiza um banco de dados existente.

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

Corpo da solicitação

Nome	Tipo	Description
properties.autoCompleteRestore	boolean	Se a restauração desse banco de dados gerenciado deve ser concluída automaticamente.
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.lastBackupName	string	Nome do último 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.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.

Respostas

Nome	Tipo	Description
200 OK	ManagedDatabase	O banco de dados foi atualizado com êxito.
202 Accepted		A atualização do banco de dados gerenciado está em andamento.
Other Status Codes		Respostas de erro: *** 400 PitrPointInTimeInvalid - O ponto no tempo {0} não é válido. Intervalo de ponto no tempo válido de {1} dias antes de agora e não antes da hora de criação do servidor de origem. 400 CannotUseTrailingWhitespacesInDatabaseName - Falha na validação do nome do banco de dados. 400 StorageAccountFull - Instância Gerenciada atingiu a capacidade total da conta de armazenamento subjacente do Azure. A conta de Armazenamento Premium do Azure é limitada a 35 TB de espaço alocado. 400 AkvHostNotResolvingFromNode - O host AKV '{0}' não é resolvível do SQL, no servidor '{1}'. 400 InvalidBackupRetentionPeriod - Os dias de retenção de {0} não são uma configuração válida. A retenção de backup válida em dias deve estar entre {1} e {2} 400 ManagedDatabaseNameInUse - O banco de dados '{0}' já existe. Escolha um nome de banco de dados diferente. 400 NoMoreSpaceInManagedInstance - A instância gerenciada atingiu seu limite de armazenamento. O uso de armazenamento para a instância gerenciada não pode exceder (%d) MBs. 400 ManagedInstanceUpdateSloInProgress - "A operação não pôde ser concluída porque uma alteração da camada de serviço está em andamento para a instância gerenciada '{0}.' Aguarde a conclusão da operação em andamento e tente novamente." 400 SameKeyMaterialNotFoundOnRemoteServer – O servidor secundário não tem o material de chave do protetor de criptografia do servidor primário. 400 SourceDatabaseNotFound - O banco de dados de origem não existe. 400 RegionDoesNotSupportVersion - Um usuário tentou criar um servidor de uma versão especificada em um local em que não há suporte para essa versão do servidor. 400 PasswordNotComplex - A senha fornecida não é complexa o suficiente. 400 CannotUseReservedDatabaseName - Não é possível usar o nome do banco de dados reservado nesta operação. 400 InvalidServerName - Nome do servidor inválido especificado. 400 SourceServerNotFound - A parte do servidor de uma ID de banco de dados de origem fornecida em uma chamada à API CreateDatabaseAsCopy não é mapeada para um servidor existente. 400 TokenTooLong - O token fornecido é muito longo. 400 CurrentDatabaseSizeExceedsMaxSize - O usuário tentou reduzir o tamanho máximo de um banco de dados para um tamanho menor que o uso atual. 400 InvalidCollation – A ordenação não é reconhecida pelo servidor. 400 AkvEndpointNotReachableFromNode - O ponto de extremidade do AKV '{0}' não está acessível do SQL, no servidor '{1}'. 400 ServerNotFound - O servidor solicitado não foi encontrado. 400 UnsupportedServiceName - O nome especificado é um nome inválido porque contém um ou mais caracteres unicode sem suporte. 400 CurrentDatabaseLogSizeExceedsMaxSize - O usuário tentou alterar o banco de dados para um sku com tamanho máximo de log menor do que o uso atual. 400 DatabaseNumberLimitReached - Número máximo de bancos de dados para Banco de Dados SQL Instância Gerenciada atingidos. 400 InvalidDatabaseCreateOrUpdateRequest – o corpo da solicitação para a operação de criação ou atualização de banco de dados é inválido. 400 InvalidResourceId - Identificador de recurso inválido. 400 InvalidSourceDatabaseId - Identificador de banco de dados de origem inválido. 400 InvalidRestorableDroppedDatabaseId - Identificador de banco de dados descartado restaurável inválido 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondeu ao nome na URL. 400 MismatchingServerNameWithUrl - O nome do servidor fornecido não correspondeu ao nome na URL. 400 MismatchingSubscriptionWithUrl - A assinatura fornecida não correspondeu à assinatura na URL. 400 MissingCollation – Ordenação é necessária. 400 MissingSourceDatabaseId - Identificador de banco de dados de origem ausente. 400 MissingRestorePointInTime - Ponto de restauração ausente no tempo 400 MissingStorageContainerSasToken - Token SAS do contêiner de armazenamento ausente 400 MissingStorageContainerUri – URI do contêiner de armazenamento ausente 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Não é possível especificar restorableDroppedDatabaseId quando sourceDatabaseId já é dado no modo de criação de restauração 400 CannotUseReservedDatabaseName - Não é possível usar o nome do banco de dados reservado nesta operação. 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. 404 CannotFindServerCertificateWithThumbprint - Não é possível localizar o certificado do servidor com a impressão digital '{0}'. Use o cmdlet do PowerShell 'Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate' para criar o certificado. 404 CannotFindObject - Não é possível localizar o objeto porque ele não existe ou você não tem permissões 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada. 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância de servidor. 404 ServerNotInSubscription – O servidor especificado não existe na assinatura especificada. 404 RestoreSourceDatabaseNotFound - Não foi possível localizar o banco de dados '{0}' no momento '{1}' que pode ser restaurado. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 409 RemoteDatabaseExists - O nome do banco de dados de destino já existe no servidor de destino. 409 ConflictingDatabaseOperation - Já existe alguma operação no banco de dados e a operação atual deve aguardar até que ela seja concluída. 409 Assinatura Desabilitada – A assinatura está desabilitada. 409 ManagementServiceDatabaseBusy - O banco de dados '{0}' está ocupado com outra operação. Tente sua operação mais tarde. 409 ConflictingSystemOperationInProgress - Uma operação de manutenção do sistema está em andamento no banco de dados e outras operações precisam aguardar até que ele seja concluído. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 500 ActivateOrDeactivateWorkflowThrottling - Falha no fluxo de trabalho de ativação ou desativação porque há muitos fluxos de trabalho simultâneos 503 DatabaseUnavailable - A operação falhou porque o banco de dados não está disponível. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Updates a managed database with maximal properties

Updates a managed database with minimal properties

Updates a managed database with maximal properties

Solicitação de exemplo

HTTP

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

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Java

import com.azure.resourcemanager.sql.models.ManagedDatabaseUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ManagedDatabases Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseUpdateMax.json
     */
    /**
     * Sample code: Updates a managed database with maximal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesAManagedDatabaseWithMaximalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().update("Default-SQL-SouthEastAsia",
            "managedInstance", "testdb", new ManagedDatabaseUpdate().withTags(mapOf("tagKey1", "fakeTokenPlaceholder")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Código de status:

202

Updates a managed database with minimal properties

Solicitação de exemplo

HTTP

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

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Java

import com.azure.resourcemanager.sql.models.ManagedDatabaseUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ManagedDatabases Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseUpdateMin.json
     */
    /**
     * Sample code: Updates a managed database with minimal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesAManagedDatabaseWithMinimalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().update("Default-SQL-SouthEastAsia",
            "managedInstance", "testdb", new ManagedDatabaseUpdate().withTags(mapOf("tagKey1", "fakeTokenPlaceholder")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Código de status:

202

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.
ManagedDatabaseUpdate	Uma atualização de banco de dados gerenciado.

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

ManagedDatabaseUpdate

Uma atualização de banco de dados gerenciado.

Nome	Tipo	Description
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.