AWS SDK Version 3 for .NET
API Reference

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 Firewall and its FirewallStatus. This operation requires the firewall's DeleteProtection flag to be FALSE. You can't revert this operation.

You can check whether a firewall is in use by reviewing the route tables for the Availability Zones where you have firewall subnet mappings. Retrieve the subnet mappings by calling DescribeFirewall. You define and update the route tables through Amazon VPC. As needed, update the route tables for the zones to remove the firewall endpoints. When the route tables no longer use the firewall endpoints, you can remove the firewall safely.

To delete a firewall, remove the delete protection if you need to using UpdateFirewallDeleteProtection, then delete the firewall by calling DeleteFirewall.

Note:

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 BeginDeleteFirewall and EndDeleteFirewall.

Namespace: Amazon.NetworkFirewall
Assembly: AWSSDK.NetworkFirewall.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<DeleteFirewallResponse> DeleteFirewallAsync(
         DeleteFirewallRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.NetworkFirewall.Model.DeleteFirewallRequest

Container for the necessary parameters to execute the DeleteFirewall service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the DeleteFirewall service method, as returned by NetworkFirewall.

Exceptions

ExceptionCondition
InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
InvalidRequestException The operation failed because of a problem with your request. Examples include: You specified an unsupported parameter name or value. You tried to update a property with a value that isn't among the available types. Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
ThrottlingException Unable to process the request due to throttling limitations.
UnsupportedOperationException The operation you requested isn't supported by Network Firewall.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer

See Also