pulumi-gcp-kotlin/com.pulumi.gcp.edgenetwork.kotlin/Subnet

Subnet

class Subnet : KotlinCustomResource

A Distributed Cloud Edge subnet, which provides L2 isolation within a network. To get more information about Subnet, see:

Example Usage

Edgenetwork Subnet

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const exampleNetwork = new gcp.edgenetwork.Network("example_network", {
    networkId: "example-network",
    location: "us-west1",
    zone: "",
    description: "Example network.",
    mtu: 9000,
});
const exampleSubnet = new gcp.edgenetwork.Subnet("example_subnet", {
    subnetId: "example-subnet",
    location: "us-west1",
    zone: "",
    description: "Example subnet.",
    network: exampleNetwork.id,
    ipv4Cidrs: ["4.4.4.1/24"],
    labels: {
        environment: "dev",
    },
});
Content copied to clipboard
import pulumi
import pulumi_gcp as gcp
example_network = gcp.edgenetwork.Network("example_network",
    network_id="example-network",
    location="us-west1",
    zone="",
    description="Example network.",
    mtu=9000)
example_subnet = gcp.edgenetwork.Subnet("example_subnet",
    subnet_id="example-subnet",
    location="us-west1",
    zone="",
    description="Example subnet.",
    network=example_network.id,
    ipv4_cidrs=["4.4.4.1/24"],
    labels={
        "environment": "dev",
    })
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
    var exampleNetwork = new Gcp.EdgeNetwork.Network("example_network", new()
    {
        NetworkId = "example-network",
        Location = "us-west1",
        Zone = "",
        Description = "Example network.",
        Mtu = 9000,
    });
    var exampleSubnet = new Gcp.EdgeNetwork.Subnet("example_subnet", new()
    {
        SubnetId = "example-subnet",
        Location = "us-west1",
        Zone = "",
        Description = "Example subnet.",
        Network = exampleNetwork.Id,
        Ipv4Cidrs = new[]
        {
            "4.4.4.1/24",
        },
        Labels =
        {
            { "environment", "dev" },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/edgenetwork"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleNetwork, err := edgenetwork.NewNetwork(ctx, "example_network", &edgenetwork.NetworkArgs{
			NetworkId:   pulumi.String("example-network"),
			Location:    pulumi.String("us-west1"),
			Zone:        pulumi.String(""),
			Description: pulumi.String("Example network."),
			Mtu:         pulumi.Int(9000),
		})
		if err != nil {
			return err
		}
		_, err = edgenetwork.NewSubnet(ctx, "example_subnet", &edgenetwork.SubnetArgs{
			SubnetId:    pulumi.String("example-subnet"),
			Location:    pulumi.String("us-west1"),
			Zone:        pulumi.String(""),
			Description: pulumi.String("Example subnet."),
			Network:     exampleNetwork.ID(),
			Ipv4Cidrs: pulumi.StringArray{
				pulumi.String("4.4.4.1/24"),
			},
			Labels: pulumi.StringMap{
				"environment": pulumi.String("dev"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.edgenetwork.Network;
import com.pulumi.gcp.edgenetwork.NetworkArgs;
import com.pulumi.gcp.edgenetwork.Subnet;
import com.pulumi.gcp.edgenetwork.SubnetArgs;
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 exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()
            .networkId("example-network")
            .location("us-west1")
            .zone("")
            .description("Example network.")
            .mtu(9000)
            .build());
        var exampleSubnet = new Subnet("exampleSubnet", SubnetArgs.builder()
            .subnetId("example-subnet")
            .location("us-west1")
            .zone("")
            .description("Example subnet.")
            .network(exampleNetwork.id())
            .ipv4Cidrs("4.4.4.1/24")
            .labels(Map.of("environment", "dev"))
            .build());
    }
}
Content copied to clipboard
resources:
  exampleSubnet:
    type: gcp:edgenetwork:Subnet
    name: example_subnet
    properties:
      subnetId: example-subnet
      location: us-west1
      zone: ""
      description: Example subnet.
      network: ${exampleNetwork.id}
      ipv4Cidrs:
        - 4.4.4.1/24
      labels:
        environment: dev
  exampleNetwork:
    type: gcp:edgenetwork:Network
    name: example_network
    properties:
      networkId: example-network
      location: us-west1
      zone: ""
      description: Example network.
      mtu: 9000
Content copied to clipboard

Edgenetwork Subnet With Vlan Id

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const exampleNetwork = new gcp.edgenetwork.Network("example_network", {
    networkId: "example-network",
    location: "us-west1",
    zone: "",
    description: "Example network.",
    mtu: 9000,
});
const exampleSubnetWithVlanId = new gcp.edgenetwork.Subnet("example_subnet_with_vlan_id", {
    subnetId: "example-subnet-with-vlan-id",
    location: "us-west1",
    zone: "",
    description: "Example subnet with VLAN ID.",
    network: exampleNetwork.id,
    ipv6Cidrs: ["4444:4444:4444:4444::1/64"],
    vlanId: 44,
    labels: {
        environment: "dev",
    },
});
Content copied to clipboard
import pulumi
import pulumi_gcp as gcp
example_network = gcp.edgenetwork.Network("example_network",
    network_id="example-network",
    location="us-west1",
    zone="",
    description="Example network.",
    mtu=9000)
example_subnet_with_vlan_id = gcp.edgenetwork.Subnet("example_subnet_with_vlan_id",
    subnet_id="example-subnet-with-vlan-id",
    location="us-west1",
    zone="",
    description="Example subnet with VLAN ID.",
    network=example_network.id,
    ipv6_cidrs=["4444:4444:4444:4444::1/64"],
    vlan_id=44,
    labels={
        "environment": "dev",
    })
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
    var exampleNetwork = new Gcp.EdgeNetwork.Network("example_network", new()
    {
        NetworkId = "example-network",
        Location = "us-west1",
        Zone = "",
        Description = "Example network.",
        Mtu = 9000,
    });
    var exampleSubnetWithVlanId = new Gcp.EdgeNetwork.Subnet("example_subnet_with_vlan_id", new()
    {
        SubnetId = "example-subnet-with-vlan-id",
        Location = "us-west1",
        Zone = "",
        Description = "Example subnet with VLAN ID.",
        Network = exampleNetwork.Id,
        Ipv6Cidrs = new[]
        {
            "4444:4444:4444:4444::1/64",
        },
        VlanId = 44,
        Labels =
        {
            { "environment", "dev" },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/edgenetwork"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleNetwork, err := edgenetwork.NewNetwork(ctx, "example_network", &edgenetwork.NetworkArgs{
			NetworkId:   pulumi.String("example-network"),
			Location:    pulumi.String("us-west1"),
			Zone:        pulumi.String(""),
			Description: pulumi.String("Example network."),
			Mtu:         pulumi.Int(9000),
		})
		if err != nil {
			return err
		}
		_, err = edgenetwork.NewSubnet(ctx, "example_subnet_with_vlan_id", &edgenetwork.SubnetArgs{
			SubnetId:    pulumi.String("example-subnet-with-vlan-id"),
			Location:    pulumi.String("us-west1"),
			Zone:        pulumi.String(""),
			Description: pulumi.String("Example subnet with VLAN ID."),
			Network:     exampleNetwork.ID(),
			Ipv6Cidrs: pulumi.StringArray{
				pulumi.String("4444:4444:4444:4444::1/64"),
			},
			VlanId: pulumi.Int(44),
			Labels: pulumi.StringMap{
				"environment": pulumi.String("dev"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.edgenetwork.Network;
import com.pulumi.gcp.edgenetwork.NetworkArgs;
import com.pulumi.gcp.edgenetwork.Subnet;
import com.pulumi.gcp.edgenetwork.SubnetArgs;
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 exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()
            .networkId("example-network")
            .location("us-west1")
            .zone("")
            .description("Example network.")
            .mtu(9000)
            .build());
        var exampleSubnetWithVlanId = new Subnet("exampleSubnetWithVlanId", SubnetArgs.builder()
            .subnetId("example-subnet-with-vlan-id")
            .location("us-west1")
            .zone("")
            .description("Example subnet with VLAN ID.")
            .network(exampleNetwork.id())
            .ipv6Cidrs("4444:4444:4444:4444::1/64")
            .vlanId(44)
            .labels(Map.of("environment", "dev"))
            .build());
    }
}
Content copied to clipboard
resources:
  exampleSubnetWithVlanId:
    type: gcp:edgenetwork:Subnet
    name: example_subnet_with_vlan_id
    properties:
      subnetId: example-subnet-with-vlan-id
      location: us-west1
      zone: ""
      description: Example subnet with VLAN ID.
      network: ${exampleNetwork.id}
      ipv6Cidrs:
        - 4444:4444:4444:4444::1/64
      vlanId: 44
      labels:
        environment: dev
  exampleNetwork:
    type: gcp:edgenetwork:Network
    name: example_network
    properties:
      networkId: example-network
      location: us-west1
      zone: ""
      description: Example network.
      mtu: 9000
Content copied to clipboard

Import

Subnet can be imported using any of these accepted formats:

  • projects/{{project}}/locations/{{location}}/zones/{{zone}}/subnets/{{subnet_id}}

  • {{project}}/{{location}}/{{zone}}/{{subnet_id}}

  • {{location}}/{{zone}}/{{subnet_id}}

  • {{location}}/{{subnet_id}}

  • {{name}} When using the pulumi import command, Subnet can be imported using one of the formats above. For example:

$ pulumi import gcp:edgenetwork/subnet:Subnet default projects/{{project}}/locations/{{location}}/zones/{{zone}}/subnets/{{subnet_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/subnet:Subnet default {{project}}/{{location}}/{{zone}}/{{subnet_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/subnet:Subnet default {{location}}/{{zone}}/{{subnet_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/subnet:Subnet default {{location}}/{{subnet_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/subnet:Subnet default {{name}}
Content copied to clipboard

Properties

Link copied to clipboard
val createTime: Output<String>

The time when the subnet was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: 2014-10-02T15:01:23Z and 2014-10-02T15:01:23.045123456Z.

Link copied to clipboard
val description: Output<String>?

A free-text description of the resource. Max length 1024 characters.

Link copied to clipboard
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.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val ipv4Cidrs: Output<List<String>>?

The ranges of ipv4 addresses that are owned by this subnetwork, in CIDR format.

Link copied to clipboard
val ipv6Cidrs: Output<List<String>>?

The ranges of ipv6 addresses that are owned by this subnetwork, in CIDR format.

Link copied to clipboard
val labels: Output<Map<String, String>>?

Labels associated with this 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.

Link copied to clipboard
val location: Output<String>

The Google Cloud region to which the target Distributed Cloud Edge zone belongs.

Link copied to clipboard
val name: Output<String>

The canonical name of this resource, with format projects/{{project}}/locations/{{location}}/zones/{{zone}}/subnets/{{subnet_id}}

Link copied to clipboard
val network: Output<String>

The ID of the network to which this router belongs. Must be of the form: projects/{{project}}/locations/{{location}}/zones/{{zone}}/networks/{{network_id}}

Link copied to clipboard
val project: Output<String>

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
val pulumiLabels: Output<Map<String, String>>

The combination of labels configured directly on the resource and default labels configured on the provider.

Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val state: Output<String>

Current stage of the resource to the device by config push.

Link copied to clipboard
val subnetId: Output<String>

A unique ID that identifies this subnet.

Link copied to clipboard
val updateTime: Output<String>

The time when the subnet was last updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: 2014-10-02T15:01:23Z and 2014-10-02T15:01:23.045123456Z.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val vlanId: Output<Int>

VLAN ID for this subnetwork. If not specified, one is assigned automatically.

Link copied to clipboard
val zone: Output<String>

The name of the target Distributed Cloud Edge zone.