CreateAdvancedQueryHistory
Creates an advanced query history record to save custom query condition statements for reuse and management.
Operation description
This topic provides an example of how to save a query condition statement as an advanced query history record. The query statement is used to query all AccessKey access events in logs.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
actiontrail:CreateAdvancedQueryHistory |
create |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| QuerySql |
string |
No |
The query condition statement. You can edit the query statement based on the SQL syntax for advanced queries. |
event.userIdentity.accessKeyId: * |
| SimpleQuery |
boolean |
Yes |
Specifies whether to enable the simple query mode. |
false |
| DryRun |
boolean |
No |
Specifies whether to perform only a dry run. If you set this parameter to true, the system checks only the access links required to create the query history record and does not create the record. If you set this parameter to false or do not specify this parameter, the system creates the query history record. Default value: false. |
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| QueryId |
string |
The ID of the advanced query history record. |
query-uIkIvLiVSuCKqg0yoa**** |
| QuerySql |
string |
The advanced query statement. |
event.userIdentity.accessKeyId: * |
| RequestId |
string |
The request ID. |
D0227506-AA8C-5998-8A62-74769106**** |
| SimpleQuery |
boolean |
Specifies whether to enable the simple query mode. |
false |
| DryRunResult |
string |
The dry run result. This parameter is returned and set to Passed only when DryRun is set to true and the dry run is successful. This parameter is not returned when a query history record is created. |
Passed |
Examples
Success response
JSON format
{
"QueryId": "query-uIkIvLiVSuCKqg0yoa****",
"QuerySql": "event.userIdentity.accessKeyId: *",
"RequestId": "D0227506-AA8C-5998-8A62-74769106****",
"SimpleQuery": false,
"DryRunResult": "Passed"
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.