AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Deletes the specified rule.
Before you can delete the rule, you must remove all targets, using RemoveTargets.
When you delete a rule, incoming events might continue to match to the deleted rule. Allow a short period of time for changes to take effect.
If you call delete rule multiple times for the same rule, all calls will succeed.
When you call delete rule for a non-existent custom eventbus, ResourceNotFoundException
is returned.
Managed rules are rules created and managed by another Amazon Web Services service
on your behalf. These rules are created by those other Amazon Web Services services
to support functionality in those services. You can delete these rules using the Force
option, but you should do so only if you are sure the other service is not still using
that rule.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginDeleteRule and EndDeleteRule.
Namespace: Amazon.CloudWatchEvents
Assembly: AWSSDK.CloudWatchEvents.dll
Version: 3.x.y.z
public abstract Task<DeleteRuleResponse> DeleteRuleAsync( DeleteRuleRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the DeleteRule service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| ConcurrentModificationException | There is concurrent modification on a rule, target, archive, or replay. |
| InternalException | This exception occurs due to unexpected causes. |
| ManagedRuleException | This rule was created by an Amazon Web Services service on behalf of your account. It is managed by that service. If you see this error in response to DeleteRule or RemoveTargets, you can use the Force parameter in those calls to delete the rule or remove targets from the rule. You cannot modify these managed rules by using DisableRule, EnableRule, PutTargets, PutRule, TagResource, or UntagResource. |
| ResourceNotFoundException | An entity that you specified does not exist. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5