Partilhar via


Transparent Data Encryptions - Create Or Update

Atualiza a configuração transparente de criptografia de dados de um banco de dados lógico.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/transparentDataEncryption/current?api-version=2025-01-01

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
path True

string

O nome do banco de dados lógico para o qual a diretiva de alerta de segurança está definida.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

tdeName
path True

TransparentDataEncryptionName

O nome da configuração de criptografia de dados transparente.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Corpo do Pedido

Name Necessário Tipo Description
properties.state True

TransparentDataEncryptionState

Especifica o estado da criptografia de dados transparente.

properties.scanState

TransparentDataEncryptionScanState

Especifica o estado da verificação de criptografia da criptografia de dados transparente.

Respostas

Name Tipo Description
200 OK

LogicalDatabaseTransparentDataEncryption

Atualizado com êxito o estado de Criptografia de Dados Transparente do banco de dados.

201 Created

LogicalDatabaseTransparentDataEncryption

Criado com êxito o estado de criptografia de dados transparente do banco de dados.

202 Accepted

A criação ou atualização da configuração de criptografia de dados transparente do banco de dados está em andamento.

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 SecurityAdalPrincipalCertExpiredError - A operação não pôde ser concluída porque o certificado principal do Cofre de Chaves do Azure expirou.

  • 400 AkvHostNotResolvingFromNode - AKV host '{0}' não é resolvível a partir de SQL, no servidor '{1}'.

  • 400 AkvKeyDisabled - As operações na chave gerenciada pelo cliente não são permitidas no Cofre de Chaves do Azure. Por favor, permita as seguintes operações na chave: "get", "wrapKey", "unwrapKey". Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 AkvKeyOperationNotAllowed - As operações na chave gerenciada pelo cliente não são permitidas no Cofre da Chave do Azure. Por favor, permita as seguintes operações na chave: "get", "wrapKey", "unwrapKey". Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 AkvKeyOperationNotAllowedByRBAC - Uma das operações necessárias na chave gerenciada pelo cliente não é permitida para a função RBAC escolhida atualmente da identidade da instância gerenciada no Cofre de Chaves do Azure. Mude para uma função RBAC que permita as seguintes permissões no cofre de chaves: "get", "wrapKey", "unwrapKey". Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - O uri do Cofre da Chave fornecido não é válido.

  • 400 AkvKeyOperationNotAllowedByFirewall - A conexão com o Cofre da Chave do Azure foi proibida pela política de firewall do Cofre da Chave do Azure. Consulte a política de firewall do Azure Key Vault para habilitar conexões da Instância Gerenciada. Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 AkvKeyAccessDenied - Uma das operações necessárias na chave gerenciada pelo cliente no Cofre de Chaves do Azure não é permitida para a política de cofre de chaves definida atualmente usada pela identidade da instância gerenciada. Por favor, utilize uma política que permita as seguintes permissões no cofre de chaves: "get", "wrapKey", "unwrapKey". Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 AkvKeyAccessGeneral403 - A operação do Cofre de Chaves do Azure solicitada pela Instância Gerenciada falhou devido a permissões insuficientes. Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 MissingKeyVaultUriForRestore - O URI da chave do Azure Key Vault '{0}' é necessário para restaurar com êxito o banco de dados '{1}' no servidor '{2}'.

  • 400 AkvKeyDeleted - A chave gerenciada pelo cliente não foi encontrada no Cofre de Chaves do Azure Se ela foi excluída recentemente, a recuperação pode ser possível se a proteção de exclusão suave estiver habilitada no cofre de chaves. Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 AkvKeyTimeout - Não foi possível estabelecer a ligação ao Azure Key Vault. Consulte as configurações de rede para Instância gerenciada '%s'. Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 AzureKeyVaultKeyUsedOnGeoPrimary - A operação não pôde ser concluída porque o nome da Chave do Cofre da Chave do Azure {0} está atualmente definido como protetor de criptografia em geoprimário.

  • 400 AkvKeyDNS - URI do Azure Key Vault não pôde ser resolvido. Verifique se o URI do cofre de chaves é válido e se suas configurações de rede para Instância Gerenciada não estão bloqueando o acesso ao DNS Público do Azure. Para obter ajuda para resolver este problema, consulte https://aka.ms/sqlmi-tde-troubleshooting.

  • 400 KeyMaterialNotFoundOnRemoteServer - O servidor remoto não tem acesso ao material de chave usado como um protetor TDE.

  • 400 PerDatabaseCMKAKVKeyMaterialMissingOnGeoSecondary - Todos os bancos de dados em replicação geográfica devem conter o mesmo material de chave que o protetor de criptografia do banco de dados de origem. Por favor, adicione a chave '{0}' com o mesmo material de chave ao banco de dados de destino '{1}'.

  • 400 AzureKeyVaultRsaKeyNotSupported - O cofre de chaves fornecido usa o Tamanho da Chave RSA ou o Tipo de Chave não suportados. O tamanho da chave RSA suportada é 2048 ou 3072 e o tipo de chave é RSA ou RSA-HSM.

  • 400 PerDatabaseCMKAKVKeyUriMissingOnGeoSecondary - Quando a rotação automática do TDE Protetor de nível de banco de dados está habilitada, os bancos de dados de origem e de destino devem estar conectados ao mesmo cofre de chaves. Adicione a chave '{0}' (do mesmo cofre de chaves conectado ao banco de dados de origem) ao banco de dados de destino '{1}'.

  • 400 PerDatabaseCMKCopyOrReplicationAttemptedWithoutCurrentKeysWithDatabaseName - Ao tentar replicar um banco de dados configurado com protetor de criptografia no nível de banco de dados, as chaves atuais que estão sendo usadas pelo banco de dados primário devem ser passadas para o banco de dados secundário '{0}'

  • 400 ManagedInstanceNoConditionToMakeDatabaseAccessible - Um ou mais bancos de dados na Instância Gerenciada SQL não podem ser disponibilizados porque as causas raiz de inacessibilidade correspondentes não foram atenuadas. Atenue as causas raiz de inacessibilidade para todos os bancos de dados atualmente inacessíveis e tente novamente a operação.

  • 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido

  • 400 SameKeyUriNotFoundOnRemoteServer - O servidor secundário não tem o material da chave do mesmo cofre de chaves que o protetor de criptografia do servidor primário com a rotação automática de chaves habilitada.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - O servidor secundário não tem o material da chave do protetor de criptografia do servidor primário.

  • 400 SecurityAzureKeyVaultGeoChainError - A criação de secundário de secundário (um processo conhecido como encadeamento) não é suportada ao habilitar a Criptografia de Dados Transparente usando o Cofre de Chaves do Azure (BYOK).

  • 400 PerDatabaseCMKDWNotSupported - A CMK no nível de banco de dados em visualização não é suportada para a edição Datawarehouse.

  • 400 BlockSystemAssignedIdentityForCrossTenantCMK - A CMK entre locatários só pode ser configurada quando o servidor está configurado com uma Identidade Gerenciada Atribuída pelo Usuário. Consulte https://aka.ms/sqltdebyokumi para configurar a Identidade Gerenciada Atribuída pelo Usuário.

  • 400 PerDatabaseCMKCopyOrReplicationAttemptedWithoutCurrentKeys - Ao tentar replicar um banco de dados configurado com protetor de criptografia no nível de banco de dados, as chaves atuais que estão sendo usadas pelo primário devem ser passadas para o banco de dados secundário.

  • 400 CannotDropDatabaseAKVError - O banco de dados {0} no servidor {1} não pode ser descartado com segurança porque é criptografado com uma chave gerenciada pelo cliente que não está mais acessível para fazer o último backup antes da queda. Restaure o Azure Key Vault Access no servidor e revalide as chaves para tornar este banco de dados acessível e, em seguida, prossiga com a queda. Para mais pormenores, ver https://aka.ms/tdecmkrestorability

  • 400 CreateDatabaseAttemptedWithRotationInProgress - A operação de criação de banco de dados não pode ser executada no momento devido à rotação contínua da chave TDE (Transparent Data Encryption) no servidor. Tente a operação novamente mais tarde.

  • 400 AzureKeyVaultKeyDisabled - A operação não pôde ser concluída no servidor porque a chave do Cofre da Chave do Azure está desabilitada.

  • 400 PerDatabaseCMKRestoreNotSupported - A restauração do banco de dados não é suportada quando a CMK no nível de banco de dados é configurada na visualização.

  • 400 AzureKeyVaultInvalidExpirationDate - A operação não pôde ser concluída porque a data de expiração da chave do Cofre da Chave do Azure é inválida.

  • 400 PerDatabaseCMKHSNotSupported - A CMK no nível de banco de dados em visualização não é suportada para a edição Hyperscale.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - A operação não pôde ser concluída porque o Uri do Cofre da Chave do Azure é nulo ou vazio.

  • 400 CMKOperationNotAllowed - O usuário tentou executar uma operação no servidor quando o servidor não tinha acesso ao Cofre da Chave do Azure.

  • 400 AkvEndpointNotReachableFromNode - AKV endpoint '{0}' não é acessível a partir de SQL, no servidor '{1}'.

  • 400 AzureKeyVaultNoServerIdentity - A identidade do servidor não está configurada corretamente.

  • 400 AzureKeyVaultInvalidUri - Uma resposta inválida do Azure Key Vault. Use um URI válido do Azure Key Vault.

  • 400 AzureKeyVaultMissingPermissions - O servidor não tem as permissões necessárias no Cofre da Chave do Azure.

  • 400 AzureKeyVaultKeyNameCurrentlyInUse - A operação não pôde ser concluída porque o nome da Chave do Cofre da Chave do Azure {0} está atualmente em uso.

  • 400 AzureKeyVaultKeyThumbprintIsDifferent - A operação não pôde ser concluída porque o material da Chave do Cofre da Chave do Azure é diferente da chave de proteção de criptografia atual.

  • 400 SecurityAzureKeyVaultInvalidKeyName - A operação não pôde ser concluída devido a um nome de chave de servidor inválido.

  • 400 OldGenerationOfAKVKeyBeingUsedError - Não é permitido usar uma versão antiga da chave AKV como protetor TDE. Por favor, use a versão mais recente da chave AKV como o protetor de criptografia

  • 400 PerDatabaseCMKMissingIdentityOnGeoSecondaryDatabase - A identidade CMK por banco de dados não está configurada no banco de dados de destino.

  • 400 AdalGenericError - A operação não pôde ser concluída porque foi encontrado um erro do Azure Ative Directory.

  • 400 AdalServicePrincipalNotFound - A operação não pôde ser concluída porque foi encontrado um erro de Entidade de Serviço não encontrada da biblioteca do Azure Ative Directory.

  • 400 AzureKeyVaultMalformedVaultUri - O uri do Cofre da Chave fornecido não é válido.

  • 400 AttemptedEncryptionOnSystemDatabase - Não é possível criptografar um banco de dados do sistema. As operações de criptografia de banco de dados não podem ser executadas para bancos de dados 'master', 'model', 'tempdb', 'msdb' ou 'resource'.

  • 400 TransparentDataEncryptionSuspendResumeNotSupportedForDW - A suspensão e retomada da verificação de criptografia não é suportada no DW.

  • 400 ReadOnly - Não é possível habilitar ou modificar a criptografia de banco de dados em um banco de dados que é somente leitura, tem arquivos somente leitura ou não é recuperado.

  • 400 CanNotChangeReadOnlyDuringTdeScan - Não é possível modificar o estado somente leitura/leitura-gravação do grupo de arquivos enquanto uma transição de criptografia estiver em andamento.

  • 400 CanNotDropAlterOnMirror - Modifique a criptografia de dados transparente nos bancos de dados primários.

  • 400 TransparentDataEncryptionScanCannotBeSuspendedAgain - A verificação de criptografia não pode ser suspensa porque já está em estado suspenso.

  • 400 TransparentDataEncryptionCannotAlterDatabaseEncryptionKey - A chave de criptografia do banco de dados não pode ser alterada porque o banco de dados não está criptografado.

  • 400 TransparentDataEncryptionScanCannotBeStarted - Quando a alteração de chave está em andamento, apenas as operações de suspensão e retomada são permitidas.

  • 400 TransparentDataEncryptionCannotResume - A verificação de criptografia não pode ser retomada porque nenhuma verificação de criptografia está em andamento.

  • 400 TransparentDataEncryptionCannotSuspend - A verificação de criptografia não pode ser suspensa porque nenhuma verificação de criptografia está em andamento.

  • 400 ManagedInstanceStoppingOrStopped - Operação conflitante enviada enquanto a instância está no estado de parada/parada

  • 400 ManagedInstanceStarting - Operação conflitante enviada enquanto a instância está no estado inicial

  • 400 InvalidTransparentDataEncryptionUpdateRequest - Insira um estado válido. Por favor, use "Ativado" ou "Desativado".

  • 400 InvalidTransparentDataEncryptionName - O nome da chave de criptografia de dados transparente não é suportado.

  • 404 OperationIdNotFound - A operação com Id não existe.

  • 409 ServerKeyNameAlreadyExists - A chave do servidor já existe no servidor.

  • 409 ServerKeyUriAlreadyExists - O URI da chave do servidor já existe no servidor.

  • 409 ServerKeyDoesNotExists - A chave do servidor não existe.

  • 409 AzureKeyVaultKeyNameNotFound - A operação não pôde ser concluída porque o nome da Chave do Cofre da Chave do Azure não existe.

  • 409 AzureKeyVaultKeyInUse - A chave está sendo usada atualmente pelo servidor.

  • 409 EncryptionInProgress - Não é possível modificar a criptografia enquanto uma verificação de criptografia estiver em andamento.

  • 409 KeyChangeInProgress - Não é possível alterar a chave de criptografia do banco de dados enquanto uma verificação de criptografia, descriptografia ou alteração de chave estiver em andamento.

  • 409 NoBulkOperationLock - CREATE/ALTER/DROP DATABASE ENCRYPTION KEY falhou porque não foi possível colocar um bloqueio no banco de dados. Tente novamente mais tarde.

  • 409 NeedsLogBackup - Aguarde alguns minutos para que ocorra um backup de log.

  • 409 AltStateConflict - A operação não pode ser executada no banco de dados porque está envolvida em uma sessão de espelhamento de banco de dados ou em um grupo de disponibilidade. Algumas operações não são permitidas em um banco de dados que está participando de uma sessão de espelhamento de banco de dados ou em um grupo de disponibilidade.

  • 409 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado.

  • 409 OperationCancelled - A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação.

  • 503 AzureKeyVaultConnectionFailed - A operação não pôde ser concluída no servidor porque as tentativas de conexão ao Cofre de Chaves do Azure falharam

  • 503 AzureKeyVaultGenericConnectionError - A operação não pôde ser concluída porque foi encontrado um erro ao tentar recuperar informações do Cofre da Chave.

  • 503 NoDekLock - CREATE/ALTER/DROP DATABASE ENCRYPTION KEY falhou porque não foi possível colocar um bloqueio no banco de dados. Tente novamente mais tarde.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

Update a database's Transparent Data Encryption state with minimal parameters

Pedido de amostra

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/servers/securitytde-42/databases/testdb/transparentDataEncryption/current?api-version=2025-01-01

{
  "properties": {
    "state": "Enabled",
    "scanState": "Suspend"
  }
}

Resposta da amostra

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/servers/securitytde-42/databases/testdb/transparentDataEncryption",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/transparentDataEncryption",
  "properties": {
    "state": "Enabled",
    "scanState": "Suspend"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/servers/securitytde-42/databases/testdb/transparentDataEncryption",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/transparentDataEncryption",
  "properties": {
    "state": "Enabled",
    "scanState": "Suspend"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/locations/southeastasia/transparentDataEncryptionOperationResults/11111111-1111-1111-1111-111111111111

Definições

Name Description
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

LogicalDatabaseTransparentDataEncryption

Um banco de dados lógico transparente estado de verificação de criptografia de dados.

TransparentDataEncryptionName

O nome da configuração de criptografia de dados transparente.

TransparentDataEncryptionScanState

Especifica o estado da verificação de criptografia da criptografia de dados transparente.

TransparentDataEncryptionState

Especifica o estado da criptografia de dados transparente.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

LogicalDatabaseTransparentDataEncryption

Um banco de dados lógico transparente estado de verificação de criptografia de dados.

Name Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.scanState

TransparentDataEncryptionScanState

Especifica o estado da verificação de criptografia da criptografia de dados transparente.

properties.state

TransparentDataEncryptionState

Especifica o estado da criptografia de dados transparente.

type

string

Tipo de recurso.

TransparentDataEncryptionName

O nome da configuração de criptografia de dados transparente.

Valor Description
current

TransparentDataEncryptionScanState

Especifica o estado da verificação de criptografia da criptografia de dados transparente.

Valor Description
None
Resume
Running
Suspend
Aborted
Completed

TransparentDataEncryptionState

Especifica o estado da criptografia de dados transparente.

Valor Description
Enabled
Disabled