v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1451299221.6 KB

Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.

When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Allow a short period of time for changes to take effect.

This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.

post/#X-Amz-Target=AWSEvents.RemoveTargets

Headers

X-Amz-Target'AWSEvents.RemoveTargets' required

Request body

Rulestring required

The name of the rule.

EventBusNamestring

The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.

IdsTargetId[] required

The IDs of the targets to remove from the rule.

Forceboolean

If this is a managed rule, created by an Amazon Web Services service on your behalf, you must specify <code>Force</code> as <code>True</code> to remove targets. This parameter is ignored for rules that are not managed rules. You can check whether a rule is a managed rule by using <code>DescribeRule</code> or <code>ListRules</code> and checking the <code>ManagedBy</code> field of the response.

Response

Success

FailedEntryCountinteger

The number of failed entries.