App Engine v1 API - Class FirewallClientImpl (2.3.0)

public sealed class FirewallClientImpl : FirewallClient

Reference documentation and code samples for the App Engine v1 API class FirewallClientImpl.

Firewall client wrapper implementation, for convenient use.

Inheritance

object > FirewallClient > FirewallClientImpl

Namespace

Google.Cloud.AppEngine.V1

Assembly

Google.Cloud.AppEngine.V1.dll

Remarks

Firewall resources are used to define a collection of access control rules for an Application. Each rule is defined with a position which specifies the rule's order in the sequence of rules, an IP range to be matched against requests, and an action to take upon matching requests.

Every request is evaluated against the Firewall rules in priority order. Processesing stops at the first rule which matches the request's IP address. A final rule always specifies an action that applies to all remaining IP addresses. The default final rule for a newly-created application will be set to "allow" if not otherwise specified by the user.

Constructors

FirewallClientImpl(FirewallClient, FirewallSettings, ILogger)

public FirewallClientImpl(Firewall.FirewallClient grpcClient, FirewallSettings settings, ILogger logger)

Constructs a client wrapper for the Firewall service, with the specified gRPC client and settings.

Parameters
Name Description
grpcClient FirewallFirewallClient

The underlying gRPC client.

settings FirewallSettings

The base FirewallSettings used within this client.

logger ILogger

Optional ILogger to use within this client.

Properties

GrpcClient

public override Firewall.FirewallClient GrpcClient { get; }

The underlying gRPC Firewall client

Property Value
Type Description
FirewallFirewallClient
Overrides

Methods

BatchUpdateIngressRules(BatchUpdateIngressRulesRequest, CallSettings)

public override BatchUpdateIngressRulesResponse BatchUpdateIngressRules(BatchUpdateIngressRulesRequest request, CallSettings callSettings = null)

Replaces the entire firewall ruleset in one bulk operation. This overrides and replaces the rules of an existing firewall with the new rules.

If the final rule does not match traffic with the '*' wildcard IP range, then an "allow all" rule is explicitly added to the end of the list.

Parameters
Name Description
request BatchUpdateIngressRulesRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
BatchUpdateIngressRulesResponse

The RPC response.

Overrides

BatchUpdateIngressRulesAsync(BatchUpdateIngressRulesRequest, CallSettings)

public override Task<BatchUpdateIngressRulesResponse> BatchUpdateIngressRulesAsync(BatchUpdateIngressRulesRequest request, CallSettings callSettings = null)

Replaces the entire firewall ruleset in one bulk operation. This overrides and replaces the rules of an existing firewall with the new rules.

If the final rule does not match traffic with the '*' wildcard IP range, then an "allow all" rule is explicitly added to the end of the list.

Parameters
Name Description
request BatchUpdateIngressRulesRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskBatchUpdateIngressRulesResponse

A Task containing the RPC response.

Overrides

CreateIngressRule(CreateIngressRuleRequest, CallSettings)

public override FirewallRule CreateIngressRule(CreateIngressRuleRequest request, CallSettings callSettings = null)

Creates a firewall rule for the application.

Parameters
Name Description
request CreateIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
FirewallRule

The RPC response.

Overrides

CreateIngressRuleAsync(CreateIngressRuleRequest, CallSettings)

public override Task<FirewallRule> CreateIngressRuleAsync(CreateIngressRuleRequest request, CallSettings callSettings = null)

Creates a firewall rule for the application.

Parameters
Name Description
request CreateIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskFirewallRule

A Task containing the RPC response.

Overrides

DeleteIngressRule(DeleteIngressRuleRequest, CallSettings)

public override void DeleteIngressRule(DeleteIngressRuleRequest request, CallSettings callSettings = null)

Deletes the specified firewall rule.

Parameters
Name Description
request DeleteIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Overrides

DeleteIngressRuleAsync(DeleteIngressRuleRequest, CallSettings)

public override Task DeleteIngressRuleAsync(DeleteIngressRuleRequest request, CallSettings callSettings = null)

Deletes the specified firewall rule.

Parameters
Name Description
request DeleteIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
Task

A Task containing the RPC response.

Overrides

GetIngressRule(GetIngressRuleRequest, CallSettings)

public override FirewallRule GetIngressRule(GetIngressRuleRequest request, CallSettings callSettings = null)

Gets the specified firewall rule.

Parameters
Name Description
request GetIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
FirewallRule

The RPC response.

Overrides

GetIngressRuleAsync(GetIngressRuleRequest, CallSettings)

public override Task<FirewallRule> GetIngressRuleAsync(GetIngressRuleRequest request, CallSettings callSettings = null)

Gets the specified firewall rule.

Parameters
Name Description
request GetIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskFirewallRule

A Task containing the RPC response.

Overrides

ListIngressRules(ListIngressRulesRequest, CallSettings)

public override PagedEnumerable<ListIngressRulesResponse, FirewallRule> ListIngressRules(ListIngressRulesRequest request, CallSettings callSettings = null)

Lists the firewall rules of an application.

Parameters
Name Description
request ListIngressRulesRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedEnumerableListIngressRulesResponseFirewallRule

A pageable sequence of FirewallRule resources.

Overrides

ListIngressRulesAsync(ListIngressRulesRequest, CallSettings)

public override PagedAsyncEnumerable<ListIngressRulesResponse, FirewallRule> ListIngressRulesAsync(ListIngressRulesRequest request, CallSettings callSettings = null)

Lists the firewall rules of an application.

Parameters
Name Description
request ListIngressRulesRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
PagedAsyncEnumerableListIngressRulesResponseFirewallRule

A pageable asynchronous sequence of FirewallRule resources.

Overrides

UpdateIngressRule(UpdateIngressRuleRequest, CallSettings)

public override FirewallRule UpdateIngressRule(UpdateIngressRuleRequest request, CallSettings callSettings = null)

Updates the specified firewall rule.

Parameters
Name Description
request UpdateIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
FirewallRule

The RPC response.

Overrides

UpdateIngressRuleAsync(UpdateIngressRuleRequest, CallSettings)

public override Task<FirewallRule> UpdateIngressRuleAsync(UpdateIngressRuleRequest request, CallSettings callSettings = null)

Updates the specified firewall rule.

Parameters
Name Description
request UpdateIngressRuleRequest

The request object containing all of the parameters for the API call.

callSettings CallSettings

If not null, applies overrides to this RPC call.

Returns
Type Description
TaskFirewallRule

A Task containing the RPC response.

Overrides