Managed Databases - Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Atualizações uma base 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 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.

Corpo do Pedido

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

Respostas

Name	Tipo	Description
200 OK	ManagedDatabase	A base de dados foi atualizada com êxito.
202 Accepted		A atualização da base de dados gerida está em curso.
Other Status Codes		Respostas de Erro: *** 400 PitrPointInTimeInvalid – o ponto anterior no tempo {0} não é válido. Um ponto no tempo válido varia de dias mais cedo até agora e não antes da hora de criação do {1} servidor de origem. 400 CannotUseTrailingWhitespacesInDatabaseName – A validação do nome da base de dados falhou. 400 StorageAccountFull – Instância Gerida atingiu a capacidade total da conta de armazenamento subjacente do Azure. A conta de Armazenamento Premium do Azure está limitada a 35 TB de espaço alocado. 400 AkvHostNotResolvingFromNode – O anfitrião AKV "{0}" não é resolvível a partir 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 cópia de segurança válida em dias tem de estar entre {1} e {2} 400 ManagedDatabaseNameInUse - A base de dados "{0}" já existe. Escolha um nome de base de dados diferente. 400 NoMoreSpaceInManagedInstance – a instância gerida atingiu o limite de armazenamento. A utilização do armazenamento da instância gerida não pode exceder (%d) MBs. 400 ManagedInstanceUpdateSloInProgress – "Não foi possível concluir a operação porque está em curso uma alteração do escalão de serviço para a instância gerida"{0}. Aguarde pela conclusão da operação em curso e tente novamente". 400 SameKeyMaterialNotFoundOnRemoteServer - O servidor secundário não tem o material chave do protetor de encriptação do servidor primário. 400 SourceDatabaseNotFound - A base de dados de origem não existe. 400 RegionDoesNotSupportVersion - Um utilizador tentou criar um servidor de uma versão especificada numa localização onde essa versão do servidor não é suportada. 400 PasswordNotComplex - A palavra-passe fornecida não é suficientemente complexa. 400 CannotUseReservedDatabaseName – Não é possível utilizar o nome da base de dados reservada nesta operação. 400 InvalidServerName – nome de servidor inválido especificado. 400 SourceServerNotFound – a parte do servidor de um ID de base de dados de origem fornecida numa chamada à API CreateDatabaseAsCopy não mapeia para um servidor existente. 400 TokenTooLong – o token fornecido é demasiado longo. 400 CurrentDatabaseSizeExceedsMaxSize – o utilizador tentou reduzir o tamanho máximo de uma base de dados para um tamanho inferior à utilização atual. 400 InvalidCollation - O agrupamento não é reconhecido pelo servidor. 400 AkvEndpointNotReachableFromNode – o ponto final do AKV "{0}" não está acessível a partir do SQL, no servidor "{1}". 400 ServerNotFound - O servidor pedido não foi encontrado. 400 UnsupportedServiceName – o nome especificado é um nome inválido porque contém um ou mais carateres unicode não suportados. 400 CurrentDatabaseLogSizeExceedsMaxSize – o utilizador tentou alterar a base de dados para um sku com um tamanho de registo máximo inferior ao da utilização atual. 400 DatabaseNumberLimitReached – número máximo de bases de dados para Base de Dados SQL Instância Gerida atingida. 400 InvalidDatabaseCreateOrUpdateRequest – o corpo do pedido para a operação de criação ou atualização da base de dados é inválido. 400 InvalidResourceId - Identificador de recurso inválido. 400 InvalidSourceDatabaseId – identificador de base de dados de origem inválido. 400 InvalidRestorableDroppedDatabaseId – Identificador de base de dados removido recuperável inválido 400 MismatchingResourceGroupNameWithUrl – o nome do grupo de recursos fornecido não corresponde ao nome no Url. 400 MismatchingServerNameWithUrl – o nome do servidor fornecido não corresponde ao nome no Url. 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não corresponde à subscrição no Url. 400 MissingCollation - É necessário agrupamento. 400 MissingSourceDatabaseId – Identificador de base de dados de origem em falta. 400 MissingRestorePointInTime – Ponto de restauro em falta no tempo 400 MissingStorageContainerSasToken – Token SAS de contentor de armazenamento em falta 400 MissingStorageContainerUri – URI do contentor de armazenamento em falta 400 RestoreableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Não é possível especificar restoreableDroppedDatabaseId quando sourceDatabaseId já é fornecido no modo de criação de restauro 400 CannotUseReservedDatabaseName – Não é possível utilizar o nome da base de dados reservada nesta operação. 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. 404 CannotFindServerCertificateWithThumbprint - Não é possível localizar o certificado do servidor com thumbprint "{0}". Utilize o Cmdlet do PowerShell "Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate" para criar o certificado. 404 CannotFindObject – Não é possível localizar o objeto porque não existe ou não tem permissões 404 SubscriptionNotFound - A subscrição pedida não foi encontrada. 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor. 404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada. 404 RestoreSourceDatabaseNotFound – Não foi possível localizar a base de dados "{0}" no momento "{1}" que pode ser restaurada. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados. 409 RemoteDatabaseExists – o nome da base de dados de destino já existe no servidor de destino. 409 ConflictingDatabaseOperation – já existe alguma operação na base de dados e a operação atual deve aguardar até estar concluída. 409 SubscriptionDisabled - A subscrição está desativada. 409 ManagementServiceDatabaseBusy - A base de dados "{0}" está ocupada com outra operação. Tente a operação mais tarde. 409 ConflictingSystemOperationInProgress - Está em curso uma operação de manutenção do sistema na base de dados e as operações adicionais têm de aguardar até que seja concluída. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 500 ActivateOrDeactivateWorkflowThrottling – Falha na ativação ou no fluxo de trabalho de desativação porque existem demasiados fluxos de trabalho simultâneos 503 DatabaseUnavailable - A operação falhou porque a base de dados não está disponível. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 504 RequestTimeout - O pedido 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

Pedido de amostra

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 da amostra

Código de estado:

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 estado:

202

Updates a managed database with minimal properties

Pedido de amostra

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 da amostra

Código de estado:

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 estado:

202

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.
ManagedDatabaseUpdate	Uma atualização da base de dados gerida.

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

ManagedDatabaseUpdate

Object

Uma atualização da base de dados gerida.

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