All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.pulumi.gcp.networkmanagement.kotlin.ConnectivityTestArgs.kt Maven / Gradle / Ivy

Go to download

Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.

There is a newer version: 8.10.0.0
Show newest version
@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.gcp.networkmanagement.kotlin

import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.gcp.networkmanagement.ConnectivityTestArgs.builder
import com.pulumi.gcp.networkmanagement.kotlin.inputs.ConnectivityTestDestinationArgs
import com.pulumi.gcp.networkmanagement.kotlin.inputs.ConnectivityTestDestinationArgsBuilder
import com.pulumi.gcp.networkmanagement.kotlin.inputs.ConnectivityTestSourceArgs
import com.pulumi.gcp.networkmanagement.kotlin.inputs.ConnectivityTestSourceArgsBuilder
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.applySuspend
import kotlin.Pair
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List
import kotlin.collections.Map
import kotlin.jvm.JvmName

/**
 * A connectivity test are a static analysis of your resource configurations
 * that enables you to evaluate connectivity to and from Google Cloud
 * resources in your Virtual Private Cloud (VPC) network.
 * To get more information about ConnectivityTest, see:
 * * [API documentation](https://cloud.google.com/network-intelligence-center/docs/connectivity-tests/reference/networkmanagement/rest/v1/projects.locations.global.connectivityTests)
 * * How-to Guides
 *     * [Official Documentation](https://cloud.google.com/network-intelligence-center/docs)
 * ## Example Usage
 * ### Network Management Connectivity Test Instances
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as gcp from "@pulumi/gcp";
 * const vpc = new gcp.compute.Network("vpc", {name: "conn-test-net"});
 * const debian9 = gcp.compute.getImage({
 *     family: "debian-11",
 *     project: "debian-cloud",
 * });
 * const source = new gcp.compute.Instance("source", {
 *     networkInterfaces: [{
 *         accessConfigs: [{}],
 *         network: vpc.id,
 *     }],
 *     name: "source-vm",
 *     machineType: "e2-medium",
 *     bootDisk: {
 *         initializeParams: {
 *             image: debian9.then(debian9 => debian9.id),
 *         },
 *     },
 * });
 * const destination = new gcp.compute.Instance("destination", {
 *     networkInterfaces: [{
 *         accessConfigs: [{}],
 *         network: vpc.id,
 *     }],
 *     name: "dest-vm",
 *     machineType: "e2-medium",
 *     bootDisk: {
 *         initializeParams: {
 *             image: debian9.then(debian9 => debian9.id),
 *         },
 *     },
 * });
 * const instance_test = new gcp.networkmanagement.ConnectivityTest("instance-test", {
 *     name: "conn-test-instances",
 *     source: {
 *         instance: source.id,
 *     },
 *     destination: {
 *         instance: destination.id,
 *     },
 *     protocol: "TCP",
 *     labels: {
 *         env: "test",
 *     },
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_gcp as gcp
 * vpc = gcp.compute.Network("vpc", name="conn-test-net")
 * debian9 = gcp.compute.get_image(family="debian-11",
 *     project="debian-cloud")
 * source = gcp.compute.Instance("source",
 *     network_interfaces=[gcp.compute.InstanceNetworkInterfaceArgs(
 *         access_configs=[gcp.compute.InstanceNetworkInterfaceAccessConfigArgs()],
 *         network=vpc.id,
 *     )],
 *     name="source-vm",
 *     machine_type="e2-medium",
 *     boot_disk=gcp.compute.InstanceBootDiskArgs(
 *         initialize_params=gcp.compute.InstanceBootDiskInitializeParamsArgs(
 *             image=debian9.id,
 *         ),
 *     ))
 * destination = gcp.compute.Instance("destination",
 *     network_interfaces=[gcp.compute.InstanceNetworkInterfaceArgs(
 *         access_configs=[gcp.compute.InstanceNetworkInterfaceAccessConfigArgs()],
 *         network=vpc.id,
 *     )],
 *     name="dest-vm",
 *     machine_type="e2-medium",
 *     boot_disk=gcp.compute.InstanceBootDiskArgs(
 *         initialize_params=gcp.compute.InstanceBootDiskInitializeParamsArgs(
 *             image=debian9.id,
 *         ),
 *     ))
 * instance_test = gcp.networkmanagement.ConnectivityTest("instance-test",
 *     name="conn-test-instances",
 *     source=gcp.networkmanagement.ConnectivityTestSourceArgs(
 *         instance=source.id,
 *     ),
 *     destination=gcp.networkmanagement.ConnectivityTestDestinationArgs(
 *         instance=destination.id,
 *     ),
 *     protocol="TCP",
 *     labels={
 *         "env": "test",
 *     })
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using Gcp = Pulumi.Gcp;
 * return await Deployment.RunAsync(() =>
 * {
 *     var vpc = new Gcp.Compute.Network("vpc", new()
 *     {
 *         Name = "conn-test-net",
 *     });
 *     var debian9 = Gcp.Compute.GetImage.Invoke(new()
 *     {
 *         Family = "debian-11",
 *         Project = "debian-cloud",
 *     });
 *     var source = new Gcp.Compute.Instance("source", new()
 *     {
 *         NetworkInterfaces = new[]
 *         {
 *             new Gcp.Compute.Inputs.InstanceNetworkInterfaceArgs
 *             {
 *                 AccessConfigs = new[]
 *                 {
 *                     null,
 *                 },
 *                 Network = vpc.Id,
 *             },
 *         },
 *         Name = "source-vm",
 *         MachineType = "e2-medium",
 *         BootDisk = new Gcp.Compute.Inputs.InstanceBootDiskArgs
 *         {
 *             InitializeParams = new Gcp.Compute.Inputs.InstanceBootDiskInitializeParamsArgs
 *             {
 *                 Image = debian9.Apply(getImageResult => getImageResult.Id),
 *             },
 *         },
 *     });
 *     var destination = new Gcp.Compute.Instance("destination", new()
 *     {
 *         NetworkInterfaces = new[]
 *         {
 *             new Gcp.Compute.Inputs.InstanceNetworkInterfaceArgs
 *             {
 *                 AccessConfigs = new[]
 *                 {
 *                     null,
 *                 },
 *                 Network = vpc.Id,
 *             },
 *         },
 *         Name = "dest-vm",
 *         MachineType = "e2-medium",
 *         BootDisk = new Gcp.Compute.Inputs.InstanceBootDiskArgs
 *         {
 *             InitializeParams = new Gcp.Compute.Inputs.InstanceBootDiskInitializeParamsArgs
 *             {
 *                 Image = debian9.Apply(getImageResult => getImageResult.Id),
 *             },
 *         },
 *     });
 *     var instance_test = new Gcp.NetworkManagement.ConnectivityTest("instance-test", new()
 *     {
 *         Name = "conn-test-instances",
 *         Source = new Gcp.NetworkManagement.Inputs.ConnectivityTestSourceArgs
 *         {
 *             Instance = source.Id,
 *         },
 *         Destination = new Gcp.NetworkManagement.Inputs.ConnectivityTestDestinationArgs
 *         {
 *             Instance = destination.Id,
 *         },
 *         Protocol = "TCP",
 *         Labels =
 *         {
 *             { "env", "test" },
 *         },
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/networkmanagement"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		vpc, err := compute.NewNetwork(ctx, "vpc", &compute.NetworkArgs{
 * 			Name: pulumi.String("conn-test-net"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		debian9, err := compute.LookupImage(ctx, &compute.LookupImageArgs{
 * 			Family:  pulumi.StringRef("debian-11"),
 * 			Project: pulumi.StringRef("debian-cloud"),
 * 		}, nil)
 * 		if err != nil {
 * 			return err
 * 		}
 * 		source, err := compute.NewInstance(ctx, "source", &compute.InstanceArgs{
 * 			NetworkInterfaces: compute.InstanceNetworkInterfaceArray{
 * 				&compute.InstanceNetworkInterfaceArgs{
 * 					AccessConfigs: compute.InstanceNetworkInterfaceAccessConfigArray{
 * 						nil,
 * 					},
 * 					Network: vpc.ID(),
 * 				},
 * 			},
 * 			Name:        pulumi.String("source-vm"),
 * 			MachineType: pulumi.String("e2-medium"),
 * 			BootDisk: &compute.InstanceBootDiskArgs{
 * 				InitializeParams: &compute.InstanceBootDiskInitializeParamsArgs{
 * 					Image: pulumi.String(debian9.Id),
 * 				},
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		destination, err := compute.NewInstance(ctx, "destination", &compute.InstanceArgs{
 * 			NetworkInterfaces: compute.InstanceNetworkInterfaceArray{
 * 				&compute.InstanceNetworkInterfaceArgs{
 * 					AccessConfigs: compute.InstanceNetworkInterfaceAccessConfigArray{
 * 						nil,
 * 					},
 * 					Network: vpc.ID(),
 * 				},
 * 			},
 * 			Name:        pulumi.String("dest-vm"),
 * 			MachineType: pulumi.String("e2-medium"),
 * 			BootDisk: &compute.InstanceBootDiskArgs{
 * 				InitializeParams: &compute.InstanceBootDiskInitializeParamsArgs{
 * 					Image: pulumi.String(debian9.Id),
 * 				},
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = networkmanagement.NewConnectivityTest(ctx, "instance-test", &networkmanagement.ConnectivityTestArgs{
 * 			Name: pulumi.String("conn-test-instances"),
 * 			Source: &networkmanagement.ConnectivityTestSourceArgs{
 * 				Instance: source.ID(),
 * 			},
 * 			Destination: &networkmanagement.ConnectivityTestDestinationArgs{
 * 				Instance: destination.ID(),
 * 			},
 * 			Protocol: pulumi.String("TCP"),
 * 			Labels: pulumi.StringMap{
 * 				"env": pulumi.String("test"),
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		return nil
 * 	})
 * }
 * ```
 * ```java
 * package generated_program;
 * import com.pulumi.Context;
 * import com.pulumi.Pulumi;
 * import com.pulumi.core.Output;
 * import com.pulumi.gcp.compute.Network;
 * import com.pulumi.gcp.compute.NetworkArgs;
 * import com.pulumi.gcp.compute.ComputeFunctions;
 * import com.pulumi.gcp.compute.inputs.GetImageArgs;
 * import com.pulumi.gcp.compute.Instance;
 * import com.pulumi.gcp.compute.InstanceArgs;
 * import com.pulumi.gcp.compute.inputs.InstanceNetworkInterfaceArgs;
 * import com.pulumi.gcp.compute.inputs.InstanceBootDiskArgs;
 * import com.pulumi.gcp.compute.inputs.InstanceBootDiskInitializeParamsArgs;
 * import com.pulumi.gcp.networkmanagement.ConnectivityTest;
 * import com.pulumi.gcp.networkmanagement.ConnectivityTestArgs;
 * import com.pulumi.gcp.networkmanagement.inputs.ConnectivityTestSourceArgs;
 * import com.pulumi.gcp.networkmanagement.inputs.ConnectivityTestDestinationArgs;
 * 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 vpc = new Network("vpc", NetworkArgs.builder()
 *             .name("conn-test-net")
 *             .build());
 *         final var debian9 = ComputeFunctions.getImage(GetImageArgs.builder()
 *             .family("debian-11")
 *             .project("debian-cloud")
 *             .build());
 *         var source = new Instance("source", InstanceArgs.builder()
 *             .networkInterfaces(InstanceNetworkInterfaceArgs.builder()
 *                 .accessConfigs()
 *                 .network(vpc.id())
 *                 .build())
 *             .name("source-vm")
 *             .machineType("e2-medium")
 *             .bootDisk(InstanceBootDiskArgs.builder()
 *                 .initializeParams(InstanceBootDiskInitializeParamsArgs.builder()
 *                     .image(debian9.applyValue(getImageResult -> getImageResult.id()))
 *                     .build())
 *                 .build())
 *             .build());
 *         var destination = new Instance("destination", InstanceArgs.builder()
 *             .networkInterfaces(InstanceNetworkInterfaceArgs.builder()
 *                 .accessConfigs()
 *                 .network(vpc.id())
 *                 .build())
 *             .name("dest-vm")
 *             .machineType("e2-medium")
 *             .bootDisk(InstanceBootDiskArgs.builder()
 *                 .initializeParams(InstanceBootDiskInitializeParamsArgs.builder()
 *                     .image(debian9.applyValue(getImageResult -> getImageResult.id()))
 *                     .build())
 *                 .build())
 *             .build());
 *         var instance_test = new ConnectivityTest("instance-test", ConnectivityTestArgs.builder()
 *             .name("conn-test-instances")
 *             .source(ConnectivityTestSourceArgs.builder()
 *                 .instance(source.id())
 *                 .build())
 *             .destination(ConnectivityTestDestinationArgs.builder()
 *                 .instance(destination.id())
 *                 .build())
 *             .protocol("TCP")
 *             .labels(Map.of("env", "test"))
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   instance-test:
 *     type: gcp:networkmanagement:ConnectivityTest
 *     properties:
 *       name: conn-test-instances
 *       source:
 *         instance: ${source.id}
 *       destination:
 *         instance: ${destination.id}
 *       protocol: TCP
 *       labels:
 *         env: test
 *   source:
 *     type: gcp:compute:Instance
 *     properties:
 *       networkInterfaces:
 *         - accessConfigs:
 *             - {}
 *           network: ${vpc.id}
 *       name: source-vm
 *       machineType: e2-medium
 *       bootDisk:
 *         initializeParams:
 *           image: ${debian9.id}
 *   destination:
 *     type: gcp:compute:Instance
 *     properties:
 *       networkInterfaces:
 *         - accessConfigs:
 *             - {}
 *           network: ${vpc.id}
 *       name: dest-vm
 *       machineType: e2-medium
 *       bootDisk:
 *         initializeParams:
 *           image: ${debian9.id}
 *   vpc:
 *     type: gcp:compute:Network
 *     properties:
 *       name: conn-test-net
 * variables:
 *   debian9:
 *     fn::invoke:
 *       Function: gcp:compute:getImage
 *       Arguments:
 *         family: debian-11
 *         project: debian-cloud
 * ```
 * 
 * ### Network Management Connectivity Test Addresses
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as gcp from "@pulumi/gcp";
 * const vpc = new gcp.compute.Network("vpc", {name: "connectivity-vpc"});
 * const subnet = new gcp.compute.Subnetwork("subnet", {
 *     name: "connectivity-vpc-subnet",
 *     ipCidrRange: "10.0.0.0/16",
 *     region: "us-central1",
 *     network: vpc.id,
 * });
 * const source_addr = new gcp.compute.Address("source-addr", {
 *     name: "src-addr",
 *     subnetwork: subnet.id,
 *     addressType: "INTERNAL",
 *     address: "10.0.42.42",
 *     region: "us-central1",
 * });
 * const dest_addr = new gcp.compute.Address("dest-addr", {
 *     name: "dest-addr",
 *     subnetwork: subnet.id,
 *     addressType: "INTERNAL",
 *     address: "10.0.43.43",
 *     region: "us-central1",
 * });
 * const address_test = new gcp.networkmanagement.ConnectivityTest("address-test", {
 *     name: "conn-test-addr",
 *     source: {
 *         ipAddress: source_addr.address,
 *         projectId: source_addr.project,
 *         network: vpc.id,
 *         networkType: "GCP_NETWORK",
 *     },
 *     destination: {
 *         ipAddress: dest_addr.address,
 *         projectId: dest_addr.project,
 *         network: vpc.id,
 *     },
 *     protocol: "UDP",
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_gcp as gcp
 * vpc = gcp.compute.Network("vpc", name="connectivity-vpc")
 * subnet = gcp.compute.Subnetwork("subnet",
 *     name="connectivity-vpc-subnet",
 *     ip_cidr_range="10.0.0.0/16",
 *     region="us-central1",
 *     network=vpc.id)
 * source_addr = gcp.compute.Address("source-addr",
 *     name="src-addr",
 *     subnetwork=subnet.id,
 *     address_type="INTERNAL",
 *     address="10.0.42.42",
 *     region="us-central1")
 * dest_addr = gcp.compute.Address("dest-addr",
 *     name="dest-addr",
 *     subnetwork=subnet.id,
 *     address_type="INTERNAL",
 *     address="10.0.43.43",
 *     region="us-central1")
 * address_test = gcp.networkmanagement.ConnectivityTest("address-test",
 *     name="conn-test-addr",
 *     source=gcp.networkmanagement.ConnectivityTestSourceArgs(
 *         ip_address=source_addr.address,
 *         project_id=source_addr.project,
 *         network=vpc.id,
 *         network_type="GCP_NETWORK",
 *     ),
 *     destination=gcp.networkmanagement.ConnectivityTestDestinationArgs(
 *         ip_address=dest_addr.address,
 *         project_id=dest_addr.project,
 *         network=vpc.id,
 *     ),
 *     protocol="UDP")
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using Gcp = Pulumi.Gcp;
 * return await Deployment.RunAsync(() =>
 * {
 *     var vpc = new Gcp.Compute.Network("vpc", new()
 *     {
 *         Name = "connectivity-vpc",
 *     });
 *     var subnet = new Gcp.Compute.Subnetwork("subnet", new()
 *     {
 *         Name = "connectivity-vpc-subnet",
 *         IpCidrRange = "10.0.0.0/16",
 *         Region = "us-central1",
 *         Network = vpc.Id,
 *     });
 *     var source_addr = new Gcp.Compute.Address("source-addr", new()
 *     {
 *         Name = "src-addr",
 *         Subnetwork = subnet.Id,
 *         AddressType = "INTERNAL",
 *         IPAddress = "10.0.42.42",
 *         Region = "us-central1",
 *     });
 *     var dest_addr = new Gcp.Compute.Address("dest-addr", new()
 *     {
 *         Name = "dest-addr",
 *         Subnetwork = subnet.Id,
 *         AddressType = "INTERNAL",
 *         IPAddress = "10.0.43.43",
 *         Region = "us-central1",
 *     });
 *     var address_test = new Gcp.NetworkManagement.ConnectivityTest("address-test", new()
 *     {
 *         Name = "conn-test-addr",
 *         Source = new Gcp.NetworkManagement.Inputs.ConnectivityTestSourceArgs
 *         {
 *             IpAddress = source_addr.IPAddress,
 *             ProjectId = source_addr.Project,
 *             Network = vpc.Id,
 *             NetworkType = "GCP_NETWORK",
 *         },
 *         Destination = new Gcp.NetworkManagement.Inputs.ConnectivityTestDestinationArgs
 *         {
 *             IpAddress = dest_addr.IPAddress,
 *             ProjectId = dest_addr.Project,
 *             Network = vpc.Id,
 *         },
 *         Protocol = "UDP",
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/networkmanagement"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		vpc, err := compute.NewNetwork(ctx, "vpc", &compute.NetworkArgs{
 * 			Name: pulumi.String("connectivity-vpc"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		subnet, err := compute.NewSubnetwork(ctx, "subnet", &compute.SubnetworkArgs{
 * 			Name:        pulumi.String("connectivity-vpc-subnet"),
 * 			IpCidrRange: pulumi.String("10.0.0.0/16"),
 * 			Region:      pulumi.String("us-central1"),
 * 			Network:     vpc.ID(),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = compute.NewAddress(ctx, "source-addr", &compute.AddressArgs{
 * 			Name:        pulumi.String("src-addr"),
 * 			Subnetwork:  subnet.ID(),
 * 			AddressType: pulumi.String("INTERNAL"),
 * 			Address:     pulumi.String("10.0.42.42"),
 * 			Region:      pulumi.String("us-central1"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = compute.NewAddress(ctx, "dest-addr", &compute.AddressArgs{
 * 			Name:        pulumi.String("dest-addr"),
 * 			Subnetwork:  subnet.ID(),
 * 			AddressType: pulumi.String("INTERNAL"),
 * 			Address:     pulumi.String("10.0.43.43"),
 * 			Region:      pulumi.String("us-central1"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = networkmanagement.NewConnectivityTest(ctx, "address-test", &networkmanagement.ConnectivityTestArgs{
 * 			Name: pulumi.String("conn-test-addr"),
 * 			Source: &networkmanagement.ConnectivityTestSourceArgs{
 * 				IpAddress:   source_addr.Address,
 * 				ProjectId:   source_addr.Project,
 * 				Network:     vpc.ID(),
 * 				NetworkType: pulumi.String("GCP_NETWORK"),
 * 			},
 * 			Destination: &networkmanagement.ConnectivityTestDestinationArgs{
 * 				IpAddress: dest_addr.Address,
 * 				ProjectId: dest_addr.Project,
 * 				Network:   vpc.ID(),
 * 			},
 * 			Protocol: pulumi.String("UDP"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		return nil
 * 	})
 * }
 * ```
 * ```java
 * package generated_program;
 * import com.pulumi.Context;
 * import com.pulumi.Pulumi;
 * import com.pulumi.core.Output;
 * import com.pulumi.gcp.compute.Network;
 * import com.pulumi.gcp.compute.NetworkArgs;
 * import com.pulumi.gcp.compute.Subnetwork;
 * import com.pulumi.gcp.compute.SubnetworkArgs;
 * import com.pulumi.gcp.compute.Address;
 * import com.pulumi.gcp.compute.AddressArgs;
 * import com.pulumi.gcp.networkmanagement.ConnectivityTest;
 * import com.pulumi.gcp.networkmanagement.ConnectivityTestArgs;
 * import com.pulumi.gcp.networkmanagement.inputs.ConnectivityTestSourceArgs;
 * import com.pulumi.gcp.networkmanagement.inputs.ConnectivityTestDestinationArgs;
 * 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 vpc = new Network("vpc", NetworkArgs.builder()
 *             .name("connectivity-vpc")
 *             .build());
 *         var subnet = new Subnetwork("subnet", SubnetworkArgs.builder()
 *             .name("connectivity-vpc-subnet")
 *             .ipCidrRange("10.0.0.0/16")
 *             .region("us-central1")
 *             .network(vpc.id())
 *             .build());
 *         var source_addr = new Address("source-addr", AddressArgs.builder()
 *             .name("src-addr")
 *             .subnetwork(subnet.id())
 *             .addressType("INTERNAL")
 *             .address("10.0.42.42")
 *             .region("us-central1")
 *             .build());
 *         var dest_addr = new Address("dest-addr", AddressArgs.builder()
 *             .name("dest-addr")
 *             .subnetwork(subnet.id())
 *             .addressType("INTERNAL")
 *             .address("10.0.43.43")
 *             .region("us-central1")
 *             .build());
 *         var address_test = new ConnectivityTest("address-test", ConnectivityTestArgs.builder()
 *             .name("conn-test-addr")
 *             .source(ConnectivityTestSourceArgs.builder()
 *                 .ipAddress(source_addr.address())
 *                 .projectId(source_addr.project())
 *                 .network(vpc.id())
 *                 .networkType("GCP_NETWORK")
 *                 .build())
 *             .destination(ConnectivityTestDestinationArgs.builder()
 *                 .ipAddress(dest_addr.address())
 *                 .projectId(dest_addr.project())
 *                 .network(vpc.id())
 *                 .build())
 *             .protocol("UDP")
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   address-test:
 *     type: gcp:networkmanagement:ConnectivityTest
 *     properties:
 *       name: conn-test-addr
 *       source:
 *         ipAddress: ${["source-addr"].address}
 *         projectId: ${["source-addr"].project}
 *         network: ${vpc.id}
 *         networkType: GCP_NETWORK
 *       destination:
 *         ipAddress: ${["dest-addr"].address}
 *         projectId: ${["dest-addr"].project}
 *         network: ${vpc.id}
 *       protocol: UDP
 *   vpc:
 *     type: gcp:compute:Network
 *     properties:
 *       name: connectivity-vpc
 *   subnet:
 *     type: gcp:compute:Subnetwork
 *     properties:
 *       name: connectivity-vpc-subnet
 *       ipCidrRange: 10.0.0.0/16
 *       region: us-central1
 *       network: ${vpc.id}
 *   source-addr:
 *     type: gcp:compute:Address
 *     properties:
 *       name: src-addr
 *       subnetwork: ${subnet.id}
 *       addressType: INTERNAL
 *       address: 10.0.42.42
 *       region: us-central1
 *   dest-addr:
 *     type: gcp:compute:Address
 *     properties:
 *       name: dest-addr
 *       subnetwork: ${subnet.id}
 *       addressType: INTERNAL
 *       address: 10.0.43.43
 *       region: us-central1
 * ```
 * 
 * ## Import
 * ConnectivityTest can be imported using any of these accepted formats:
 * * `projects/{{project}}/locations/global/connectivityTests/{{name}}`
 * * `{{project}}/{{name}}`
 * * `{{name}}`
 * When using the `pulumi import` command, ConnectivityTest can be imported using one of the formats above. For example:
 * ```sh
 * $ pulumi import gcp:networkmanagement/connectivityTest:ConnectivityTest default projects/{{project}}/locations/global/connectivityTests/{{name}}
 * ```
 * ```sh
 * $ pulumi import gcp:networkmanagement/connectivityTest:ConnectivityTest default {{project}}/{{name}}
 * ```
 * ```sh
 * $ pulumi import gcp:networkmanagement/connectivityTest:ConnectivityTest default {{name}}
 * ```
 * @property description The user-supplied description of the Connectivity Test. Maximum of 512 characters.
 * @property destination Required. Destination specification of the Connectivity Test.
 * You can use a combination of destination IP address, Compute
 * Engine VM instance, or VPC network to uniquely identify the
 * destination location.
 * Even if the destination IP address is not unique, the source IP
 * location is unique. Usually, the analysis can infer the destination
 * endpoint from route information.
 * If the destination you specify is a VM instance and the instance has
 * multiple network interfaces, then you must also specify either a
 * destination IP address or VPC network to identify the destination
 * interface.
 * A reachability analysis proceeds even if the destination location
 * is ambiguous. However, the result can include endpoints that you
 * don't intend to test.
 * Structure is documented below.
 * @property labels Resource labels to represent user-provided metadata. **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.
 * @property name Unique name for the connectivity test.
 * @property project
 * @property protocol IP Protocol of the test. When not provided, "TCP" is assumed.
 * @property relatedProjects Other projects that may be relevant for reachability analysis. This is applicable to scenarios where a test can cross
 * project boundaries.
 * @property source Required. Source specification of the Connectivity Test.
 * You can use a combination of source IP address, virtual machine
 * (VM) instance, or Compute Engine network to uniquely identify the
 * source location.
 * Examples: If the source IP address is an internal IP address within
 * a Google Cloud Virtual Private Cloud (VPC) network, then you must
 * also specify the VPC network. Otherwise, specify the VM instance,
 * which already contains its internal IP address and VPC network
 * information.
 * If the source of the test is within an on-premises network, then
 * you must provide the destination VPC network.
 * If the source endpoint is a Compute Engine VM instance with multiple
 * network interfaces, the instance itself is not sufficient to
 * identify the endpoint. So, you must also specify the source IP
 * address or VPC network.
 * A reachability analysis proceeds even if the source location is
 * ambiguous. However, the test result may include endpoints that
 * you don't intend to test.
 * Structure is documented below.
 */
