Ativar TDE - : Central de Documentação do Alibaba Cloud

A TDE criptografa e descriptografa arquivos de dados em E/S de tempo real. Esse recurso criptografa os dados antes da gravação no disco e os descriptografa antes da leitura do disco para a memória. Para mais informações, consulte Configurar TDE para uma instância ApsaraDB RDS for MySQL.

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

O Key Management Service (KMS) está ativado. Caso contrário, ative o KMS durante a ativação da TDE.
A instância deve executar uma das seguintes versões de mecanismo de banco de dados e edições do RDS:
- MySQL 8.0 (com versão secundária do mecanismo 20191015 ou posterior) na RDS High-availability Edition com SSDs locais
- MySQL 5.7 (com versão secundária do mecanismo 20191015 ou posterior) na RDS High-availability Edition com SSDs locais
- MySQL 5.6
- SQL Server 2019 SE ou Enterprise Edition do SQL Server
- PostgreSQL 10, PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 ou PostgreSQL 15 (com versão secundária do mecanismo 20221030 ou posterior)

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyDBInstanceTDE	Operação a ser executada. Defina o valor como ModifyDBInstanceTDE.
DBInstanceId	String	Sim	rm-uf6wjk5****	ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.
TDEStatus	String	Sim	Enabled	Define se a TDE deve ser ativada. Valores válidos: Enabled Disabled
DBName	String	Não	testDB	Nome do banco de dados no qual ativar a TDE. Especifique até 50 nomes de bancos de dados em uma única solicitação. Separe múltiplos nomes por vírgulas (,). Nota Este parâmetro está disponível e é obrigatório quando a instância executa SQL Server 2019 SE ou Enterprise Edition do SQL Server.
EncryptionKey	String	Não	749c1df7-**---**	ID da chave personalizada. Nota Parâmetro disponível para instâncias com MySQL ou PostgreSQL.
RoleArn	String	Não	acs:ram::1406926****:role/aliyunrdsinstanceencryptiondefaultrole	Alibaba Cloud Resource Name (ARN) da função RAM. Uma função RAM é uma identidade virtual criada na sua conta Alibaba Cloud. Para mais detalhes, consulte Visão geral de funções RAM. Nota Aplicável apenas a instâncias com MySQL ou PostgreSQL.
Certificate	String	Não	oss-ap-southeast-1.aliyuncs.com:****:key.cer	Arquivo que contém o certificado. Formato: Endpoint público: `oss-<The ID of the region>.aliyuncs.com:<The name of the bucket>:<The name of the certificate file>` (O nome do arquivo inclui a extensão.) Endpoint interno: `oss-<The ID of the region>-internal.aliyuncs.com:<The name of the bucket>:<The name of the certificate file>` (O nome do arquivo inclui a extensão.) Nota Utilize este parâmetro para instâncias SQL Server 2019 SE ou Enterprise Edition do SQL Server. Para obter a lista atualizada de regiões, chame a operação DescribeRegions.
PrivateKey	String	Não	oss-ap-southeast-1.aliyuncs.com:****:key.pvk	Arquivo que contém a chave privada do certificado. Formato: Endpoint público: `oss-<The ID of the region>.aliyuncs.com:<The name of the bucket>:<The name of the file that contains the private key>` (O nome do arquivo inclui a extensão.) Endpoint interno: `oss-<The ID of the region>-internal.aliyuncs.com:<The name of the bucket>:<The name of the file that contains the private key>` (O nome do arquivo inclui a extensão.) Nota Requisito para instâncias SQL Server 2019 SE ou Enterprise Edition do SQL Server. Consulte a lista mais recente de regiões chamando a operação DescribeRegions.
PassWord	String	Não	1qaz@WSX	Senha do certificado. Nota Campo válido exclusivamente para SQL Server 2019 SE ou Enterprise Edition do SQL Server.
IsRotate	Boolean	Não	false	Indica se a chave deve ser substituída. Valores válidos: true: substitui a chave. false: mantém a chave atual. Valor padrão: false. Nota Restrito a instâncias com PostgreSQL.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	777C4593-8053-427B-99E2-105593277CAB	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceTDE
&DBInstanceId=rm-uf6wjk5****
&TDEStatus=Enabled
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDBInstanceTDEResponse>
    <RequestId>777C4593-8053-427B-99E2-105593277CAB</RequestId>
</ModifyDBInstanceTDEResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ModifyDBInstanceTDEResponse" : {
    "RequestId" : "777C4593-8053-427B-99E2-105593277CAB"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidTDEstatus.Format	The Specified TDEStatus is not valid.	O valor do parâmetro TDEStatus é inválido.
400	Invalid.PrivateKey	The requested privateKey parameter is invalid.	O valor fornecido para PrivateKey é inválido.
400	Invalid.Certificate	The requested certificate parameter is invalid.	O valor do parâmetro Certificate é inválido.
400	CertOrPrivateKeyOrPasswordNotMatched	The public certificate, private key, and password do not match.	O certificado, a chave privada e a senha não correspondem.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	O tipo atual da instância não oferece suporte a esta operação.
403	IncorrectEngineVersion	Current engine version does not support operations.	A versão do mecanismo de banco de dados da instância não oferece suporte a esta operação.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	A instância está bloqueada e não permite esta operação.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	O estado atual da instância não permite esta operação.
403	DBSizeExceeded	Exceeding the allowed DB size of DB instance.	O tamanho do banco de dados especificado excede o limite permitido.
403	IncorrectMinorVersion	Current engine minor version does not support operations.	A versão secundária atual do mecanismo não oferece suporte a esta operação.
404	InvalidDBName.NotFound	Specified one or more DB name does not exist or DB status does not support.	Um ou mais nomes de banco de dados especificados não existem ou o status do banco de dados não oferece suporte.

Para obter uma lista completa de códigos de erro, consulte Códigos de erro do serviço.