DescribeQueryDefinitions
This operation returns a paginated list of your saved CloudWatch Logs Insights query definitions. You can retrieve query definitions from the current account or from a source account that is linked to the current account.
You can use the queryDefinitionNamePrefix
parameter to limit the results to only the
query definitions that have names that start with a certain string.
Request Syntax
{
"maxResults": number
,
"nextToken": "string
",
"queryDefinitionNamePrefix": "string
",
"queryLanguage": "string
"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- maxResults
-
Limits the number of returned query definitions to the specified number.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 1000.
Required: No
- nextToken
-
The token for the next set of items to return. The token expires after 24 hours.
Type: String
Length Constraints: Minimum length of 1.
Required: No
- queryDefinitionNamePrefix
-
Use this parameter to filter your results to only the query definitions that have names that start with the prefix you specify.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Required: No
- queryLanguage
-
The query language used for this query. For more information about the query languages that CloudWatch Logs supports, see Supported query languages.
Type: String
Valid Values:
CWLI | SQL | PPL
Required: No
Response Syntax
{
"nextToken": "string",
"queryDefinitions": [
{
"lastModified": number,
"logGroupNames": [ "string" ],
"name": "string",
"queryDefinitionId": "string",
"queryLanguage": "string",
"queryString": "string"
}
]
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- nextToken
-
The token for the next set of items to return. The token expires after 24 hours.
Type: String
Length Constraints: Minimum length of 1.
- queryDefinitions
-
The list of query definitions that match your request.
Type: Array of QueryDefinition objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidParameterException
-
A parameter is specified incorrectly.
HTTP Status Code: 400
- ServiceUnavailableException
-
The service cannot complete the request.
HTTP Status Code: 500
Examples
Example
This example retrieves a list of query definitions that have names that begin with
lambda
.
Sample Request
POST / HTTP/1.1
Host: logs.<region>.<domain>
X-Amz-Date: <DATE>
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=content-type;date;host;user-agent;x-amz-date;x-amz-target;x-amzn-requestid, Signature=<Signature>
User-Agent: <UserAgentString>
Accept: application/json
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive
X-Amz-Target: Logs_20140328.DescribeQueryDefinitions
{
"queryDefinitionNamePrefix": "lambda",
"maxResults": 2
}
Sample Response
HTTP/1.1 200 OK
x-amzn-RequestId: <RequestId>
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Date: <Date>
{
"nextToken": "abdcefghijlkmn",
"queryDefinitions": [
{
"lastModified": 1549321515,
"logGroupNames": [ "VPC_Flow_Log1", "VPC_Flow_Log2" ],
"name": "VPC-top15-packet-transfers",
"queryDefinitionId": "123456ab-12ab-123a-789e-1234567890ab"
"querystring": "stats sum(packets) as packetsTransferred by srcAddr, dstAddr | sort packetsTransferred desc | limit 15"
},
{
"lastModified": 1557321299,
"name": "25-most-recent-events",
"queryDefinitionId": "456789ab-abcd-1234-789e-0987654321ab"
"querystring": "fields @timestamp, @message | sort @timestamp desc | limit 25"
}
]
}
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: