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=2023-08-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.

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 SecurityInvalidAzureKeyVaultRecoveryLevel - O uri do Cofre da Chave fornecido não é válido.

  • 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 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 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 - A operação não pôde ser concluída porque não há permissões suficientes para iniciar o fluxo de trabalho acessível na instância gerenciada {0}.

  • 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 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 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=2023-08-01

{
  "properties": {
    "state": "Enabled"
  }
}

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"
  }
}
{
  "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"
  }
}
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 estado de criptografia de dados transparente do banco de dados lógico.

TransparentDataEncryptionName

O nome da configuração de 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 destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

LogicalDatabaseTransparentDataEncryption

Um estado de criptografia de dados transparente do banco de dados lógico.

Name Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

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

TransparentDataEncryptionState

Especifica o estado da criptografia de dados transparente.

Valor Description
Enabled
Disabled