AWS Native is in preview. AWS Classic is fully supported.
aws-native.events.getRule
Explore with Pulumi AI
AWS Native is in preview. AWS Classic is fully supported.
Resource Type definition for AWS::Events::Rule
Using getRule
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getRule(args: GetRuleArgs, opts?: InvokeOptions): Promise<GetRuleResult>
function getRuleOutput(args: GetRuleOutputArgs, opts?: InvokeOptions): Output<GetRuleResult>
def get_rule(arn: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetRuleResult
def get_rule_output(arn: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetRuleResult]
func LookupRule(ctx *Context, args *LookupRuleArgs, opts ...InvokeOption) (*LookupRuleResult, error)
func LookupRuleOutput(ctx *Context, args *LookupRuleOutputArgs, opts ...InvokeOption) LookupRuleResultOutput
> Note: This function is named LookupRule
in the Go SDK.
public static class GetRule
{
public static Task<GetRuleResult> InvokeAsync(GetRuleArgs args, InvokeOptions? opts = null)
public static Output<GetRuleResult> Invoke(GetRuleInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetRuleResult> getRule(GetRuleArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:events:getRule
arguments:
# arguments dictionary
The following arguments are supported:
- Arn string
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- Arn string
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- arn String
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- arn string
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- arn str
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- arn String
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
getRule Result
The following output properties are available:
- Arn string
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- Description string
- The description of the rule.
- Event
Bus stringName - The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
- Event
Pattern object The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
Search the CloudFormation User Guide for
AWS::Events::Rule
for more information about the expected schema for this property.- Role
Arn string - The Amazon Resource Name (ARN) of the role that is used for target invocation.
- Schedule
Expression string - The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.
- State
Pulumi.
Aws Native. Events. Rule State - The state of the rule.
- Targets
List<Pulumi.
Aws Native. Events. Outputs. Rule Target> - Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered.
- Arn string
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- Description string
- The description of the rule.
- Event
Bus stringName - The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
- Event
Pattern interface{} The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
Search the CloudFormation User Guide for
AWS::Events::Rule
for more information about the expected schema for this property.- Role
Arn string - The Amazon Resource Name (ARN) of the role that is used for target invocation.
- Schedule
Expression string - The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.
- State
Rule
State Enum - The state of the rule.
- Targets
[]Rule
Target - Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered.
- arn String
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- description String
- The description of the rule.
- event
Bus StringName - The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
- event
Pattern Object The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
Search the CloudFormation User Guide for
AWS::Events::Rule
for more information about the expected schema for this property.- role
Arn String - The Amazon Resource Name (ARN) of the role that is used for target invocation.
- schedule
Expression String - The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.
- state
Rule
State - The state of the rule.
- targets
List<Rule
Target> - Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered.
- arn string
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- description string
- The description of the rule.
- event
Bus stringName - The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
- event
Pattern any The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
Search the CloudFormation User Guide for
AWS::Events::Rule
for more information about the expected schema for this property.- role
Arn string - The Amazon Resource Name (ARN) of the role that is used for target invocation.
- schedule
Expression string - The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.
- state
Rule
State - The state of the rule.
- targets
Rule
Target[] - Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered.
- arn str
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- description str
- The description of the rule.
- event_
bus_ strname - The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
- event_
pattern Any The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
Search the CloudFormation User Guide for
AWS::Events::Rule
for more information about the expected schema for this property.- role_
arn str - The Amazon Resource Name (ARN) of the role that is used for target invocation.
- schedule_
expression str - The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.
- state
Rule
State - The state of the rule.
- targets
Sequence[Rule
Target] - Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered.
- arn String
- The ARN of the rule, such as arn:aws:events:us-east-2:123456789012:rule/example.
- description String
- The description of the rule.
- event
Bus StringName - The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
- event
Pattern Any The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
Search the CloudFormation User Guide for
AWS::Events::Rule
for more information about the expected schema for this property.- role
Arn String - The Amazon Resource Name (ARN) of the role that is used for target invocation.
- schedule
Expression String - The scheduling expression. For example, "cron(0 20 * * ? *)", "rate(5 minutes)". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.
- state "DISABLED" | "ENABLED" | "ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS"
- The state of the rule.
- targets List<Property Map>
- Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered.
Supporting Types
RuleAppSyncParameters
- Graph
Ql stringOperation
- Graph
Ql stringOperation
- graph
Ql StringOperation
- graph
Ql stringOperation
- graph
Ql StringOperation
RuleAwsVpcConfiguration
- Subnets List<string>
- Assign
Public stringIp - Security
Groups List<string>
- Subnets []string
- Assign
Public stringIp - Security
Groups []string
- subnets List<String>
- assign
Public StringIp - security
Groups List<String>
- subnets string[]
- assign
Public stringIp - security
Groups string[]
- subnets Sequence[str]
- assign_
public_ strip - security_
groups Sequence[str]
- subnets List<String>
- assign
Public StringIp - security
Groups List<String>
RuleBatchArrayProperties
- Size int
- Size int
- size Integer
- size number
- size int
- size Number
RuleBatchParameters
RuleBatchRetryStrategy
- Attempts int
- Attempts int
- attempts Integer
- attempts number
- attempts int
- attempts Number
RuleCapacityProviderStrategyItem
- Capacity
Provider string - Base int
- Weight int
- Capacity
Provider string - Base int
- Weight int
- capacity
Provider String - base Integer
- weight Integer
- capacity
Provider string - base number
- weight number
- capacity_
provider str - base int
- weight int
- capacity
Provider String - base Number
- weight Number
RuleDeadLetterConfig
- Arn string
- Arn string
- arn String
- arn string
- arn str
- arn String
RuleEcsParameters
- Task
Definition stringArn - Capacity
Provider List<Pulumi.Strategy Aws Native. Events. Inputs. Rule Capacity Provider Strategy Item> - bool
- Enable
Execute boolCommand - Group string
- Launch
Type string - Network
Configuration Pulumi.Aws Native. Events. Inputs. Rule Network Configuration - Placement
Constraints List<Pulumi.Aws Native. Events. Inputs. Rule Placement Constraint> - Placement
Strategies List<Pulumi.Aws Native. Events. Inputs. Rule Placement Strategy> - Platform
Version string - string
- Reference
Id string - Tag
List List<Pulumi.Aws Native. Events. Inputs. Rule Tag> - Task
Count int
- Task
Definition stringArn - Capacity
Provider []RuleStrategy Capacity Provider Strategy Item - bool
- Enable
Execute boolCommand - Group string
- Launch
Type string - Network
Configuration RuleNetwork Configuration - Placement
Constraints []RulePlacement Constraint - Placement
Strategies []RulePlacement Strategy - Platform
Version string - string
- Reference
Id string - Tag
List []RuleTag - Task
Count int
- task
Definition StringArn - capacity
Provider List<RuleStrategy Capacity Provider Strategy Item> - Boolean
- enable
Execute BooleanCommand - group String
- launch
Type String - network
Configuration RuleNetwork Configuration - placement
Constraints List<RulePlacement Constraint> - placement
Strategies List<RulePlacement Strategy> - platform
Version String - String
- reference
Id String - tag
List List<RuleTag> - task
Count Integer
- task
Definition stringArn - capacity
Provider RuleStrategy Capacity Provider Strategy Item[] - boolean
- enable
Execute booleanCommand - group string
- launch
Type string - network
Configuration RuleNetwork Configuration - placement
Constraints RulePlacement Constraint[] - placement
Strategies RulePlacement Strategy[] - platform
Version string - string
- reference
Id string - tag
List RuleTag[] - task
Count number
- task_
definition_ strarn - capacity_
provider_ Sequence[Rulestrategy Capacity Provider Strategy Item] - bool
- enable_
execute_ boolcommand - group str
- launch_
type str - network_
configuration RuleNetwork Configuration - placement_
constraints Sequence[RulePlacement Constraint] - placement_
strategies Sequence[RulePlacement Strategy] - platform_
version str - str
- reference_
id str - tag_
list Sequence[RuleTag] - task_
count int
- task
Definition StringArn - capacity
Provider List<Property Map>Strategy - Boolean
- enable
Execute BooleanCommand - group String
- launch
Type String - network
Configuration Property Map - placement
Constraints List<Property Map> - placement
Strategies List<Property Map> - platform
Version String - String
- reference
Id String - tag
List List<Property Map> - task
Count Number
RuleHttpParameters
- Header
Parameters Dictionary<string, string> - Path
Parameter List<string>Values - Query
String Dictionary<string, string>Parameters
- Header
Parameters map[string]string - Path
Parameter []stringValues - Query
String map[string]stringParameters
- header
Parameters Map<String,String> - path
Parameter List<String>Values - query
String Map<String,String>Parameters
- header
Parameters {[key: string]: string} - path
Parameter string[]Values - query
String {[key: string]: string}Parameters
- header_
parameters Mapping[str, str] - path_
parameter_ Sequence[str]values - query_
string_ Mapping[str, str]parameters
- header
Parameters Map<String> - path
Parameter List<String>Values - query
String Map<String>Parameters
RuleInputTransformer
- Input
Template string - Input
Paths Dictionary<string, string>Map
- Input
Template string - Input
Paths map[string]stringMap
- input
Template String - input
Paths Map<String,String>Map
- input
Template string - input
Paths {[key: string]: string}Map
- input_
template str - input_
paths_ Mapping[str, str]map
- input
Template String - input
Paths Map<String>Map
RuleKinesisParameters
- Partition
Key stringPath
- Partition
Key stringPath
- partition
Key StringPath
- partition
Key stringPath
- partition
Key StringPath
RuleNetworkConfiguration
RulePlacementConstraint
- Expression string
- Type string
- Expression string
- Type string
- expression String
- type String
- expression string
- type string
- expression str
- type str
- expression String
- type String
RulePlacementStrategy
RuleRedshiftDataParameters
- Database string
- Db
User string - Secret
Manager stringArn - Sql string
- Sqls List<string>
- Statement
Name string - With
Event bool
- Database string
- Db
User string - Secret
Manager stringArn - Sql string
- Sqls []string
- Statement
Name string - With
Event bool
- database String
- db
User String - secret
Manager StringArn - sql String
- sqls List<String>
- statement
Name String - with
Event Boolean
- database string
- db
User string - secret
Manager stringArn - sql string
- sqls string[]
- statement
Name string - with
Event boolean
- database str
- db_
user str - secret_
manager_ strarn - sql str
- sqls Sequence[str]
- statement_
name str - with_
event bool
- database String
- db
User String - secret
Manager StringArn - sql String
- sqls List<String>
- statement
Name String - with
Event Boolean
RuleRetryPolicy
- maximum
Event IntegerAge In Seconds - maximum
Retry IntegerAttempts
- maximum
Event numberAge In Seconds - maximum
Retry numberAttempts
- maximum
Event NumberAge In Seconds - maximum
Retry NumberAttempts
RuleRunCommandParameters
RuleRunCommandTarget
RuleSageMakerPipelineParameter
RuleSageMakerPipelineParameters
RuleSqsParameters
- Message
Group stringId
- Message
Group stringId
- message
Group StringId
- message
Group stringId
- message_
group_ strid
- message
Group StringId
RuleState
RuleTag
RuleTarget
- Arn string
- Id string
- App
Sync Pulumi.Parameters Aws Native. Events. Inputs. Rule App Sync Parameters - Batch
Parameters Pulumi.Aws Native. Events. Inputs. Rule Batch Parameters - Dead
Letter Pulumi.Config Aws Native. Events. Inputs. Rule Dead Letter Config - Ecs
Parameters Pulumi.Aws Native. Events. Inputs. Rule Ecs Parameters - Http
Parameters Pulumi.Aws Native. Events. Inputs. Rule Http Parameters - Input string
- Input
Path string - Input
Transformer Pulumi.Aws Native. Events. Inputs. Rule Input Transformer - Kinesis
Parameters Pulumi.Aws Native. Events. Inputs. Rule Kinesis Parameters - Redshift
Data Pulumi.Parameters Aws Native. Events. Inputs. Rule Redshift Data Parameters - Retry
Policy Pulumi.Aws Native. Events. Inputs. Rule Retry Policy - Role
Arn string - Run
Command Pulumi.Parameters Aws Native. Events. Inputs. Rule Run Command Parameters - Sage
Maker Pulumi.Pipeline Parameters Aws Native. Events. Inputs. Rule Sage Maker Pipeline Parameters - Sqs
Parameters Pulumi.Aws Native. Events. Inputs. Rule Sqs Parameters
- Arn string
- Id string
- App
Sync RuleParameters App Sync Parameters - Batch
Parameters RuleBatch Parameters - Dead
Letter RuleConfig Dead Letter Config - Ecs
Parameters RuleEcs Parameters - Http
Parameters RuleHttp Parameters - Input string
- Input
Path string - Input
Transformer RuleInput Transformer - Kinesis
Parameters RuleKinesis Parameters - Redshift
Data RuleParameters Redshift Data Parameters - Retry
Policy RuleRetry Policy - Role
Arn string - Run
Command RuleParameters Run Command Parameters - Sage
Maker RulePipeline Parameters Sage Maker Pipeline Parameters - Sqs
Parameters RuleSqs Parameters
- arn String
- id String
- app
Sync RuleParameters App Sync Parameters - batch
Parameters RuleBatch Parameters - dead
Letter RuleConfig Dead Letter Config - ecs
Parameters RuleEcs Parameters - http
Parameters RuleHttp Parameters - input String
- input
Path String - input
Transformer RuleInput Transformer - kinesis
Parameters RuleKinesis Parameters - redshift
Data RuleParameters Redshift Data Parameters - retry
Policy RuleRetry Policy - role
Arn String - run
Command RuleParameters Run Command Parameters - sage
Maker RulePipeline Parameters Sage Maker Pipeline Parameters - sqs
Parameters RuleSqs Parameters
- arn string
- id string
- app
Sync RuleParameters App Sync Parameters - batch
Parameters RuleBatch Parameters - dead
Letter RuleConfig Dead Letter Config - ecs
Parameters RuleEcs Parameters - http
Parameters RuleHttp Parameters - input string
- input
Path string - input
Transformer RuleInput Transformer - kinesis
Parameters RuleKinesis Parameters - redshift
Data RuleParameters Redshift Data Parameters - retry
Policy RuleRetry Policy - role
Arn string - run
Command RuleParameters Run Command Parameters - sage
Maker RulePipeline Parameters Sage Maker Pipeline Parameters - sqs
Parameters RuleSqs Parameters
- arn str
- id str
- app_
sync_ Ruleparameters App Sync Parameters - batch_
parameters RuleBatch Parameters - dead_
letter_ Ruleconfig Dead Letter Config - ecs_
parameters RuleEcs Parameters - http_
parameters RuleHttp Parameters - input str
- input_
path str - input_
transformer RuleInput Transformer - kinesis_
parameters RuleKinesis Parameters - redshift_
data_ Ruleparameters Redshift Data Parameters - retry_
policy RuleRetry Policy - role_
arn str - run_
command_ Ruleparameters Run Command Parameters - sage_
maker_ Rulepipeline_ parameters Sage Maker Pipeline Parameters - sqs_
parameters RuleSqs Parameters
- arn String
- id String
- app
Sync Property MapParameters - batch
Parameters Property Map - dead
Letter Property MapConfig - ecs
Parameters Property Map - http
Parameters Property Map - input String
- input
Path String - input
Transformer Property Map - kinesis
Parameters Property Map - redshift
Data Property MapParameters - retry
Policy Property Map - role
Arn String - run
Command Property MapParameters - sage
Maker Property MapPipeline Parameters - sqs
Parameters Property Map
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
AWS Native is in preview. AWS Classic is fully supported.