调用ModifyDBInstanceTDE接口开启RDS实例透明数据加密功能。
透明数据加密TDE可对数据文件执行实时I/O加密和解密，数据在写入磁盘之前进行加密，从磁盘读入内存时进行解密。详情请参见透明数据加密。
调用该接口时，实例必须满足以下条件，否则将操作失败：
- 已开通KMS。如果您未开通KMS，可在开通TDE过程中根据引导开通KMS。
- 实例类型为：
- MySQL 5.6
- MySQL 5.7高可用版（本地SSD盘）
- SQL Server企业版
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ModifyDBInstanceTDE |
系统规定参数，取值：ModifyDBInstanceTDE。 |
| DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。 |
| TDEStatus | String | 是 | Enabled |
TDE状态，取值：Enabled | Disabled |
| DBName | String | 否 | testDB |
想要开启TDE的数据库名称，可以一次输入多个，以英文逗号（,）分隔，最多传入50个。
说明 仅SQL Server企业版实例可以传入此参数。
|
| EncryptionKey | String | 否 | 749c1df7-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
自定义密钥ID。
说明 仅MySQL实例可以传入此参数。
|
| RoleArn | String | 否 | acs:ram::1406926xxxxx:role/aliyunrdsinstanceencryptiondefaultrole |
角色的全局资源描述符，用来指定具体角色。详情请参见RAM角色概览。
说明 仅MySQL实例可以传入此参数。
|
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 777C4593-8053-427B-99E2-105593277CAB |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceTDE
&DBInstanceId=rm-uf6wjk5xxxxxxx
&TDEStatus=Enabled
&<公共请求参数>正常返回示例
XML 格式
<ModifyDBInstanceTDEResponse>
<requestId>777C4593-8053-427B-99E2-105593277CAB</requestId>
</ModifyDBInstanceTDEResponse>JSON 格式
{
"requestId": "777C4593-8053-427B-99E2-105593277CAB"
}错误码
访问错误中心查看更多错误码。
