We recommend new projects start with resources from the AWS provider.
published on Monday, Mar 9, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Monday, Mar 9, 2026 by Pulumi
Creates a new Scheduled Query that allows you to define a Logs Insights query that will run on a schedule and configure actions to take with the query results.
Create ScheduledQuery Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new ScheduledQuery(name: string, args: ScheduledQueryArgs, opts?: CustomResourceOptions);@overload
def ScheduledQuery(resource_name: str,
args: ScheduledQueryArgs,
opts: Optional[ResourceOptions] = None)
@overload
def ScheduledQuery(resource_name: str,
opts: Optional[ResourceOptions] = None,
query_language: Optional[str] = None,
schedule_expression: Optional[str] = None,
execution_role_arn: Optional[str] = None,
query_string: Optional[str] = None,
log_group_identifiers: Optional[Sequence[str]] = None,
name: Optional[str] = None,
description: Optional[str] = None,
schedule_end_time: Optional[float] = None,
destination_configuration: Optional[ScheduledQueryDestinationConfigurationArgs] = None,
schedule_start_time: Optional[float] = None,
start_time_offset: Optional[int] = None,
state: Optional[ScheduledQueryState] = None,
tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
timezone: Optional[str] = None)func NewScheduledQuery(ctx *Context, name string, args ScheduledQueryArgs, opts ...ResourceOption) (*ScheduledQuery, error)public ScheduledQuery(string name, ScheduledQueryArgs args, CustomResourceOptions? opts = null)
public ScheduledQuery(String name, ScheduledQueryArgs args)
public ScheduledQuery(String name, ScheduledQueryArgs args, CustomResourceOptions options)
type: aws-native:logs:ScheduledQuery
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ScheduledQueryArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ScheduledQueryArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ScheduledQueryArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ScheduledQueryArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ScheduledQueryArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
ScheduledQuery Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The ScheduledQuery resource accepts the following input properties:
- Execution
Role stringArn - Query
Language string - Query
String string - Schedule
Expression string - Description string
- Destination
Configuration Pulumi.Aws Native. Logs. Inputs. Scheduled Query Destination Configuration - Log
Group List<string>Identifiers - Name string
- Schedule
End doubleTime - Schedule
Start doubleTime - Start
Time intOffset - State
Pulumi.
Aws Native. Logs. Scheduled Query State -
List<Pulumi.
Aws Native. Inputs. Tag> - Timezone string
- Execution
Role stringArn - Query
Language string - Query
String string - Schedule
Expression string - Description string
- Destination
Configuration ScheduledQuery Destination Configuration Args - Log
Group []stringIdentifiers - Name string
- Schedule
End float64Time - Schedule
Start float64Time - Start
Time intOffset - State
Scheduled
Query State Enum -
Tag
Args - Timezone string
- execution
Role StringArn - query
Language String - query
String String - schedule
Expression String - description String
- destination
Configuration ScheduledQuery Destination Configuration - log
Group List<String>Identifiers - name String
- schedule
End DoubleTime - schedule
Start DoubleTime - start
Time IntegerOffset - state
Scheduled
Query State - List<Tag>
- timezone String
- execution
Role stringArn - query
Language string - query
String string - schedule
Expression string - description string
- destination
Configuration ScheduledQuery Destination Configuration - log
Group string[]Identifiers - name string
- schedule
End numberTime - schedule
Start numberTime - start
Time numberOffset - state
Scheduled
Query State - Tag[]
- timezone string
- execution_
role_ strarn - query_
language str - query_
string str - schedule_
expression str - description str
- destination_
configuration ScheduledQuery Destination Configuration Args - log_
group_ Sequence[str]identifiers - name str
- schedule_
end_ floattime - schedule_
start_ floattime - start_
time_ intoffset - state
Scheduled
Query State -
Sequence[Tag
Args] - timezone str
- execution
Role StringArn - query
Language String - query
String String - schedule
Expression String - description String
- destination
Configuration Property Map - log
Group List<String>Identifiers - name String
- schedule
End NumberTime - schedule
Start NumberTime - start
Time NumberOffset - state "ENABLED" | "DISABLED"
- List<Property Map>
- timezone String
Outputs
All input properties are implicitly available as output properties. Additionally, the ScheduledQuery resource produces the following output properties:
- Creation
Time double - Id string
- The provider-assigned unique ID for this managed resource.
- Last
Execution Pulumi.Status Aws Native. Logs. Scheduled Query Last Execution Status - Last
Triggered doubleTime - Last
Updated doubleTime - Scheduled
Query stringArn
- Creation
Time float64 - Id string
- The provider-assigned unique ID for this managed resource.
- Last
Execution ScheduledStatus Query Last Execution Status - Last
Triggered float64Time - Last
Updated float64Time - Scheduled
Query stringArn
- creation
Time Double - id String
- The provider-assigned unique ID for this managed resource.
- last
Execution ScheduledStatus Query Last Execution Status - last
Triggered DoubleTime - last
Updated DoubleTime - scheduled
Query StringArn
- creation
Time number - id string
- The provider-assigned unique ID for this managed resource.
- last
Execution ScheduledStatus Query Last Execution Status - last
Triggered numberTime - last
Updated numberTime - scheduled
Query stringArn
- creation_
time float - id str
- The provider-assigned unique ID for this managed resource.
- last_
execution_ Scheduledstatus Query Last Execution Status - last_
triggered_ floattime - last_
updated_ floattime - scheduled_
query_ strarn
- creation
Time Number - id String
- The provider-assigned unique ID for this managed resource.
- last
Execution "InvalidStatus Query" | "Complete" | "Failed" | "Timeout" - last
Triggered NumberTime - last
Updated NumberTime - scheduled
Query StringArn
Supporting Types
ScheduledQueryDestinationConfiguration, ScheduledQueryDestinationConfigurationArgs
ScheduledQueryLastExecutionStatus, ScheduledQueryLastExecutionStatusArgs
- Invalid
Query InvalidQuery- Complete
Complete- Failed
Failed- Timeout
Timeout
- Scheduled
Query Last Execution Status Invalid Query InvalidQuery- Scheduled
Query Last Execution Status Complete Complete- Scheduled
Query Last Execution Status Failed Failed- Scheduled
Query Last Execution Status Timeout Timeout
- Invalid
Query InvalidQuery- Complete
Complete- Failed
Failed- Timeout
Timeout
- Invalid
Query InvalidQuery- Complete
Complete- Failed
Failed- Timeout
Timeout
- INVALID_QUERY
InvalidQuery- COMPLETE
Complete- FAILED
Failed- TIMEOUT
Timeout
- "Invalid
Query" InvalidQuery- "Complete"
Complete- "Failed"
Failed- "Timeout"
Timeout
ScheduledQueryS3Configuration, ScheduledQueryS3ConfigurationArgs
- Destination
Identifier string - Role
Arn string
- Destination
Identifier string - Role
Arn string
- destination
Identifier String - role
Arn String
- destination
Identifier string - role
Arn string
- destination_
identifier str - role_
arn str
- destination
Identifier String - role
Arn String
ScheduledQueryState, ScheduledQueryStateArgs
- Enabled
ENABLED- Disabled
DISABLED
- Scheduled
Query State Enabled ENABLED- Scheduled
Query State Disabled DISABLED
- Enabled
ENABLED- Disabled
DISABLED
- Enabled
ENABLED- Disabled
DISABLED
- ENABLED
ENABLED- DISABLED
DISABLED
- "ENABLED"
ENABLED- "DISABLED"
DISABLED
Tag, TagArgs
A set of tags to apply to the resource.Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Mar 9, 2026 by Pulumi
