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

FirewallEndpointAssociation

class FirewallEndpointAssociation : KotlinCustomResource

Firewall endpoint association links a firewall endpoint to a VPC network in the same zone. After you define this association, Cloud Firewall forwards the zonal workload traffic in your VPC network that requires layer 7 inspection to the attached firewall endpoint. To get more information about FirewallEndpointAssociation, see:

API documentation
How-to Guides

Example Usage

Network Security Firewall Endpoint Association 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",
    labels: {
        foo: "bar",
    },
});
const defaultAssociation = new gcp.networksecurity.FirewallEndpointAssociation("default_association", {
    name: "my-firewall-endpoint-association",
    parent: "projects/my-project-name",
    location: "us-central1-a",
    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",
    labels={
        "foo": "bar",
    })
default_association = gcp.networksecurity.FirewallEndpointAssociation("default_association",
    name="my-firewall-endpoint-association",
    parent="projects/my-project-name",
    location="us-central1-a",
    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",
        Labels =
        {
            { "foo", "bar" },
        },
    });
    var defaultAssociation = new Gcp.NetworkSecurity.FirewallEndpointAssociation("default_association", new()
    {
        Name = "my-firewall-endpoint-association",
        Parent = "projects/my-project-name",
        Location = "us-central1-a",
        Labels =
        {
            { "foo", "bar" },
        },
    });
});

package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v7/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"),
			Labels: pulumi.StringMap{
				"foo": pulumi.String("bar"),
			},
		})
		if err != nil {
			return err
		}
		_, err = networksecurity.NewFirewallEndpointAssociation(ctx, "default_association", &networksecurity.FirewallEndpointAssociationArgs{
			Name:     pulumi.String("my-firewall-endpoint-association"),
			Parent:   pulumi.String("projects/my-project-name"),
			Location: pulumi.String("us-central1-a"),
			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 com.pulumi.gcp.networksecurity.FirewallEndpointAssociation;
import com.pulumi.gcp.networksecurity.FirewallEndpointAssociationArgs;
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")
            .labels(Map.of("foo", "bar"))
            .build());
        var defaultAssociation = new FirewallEndpointAssociation("defaultAssociation", FirewallEndpointAssociationArgs.builder()
            .name("my-firewall-endpoint-association")
            .parent("projects/my-project-name")
            .location("us-central1-a")
            .labels(Map.of("foo", "bar"))
            .build());
    }
}

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

Import

FirewallEndpointAssociation can be imported using any of these accepted formats:

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

$ pulumi import gcp:networksecurity/firewallEndpointAssociation:FirewallEndpointAssociation default {{parent}}/locations/{{location}}/firewallEndpointAssociations/{{name}}

Properties

createTime

val createTime: Output<String>

Time the firewall endpoint was created in UTC.

disabled

val disabled: Output<Boolean>?

Whether the association is disabled. True indicates that traffic will not be intercepted.

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.

firewallEndpoint

val firewallEndpoint: Output<String>

The URL of the firewall endpoint that is being associated.

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 association.

name

val name: Output<String>

The name of the firewall endpoint association resource.

network

val network: Output<String>

The URL of the network that is being associated.

parent

val parent: Output<String>?

The name of the parent this firewall endpoint association belongs to. Format: projects/{project_id}.