调用DescribeDBInstanceTDE接口查询实例数据加密状态。
该接口用于查看实例的透明数据加密(Transparent Data Encryption,TDE)配置。
您已通过ModifyDBInstanceTDE接口开启透明数据加密TDE。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeDBInstanceTDE |
系统规定参数。取值:DescribeDBInstanceTDE。 |
| DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。可调用DescribeDBInstances获取。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| TDEStatus | String | Enabled |
实例级别的TDE状态,取值:Enabled | Disabled |
| RequestId | String | C816A4BF-A6EC-4722-95F9-2055859CCFD2 |
请求ID。 |
| Databases | Array of Database |
数据库级别的TDE状态列表。 说明 对于SQL Server 2019标准版和SQL Server企业版实例,可以在实例级别的TDE开启时,控制数据库级别的TDE开启或关闭。
|
|
| Database | |||
| DBName | String | test02 |
数据库名称。 |
| TDEStatus | String | Enabled |
数据库级别的TDE状态,取值:Enabled | Disabled |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribeDBInstanceTDE
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共请求参数>
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<DescribeDBInstanceTDEResponse>
<TDEStatus>Enabled</TDEStatus>
<Databases>
<DBName>test02</DBName>
<TDEStatus>Enabled</TDEStatus>
</Databases>
<requestId>C816A4BF-A6EC-4722-95F9-2055859CCFD2</requestId>
</DescribeDBInstanceTDEResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TDEStatus" : "Enabled",
"Databases" : [ {
"DBName" : "test02",
"TDEStatus" : "Enabled"
} ],
"requestId" : "C816A4BF-A6EC-4722-95F9-2055859CCFD2"
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Connect.Timeout | Service can not connect to instance temporarily. | 操作失败,服务暂时无法连接到实例,请稍后重试。 |
| 400 | SqlExcutionFailed | Failed to connect to host: connection timed out. | 无法连接到主机:连接超时。 |
| 400 | DbossGeneralError | The instance is being created. Please wait. | 实例正在创建中,请稍等。 |
| 403 | IncorrectDBInstanceType | Current DB instance engine and type does not support operations. | 操作失败,当前数据库实例引擎和类型不支持。 |
| 403 | IncorrectEngineVersion | The engine version does not support the operation. | 操作失败,当前数据库版本不支持该操作。 |
| 403 | DBSizeExceeded | Exceeding the allowed DB size of DB instance. | 数据库大小超超限制。 |
| 404 | InvalidDBName.NotFound | Specified one or more DB name does not exist or DB status does not support. | 操作失败,数据库实例名称不存在。 |
访问错误中心查看更多错误码。