Partilhar via

Managed Database Transparent Data Encryption - Create Or Update

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

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

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

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
 path True

string

O nome do banco de dados gerenciado para o qual a diretiva de alerta de segurança está definida.
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 da API do Azure Resource Manager ou do portal.
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

ManagedTransparentDataEncryption

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

ManagedTransparentDataEncryption

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

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 KeyMaterialNotFoundOnRemoteServer - O servidor remoto não tem acesso ao material de chave usado como um protetor TDE.

  • 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 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 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 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 SecurityAzureKeyVaultUrlNullOrEmpty - A operação não pôde ser concluída porque o Uri do Cofre da Chave do Azure é nulo ou vazio.

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

  • 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 AzureKeyVaultNoServerIdentity - A identidade do servidor não está configurada corretamente.

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

  • 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 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido

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

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

  • 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 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 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 CanNotDropAlterOnMirror - Modifique a criptografia de dados transparente nos bancos de dados primários.

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

  • 401 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.

  • 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 NeedsLogBackup - Aguarde alguns minutos para que ocorra um backup de log.

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

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

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/managedInstances/securitytde-42/databases/testdb/transparentDataEncryption/current?api-version=2021-11-01

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

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/managedInstances/securitytde-42/databases/testdb/transparentDataEncryption",
  "name": "current",
  "type": "Microsoft.Sql/managedInstance/databases/transparentDataEncryption",
  "properties": {
    "state": "Enabled"
  }
}
Código de estado:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/managedInstances/securitytde-42/databases/testdb/transparentDataEncryption",
  "name": "current",
  "type": "Microsoft.Sql/managedInstance/databases/transparentDataEncryption",
  "properties": {
    "state": "Enabled"
  }
}

Definições

Name Description
ManagedTransparentDataEncryption

Um estado de criptografia de dados transparente do banco de dados gerenciado.
TransparentDataEncryptionName

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

Especifica o estado da criptografia de dados transparente.

ManagedTransparentDataEncryption

Object

Um estado de criptografia de dados transparente do banco de dados gerenciado.

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

Enumeração

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

Valor Description
current

TransparentDataEncryptionState

Enumeração

Especifica o estado da criptografia de dados transparente.

Valor Description
Disabled
Enabled