AWS eventbridge documentation change
Summary
Updated documentation for SQS queue types, restructured dynamic JSON path syntax explanation, added SqsParameters to supported parameters, and updated IAM role configuration link.
Security assessment
Changes focus on clarifying syntax requirements and supported parameters for dynamic JSON paths, along with routine updates to queue type terminology. The IAM role mention is standard permission guidance without addressing a specific security vulnerability. No evidence of security fixes or vulnerabilities addressed.
Diff
diff --git a/eventbridge/latest/userguide/eb-targets.md b/eventbridge/latest/userguide/eb-targets.md index 79dd9ced9..77337cd66 100644 --- a//eventbridge/latest/userguide/eb-targets.md +++ b//eventbridge/latest/userguide/eb-targets.md @@ -13,2 +12,0 @@ When you add targets to a rule and that rule runs soon after, any new or updated -The following video covers the basics of targets: - @@ -79 +77 @@ You can have EventBridge send events to a number of AWS service resources. These - * Amazon SQS standard and FIFO queues + * Amazon SQS standard, fair, and FIFO queues @@ -114 +112 @@ Use [`SageMakerPipelineParameters`](https://docs.aws.amazon.com/eventbridge/late - * Amazon SQS FIFO queues + * Amazon SQS fair and FIFO queues @@ -142 +140,12 @@ EventBridge does not support all JSON Path syntax and evaluate it at runtime. Su -Some target parameters support optional dynamic JSON path syntax. This syntax allows you to specify JSON paths instead of static values (for example `$.detail.state`). The entire value has to be a JSON path, not just part of it. For example, `RedshiftParameters.Sql` can be `$.detail.state` but it can't be `"SELECT * FROM $.detail.state"`. These paths are replaced dynamically at runtime with data from the event payload itself at the specified path. Dynamic path parameters can't reference new or transformed values resulting from input transformation. The supported syntax for dynamic parameter JSON paths is the same as when transforming input. For more information, see [Amazon EventBridge input transformation](./eb-transform-target-input.html) +Dynamic path parameters let you use JSON path syntax to reference event data at runtime instead of static values. + +You can use dynamic JSON path syntax with target parameters to specify JSON paths instead of static values (for example, `$.detail.state`). + +#### Requirements + +The entire value must be a JSON path, not just part of it. For example: + + * ✓ Correct: `RedshiftParameters.Sql` can be `$.detail.state` + + * ✗ Incorrect: `RedshiftParameters.Sql` cannot be `"SELECT * FROM $.detail.state"` + @@ -144 +153,11 @@ Some target parameters support optional dynamic JSON path syntax. This syntax al -Dynamic syntax can be used on all the string, non-enum fields of these parameters: + + +EventBridge replaces these paths at runtime with data from the event payload at the specified path. + +#### Limitations + +Dynamic path parameters cannot reference new or transformed values from input transformation. The JSON path syntax is the same as input transformation syntax. For more information, see [Amazon EventBridge input transformation](./eb-transform-target-input.html). + +#### Supported parameters + +You can use dynamic syntax on all string, non-enum fields of these parameters: @@ -153,0 +173,2 @@ Dynamic syntax can be used on all the string, non-enum fields of these parameter + * [`SqsParameters`](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html) + @@ -159 +180 @@ Dynamic syntax can be used on all the string, non-enum fields of these parameter -To make API calls on the resources that you own, EventBridge needs appropriate permissions. Specify an IAM execution role [using the EventBridge console](./eb-create-rule.html#eb-create-rule-target), or by setting the `RoleARN` parameter in [`PutTargets`](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html). +To make API calls on the resources that you own, EventBridge needs appropriate permissions. Specify an IAM execution role [using the EventBridge console](./eb-create-rule-wizard.html#eb-create-rule-target), or by setting the `RoleARN` parameter in [`PutTargets`](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html).