public data class ConnectivityTestArgs(
    public val description: Output? = null,
    public val destination: Output? = null,
    public val labels: Output>? = null,
    public val name: Output? = null,
    public val project: Output? = null,
    public val protocol: Output? = null,
    public val relatedProjects: Output>? = null,
    public val source: Output? = null,
) : ConvertibleToJava {
    override fun toJava(): com.pulumi.gcp.networkmanagement.ConnectivityTestArgs =
        com.pulumi.gcp.networkmanagement.ConnectivityTestArgs.builder()
            .description(description?.applyValue({ args0 -> args0 }))
            .destination(destination?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
            .labels(labels?.applyValue({ args0 -> args0.map({ args0 -> args0.key.to(args0.value) }).toMap() }))
            .name(name?.applyValue({ args0 -> args0 }))
            .project(project?.applyValue({ args0 -> args0 }))
            .protocol(protocol?.applyValue({ args0 -> args0 }))
            .relatedProjects(relatedProjects?.applyValue({ args0 -> args0.map({ args0 -> args0 }) }))
            .source(source?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) })).build()
}

/**
 * Builder for [ConnectivityTestArgs].
 */
@PulumiTagMarker
public class ConnectivityTestArgsBuilder internal constructor() {
    private var description: Output? = null

    private var destination: Output? = null

    private var labels: Output>? = null

    private var name: Output? = null

    private var project: Output? = null

    private var protocol: Output? = null

    private var relatedProjects: Output>? = null

    private var source: Output? = null

    /**
     * @param value The user-supplied description of the Connectivity Test. Maximum of 512 characters.
     */
    @JvmName("bfwipfryueqhstia")
    public suspend fun description(`value`: Output) {
        this.description = value
    }

    /**
     * @param value Required. Destination specification of the Connectivity Test.
     * You can use a combination of destination IP address, Compute
     * Engine VM instance, or VPC network to uniquely identify the
     * destination location.
     * Even if the destination IP address is not unique, the source IP
     * location is unique. Usually, the analysis can infer the destination
     * endpoint from route information.
     * If the destination you specify is a VM instance and the instance has
     * multiple network interfaces, then you must also specify either a
     * destination IP address or VPC network to identify the destination
     * interface.
     * A reachability analysis proceeds even if the destination location
     * is ambiguous. However, the result can include endpoints that you
     * don't intend to test.
     * Structure is documented below.
     */
    @JvmName("ypvxqxkvjgpbvqwe")
    public suspend fun destination(`value`: Output) {
        this.destination = value
    }

    /**
     * @param value Resource labels to represent user-provided metadata. **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.
     */
    @JvmName("nrwhiatfddkaljcl")
    public suspend fun labels(`value`: Output>) {
        this.labels = value
    }

    /**
     * @param value Unique name for the connectivity test.
     */
    @JvmName("iogxtskmpkawissj")
    public suspend fun name(`value`: Output) {
        this.name = value
    }

    /**
     * @param value
     */
    @JvmName("nbbfpliyklubfmdt")
    public suspend fun project(`value`: Output) {
        this.project = value
    }

    /**
     * @param value IP Protocol of the test. When not provided, "TCP" is assumed.
     */
    @JvmName("yabktyhqvxkccdlt")
    public suspend fun protocol(`value`: Output) {
        this.protocol = value
    }

    /**
     * @param value Other projects that may be relevant for reachability analysis. This is applicable to scenarios where a test can cross
     * project boundaries.
     */
    @JvmName("kmpxmvnudsemebrv")
    public suspend fun relatedProjects(`value`: Output>) {
        this.relatedProjects = value
    }

    @JvmName("xjscfvwuwfryycrl")
    public suspend fun relatedProjects(vararg values: Output) {
        this.relatedProjects = Output.all(values.asList())
    }

    /**
     * @param values Other projects that may be relevant for reachability analysis. This is applicable to scenarios where a test can cross
     * project boundaries.
     */
    @JvmName("ciggqdukyuuoxxvn")
    public suspend fun relatedProjects(values: List>) {
        this.relatedProjects = Output.all(values)
    }

    /**
     * @param value Required. Source specification of the Connectivity Test.
     * You can use a combination of source IP address, virtual machine
     * (VM) instance, or Compute Engine network to uniquely identify the
     * source location.
     * Examples: If the source IP address is an internal IP address within
     * a Google Cloud Virtual Private Cloud (VPC) network, then you must
     * also specify the VPC network. Otherwise, specify the VM instance,
     * which already contains its internal IP address and VPC network
     * information.
     * If the source of the test is within an on-premises network, then
     * you must provide the destination VPC network.
     * If the source endpoint is a Compute Engine VM instance with multiple
     * network interfaces, the instance itself is not sufficient to
     * identify the endpoint. So, you must also specify the source IP
     * address or VPC network.
     * A reachability analysis proceeds even if the source location is
     * ambiguous. However, the test result may include endpoints that
     * you don't intend to test.
     * Structure is documented below.
     */
    @JvmName("pkhvdjsflhdqffdw")
    public suspend fun source(`value`: Output) {
        this.source = value
    }

    /**
     * @param value The user-supplied description of the Connectivity Test. Maximum of 512 characters.
     */
    @JvmName("mourxyupjeulrnui")
    public suspend fun description(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.description = mapped
    }

    /**
     * @param value Required. Destination specification of the Connectivity Test.
     * You can use a combination of destination IP address, Compute
     * Engine VM instance, or VPC network to uniquely identify the
     * destination location.
     * Even if the destination IP address is not unique, the source IP
     * location is unique. Usually, the analysis can infer the destination
     * endpoint from route information.
     * If the destination you specify is a VM instance and the instance has
     * multiple network interfaces, then you must also specify either a
     * destination IP address or VPC network to identify the destination
     * interface.
     * A reachability analysis proceeds even if the destination location
     * is ambiguous. However, the result can include endpoints that you
     * don't intend to test.
     * Structure is documented below.
     */
    @JvmName("tiorstegxmobyqnw")
    public suspend fun destination(`value`: ConnectivityTestDestinationArgs?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.destination = mapped
    }

    /**
     * @param argument Required. Destination specification of the Connectivity Test.
     * You can use a combination of destination IP address, Compute
     * Engine VM instance, or VPC network to uniquely identify the
     * destination location.
     * Even if the destination IP address is not unique, the source IP
     * location is unique. Usually, the analysis can infer the destination
     * endpoint from route information.
     * If the destination you specify is a VM instance and the instance has
     * multiple network interfaces, then you must also specify either a
     * destination IP address or VPC network to identify the destination
     * interface.
     * A reachability analysis proceeds even if the destination location
     * is ambiguous. However, the result can include endpoints that you
     * don't intend to test.
     * Structure is documented below.
     */
    @JvmName("ydfqlnmhqtsgukkm")
    public suspend fun destination(argument: suspend ConnectivityTestDestinationArgsBuilder.() -> Unit) {
        val toBeMapped = ConnectivityTestDestinationArgsBuilder().applySuspend { argument() }.build()
        val mapped = of(toBeMapped)
        this.destination = mapped
    }

    /**
     * @param value Resource labels to represent user-provided metadata. **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.
     */
    @JvmName("jueagfxgksdpprdf")
    public suspend fun labels(`value`: Map?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.labels = mapped
    }

    /**
     * @param values Resource labels to represent user-provided metadata. **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.
     */
    @JvmName("vtqmdlidwyhqginv")
    public fun labels(vararg values: Pair) {
        val toBeMapped = values.toMap()
        val mapped = toBeMapped.let({ args0 -> of(args0) })
        this.labels = mapped
    }

    /**
     * @param value Unique name for the connectivity test.
     */
    @JvmName("qcfdfaylfolesipy")
    public suspend fun name(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.name = mapped
    }

    /**
     * @param value
     */
    @JvmName("ulqdhqmfrknwstyi")
    public suspend fun project(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.project = mapped
    }

    /**
     * @param value IP Protocol of the test. When not provided, "TCP" is assumed.
     */
    @JvmName("rlxxoikimajsxrrl")
    public suspend fun protocol(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.protocol = mapped
    }

    /**
     * @param value Other projects that may be relevant for reachability analysis. This is applicable to scenarios where a test can cross
     * project boundaries.
     */
    @JvmName("cwjgegebmpuxelmj")
    public suspend fun relatedProjects(`value`: List?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.relatedProjects = mapped
    }

    /**
     * @param values Other projects that may be relevant for reachability analysis. This is applicable to scenarios where a test can cross
     * project boundaries.
     */
    @JvmName("ccuxyqjbanctmlmc")
    public suspend fun relatedProjects(vararg values: String) {
        val toBeMapped = values.toList()
        val mapped = toBeMapped.let({ args0 -> of(args0) })
        this.relatedProjects = mapped
    }

    /**
     * @param value Required. Source specification of the Connectivity Test.
     * You can use a combination of source IP address, virtual machine
     * (VM) instance, or Compute Engine network to uniquely identify the
     * source location.
     * Examples: If the source IP address is an internal IP address within
     * a Google Cloud Virtual Private Cloud (VPC) network, then you must
     * also specify the VPC network. Otherwise, specify the VM instance,
     * which already contains its internal IP address and VPC network
     * information.
     * If the source of the test is within an on-premises network, then
     * you must provide the destination VPC network.
     * If the source endpoint is a Compute Engine VM instance with multiple
     * network interfaces, the instance itself is not sufficient to
     * identify the endpoint. So, you must also specify the source IP
     * address or VPC network.
     * A reachability analysis proceeds even if the source location is
     * ambiguous. However, the test result may include endpoints that
     * you don't intend to test.
     * Structure is documented below.
     */
    @JvmName("frqldknqxdbanyqj")
    public suspend fun source(`value`: ConnectivityTestSourceArgs?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.source = mapped
    }

    /**
     * @param argument Required. Source specification of the Connectivity Test.
     * You can use a combination of source IP address, virtual machine
     * (VM) instance, or Compute Engine network to uniquely identify the
     * source location.
     * Examples: If the source IP address is an internal IP address within
     * a Google Cloud Virtual Private Cloud (VPC) network, then you must
     * also specify the VPC network. Otherwise, specify the VM instance,
     * which already contains its internal IP address and VPC network
     * information.
     * If the source of the test is within an on-premises network, then
     * you must provide the destination VPC network.
     * If the source endpoint is a Compute Engine VM instance with multiple
     * network interfaces, the instance itself is not sufficient to
     * identify the endpoint. So, you must also specify the source IP
     * address or VPC network.
     * A reachability analysis proceeds even if the source location is
     * ambiguous. However, the test result may include endpoints that
     * you don't intend to test.
     * Structure is documented below.
     */
    @JvmName("jqqpohvdokbdtxhe")
    public suspend fun source(argument: suspend ConnectivityTestSourceArgsBuilder.() -> Unit) {
        val toBeMapped = ConnectivityTestSourceArgsBuilder().applySuspend { argument() }.build()
        val mapped = of(toBeMapped)
        this.source = mapped
    }

    internal fun build(): ConnectivityTestArgs = ConnectivityTestArgs(
        description = description,
        destination = destination,
        labels = labels,
        name = name,
        project = project,
        protocol = protocol,
        relatedProjects = relatedProjects,
        source = source,
    )
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy