pulumi-gcp-kotlin/com.pulumi.gcp.networksecurity.kotlin/FirewallEndpoint

FirewallEndpoint

class FirewallEndpoint : KotlinCustomResource

A Firewall endpoint is a Cloud Firewall resource that enables layer 7 advanced protection capabilities, such as intrusion prevention, in your network. To get more information about FirewallEndpoint, see:

API documentation
How-to Guides

Warning: If you are using User ADCs (Application Default Credentials) with this resource, you must specify a billing_project_id and set user_project_override to true in the provider configuration. Otherwise the ACM API will return a 403 error. Your account must have the serviceusage.services.use permission on the billing_project_id you defined.

Example Usage

Network Security Firewall Endpoint Basic

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const _default = new gcp.networksecurity.FirewallEndpoint("default", {
    name: "my-firewall-endpoint",
    parent: "organizations/123456789",
    location: "us-central1-a",
    billingProjectId: "my-project-name",
    labels: {
        foo: "bar",
    },
});

import pulumi
import pulumi_gcp as gcp
default = gcp.networksecurity.FirewallEndpoint("default",
    name="my-firewall-endpoint",
    parent="organizations/123456789",
    location="us-central1-a",
    billing_project_id="my-project-name",
    labels={
        "foo": "bar",
    })

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
    var @default = new Gcp.NetworkSecurity.FirewallEndpoint("default", new()
    {
        Name = "my-firewall-endpoint",
        Parent = "organizations/123456789",
        Location = "us-central1-a",
        BillingProjectId = "my-project-name",
        Labels =
        {
            { "foo", "bar" },
        },
    });
});

package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/networksecurity"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := networksecurity.NewFirewallEndpoint(ctx, "default", &networksecurity.FirewallEndpointArgs{
			Name:             pulumi.String("my-firewall-endpoint"),
			Parent:           pulumi.String("organizations/123456789"),
			Location:         pulumi.String("us-central1-a"),
			BillingProjectId: pulumi.String("my-project-name"),
			Labels: pulumi.StringMap{
				"foo": pulumi.String("bar"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.networksecurity.FirewallEndpoint;
import com.pulumi.gcp.networksecurity.FirewallEndpointArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var default_ = new FirewallEndpoint("default", FirewallEndpointArgs.builder()
            .name("my-firewall-endpoint")
            .parent("organizations/123456789")
            .location("us-central1-a")
            .billingProjectId("my-project-name")
            .labels(Map.of("foo", "bar"))
            .build());
    }
}

resources:
  default:
    type: gcp:networksecurity:FirewallEndpoint
    properties:
      name: my-firewall-endpoint
      parent: organizations/123456789
      location: us-central1-a
      billingProjectId: my-project-name
      labels:
        foo: bar

Import

FirewallEndpoint can be imported using any of these accepted formats:

{{parent}}/locations/{{location}}/firewallEndpoints/{{name}} When using the pulumi import command, FirewallEndpoint can be imported using one of the formats above. For example:

$ pulumi import gcp:networksecurity/firewallEndpoint:FirewallEndpoint default {{parent}}/locations/{{location}}/firewallEndpoints/{{name}}

Properties

associatedNetworks

val associatedNetworks: Output<List<String>>

List of networks that are associated with this endpoint in the local zone. This is a projection of the FirewallEndpointAssociations pointing at this endpoint. A network will only appear in this list after traffic routing is fully configured. Format: projects/{project}/global/networks/{name}.

billingProjectId

val billingProjectId: Output<String>

Project to bill on endpoint uptime usage.

createTime

val createTime: Output<String>

Time the firewall endpoint was created in UTC.

effectiveLabels

val effectiveLabels: Output<Map<String, String>>

All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.

val id: Output<String>

labels

val labels: Output<Map<String, String>>?

A map of key/value label pairs to assign to the resource. Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

location

val location: Output<String>

The location (zone) of the firewall endpoint.

name

val name: Output<String>

The name of the firewall endpoint resource.

parent

val parent: Output<String>

The name of the parent this firewall endpoint belongs to. Format: organizations/{organization_id}.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiLabels