调用CreateRequestDiagnosis接口,发起SQL诊断请求。
使用该接口需满足以下前提条件:
- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。
- 本接口适用的数据库引擎为:
- RDS MySQL
- RDS PostgreSQL
- RDS SQL Server
- PolarDB MySQL版
- PolarDB PostgreSQL版(兼容Oracle)
- 云数据库MongoDB版
说明 RDS PostgreSQL实例内核小版本为20220130及以上。查看和升级内核小版本,请参见升级内核小版本。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateRequestDiagnosis | 系统规定参数。取值:CreateRequestDiagnosis。 |
InstanceId | String | 是 | rm-0iwhhl8gx0ld6**** | 实例ID。 |
NodeId | String | 否 | 202**** | 节点ID。 说明 对于PolarDB MySQL版、PolarDB PostgreSQL版(兼容Oracle)和云数据库MongoDB等集群实例,需要提供节点ID。 |
Database | String | 是 | das | 数据库名。 |
Sql | String | 是 | select * from test where name = 'mockUser' | 待诊断的SQL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 | 返回的状态码。 |
Message | String | Successful | 请求返回的消息。 说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。 |
Data | String | 61820b594664275c4429**** | 诊断ID,是诊断的唯一标识,后续用于查询诊断结果。 |
RequestId | String | 800FBAF5-A539-5B97-A09E-C63AB2F7**** | 请求ID。 |
Success | String | true | 请求是否执行成功:
|
示例
请求示例
http(s)://das.cn-shanghai.aliyuncs.com/?Action=CreateRequestDiagnosis
&InstanceId=rm-0iwhhl8gx0ld6****
&NodeId=202****
&Database=das
&Sql=select * from test where name = 'mockUser'
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateRequestDiagnosisResponse>
<Code>200</Code>
<Message>Successful</Message>
<Data>61820b594664275c4429****</Data>
<RequestId>800FBAF5-A539-5B97-A09E-C63AB2F7****</RequestId>
<Success>true</Success>
</CreateRequestDiagnosisResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Code" : "200",
"Message" : "Successful",
"Data" : "61820b594664275c4429****",
"RequestId" : "800FBAF5-A539-5B97-A09E-C63AB2F7****",
"Success" : "true"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The request parameters are invalid. | 请求参数错误 |
访问错误中心查看更多错误码。