App Engine v1 API - Class FirewallClientImpl (2.2.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

Inherited Members

FirewallClient.DefaultEndpoint

FirewallClient.DefaultScopes

FirewallClient.ServiceMetadata

FirewallClient.CreateAsync(CancellationToken)

FirewallClient.Create()

FirewallClient.ShutdownDefaultChannelsAsync()

FirewallClient.BatchUpdateIngressRulesAsync(BatchUpdateIngressRulesRequest, CancellationToken)

FirewallClient.CreateIngressRuleAsync(CreateIngressRuleRequest, CancellationToken)

FirewallClient.GetIngressRuleAsync(GetIngressRuleRequest, CancellationToken)

FirewallClient.UpdateIngressRuleAsync(UpdateIngressRuleRequest, CancellationToken)

FirewallClient.DeleteIngressRuleAsync(DeleteIngressRuleRequest, CancellationToken)

object.GetHashCode()

object.GetType()

object.ToString()

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

FirewallClient.GrpcClient

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

FirewallClient.BatchUpdateIngressRules(BatchUpdateIngressRulesRequest, CallSettings)

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

FirewallClient.BatchUpdateIngressRulesAsync(BatchUpdateIngressRulesRequest, CallSettings)

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

FirewallClient.CreateIngressRule(CreateIngressRuleRequest, CallSettings)

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

FirewallClient.CreateIngressRuleAsync(CreateIngressRuleRequest, CallSettings)

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

FirewallClient.DeleteIngressRule(DeleteIngressRuleRequest, CallSettings)

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

FirewallClient.DeleteIngressRuleAsync(DeleteIngressRuleRequest, CallSettings)

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

FirewallClient.GetIngressRule(GetIngressRuleRequest, CallSettings)

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

FirewallClient.GetIngressRuleAsync(GetIngressRuleRequest, CallSettings)

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

FirewallClient.ListIngressRules(ListIngressRulesRequest, CallSettings)

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

FirewallClient.ListIngressRulesAsync(ListIngressRulesRequest, CallSettings)

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

FirewallClient.UpdateIngressRule(UpdateIngressRuleRequest, CallSettings)

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

FirewallClient.UpdateIngressRuleAsync(UpdateIngressRuleRequest, CallSettings)