import * as pulumi from "@pulumi/pulumi"; /** * A Network endpoint represents a IP address and port combination that is * part of a specific network endpoint group (NEG). NEGs are zonal * collections of these endpoints for GCP resources within a * single subnet. **NOTE**: Network endpoints cannot be created outside of a * network endpoint group. * * > **NOTE** In case the Endpoint's Instance is recreated, it's needed to * perform `apply` twice. To avoid situations like this, please use this resource * with the lifecycle `replaceTriggeredBy` method, with the passed Instance's ID. * * To get more information about NetworkEndpoint, see: * * * [API documentation](https://cloud.google.com/compute/docs/reference/rest/beta/networkEndpointGroups) * * How-to Guides * * [Official Documentation](https://cloud.google.com/load-balancing/docs/negs/) * * ## Example Usage * * ### Network Endpoint * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const myImage = gcp.compute.getImage({ * family: "debian-11", * project: "debian-cloud", * }); * const _default = new gcp.compute.Network("default", { * name: "neg-network", * autoCreateSubnetworks: false, * }); * const defaultSubnetwork = new gcp.compute.Subnetwork("default", { * name: "neg-subnetwork", * ipCidrRange: "10.0.0.1/16", * region: "us-central1", * network: _default.id, * }); * const endpoint_instance = new gcp.compute.Instance("endpoint-instance", { * networkInterfaces: [{ * accessConfigs: [{}], * subnetwork: defaultSubnetwork.id, * }], * name: "endpoint-instance", * machineType: "e2-medium", * bootDisk: { * initializeParams: { * image: myImage.then(myImage => myImage.selfLink), * }, * }, * }); * const default_endpoint = new gcp.compute.NetworkEndpoint("default-endpoint", { * networkEndpointGroup: neg.name, * instance: endpoint_instance.name, * port: neg.defaultPort, * ipAddress: endpoint_instance.networkInterfaces.apply(networkInterfaces => networkInterfaces[0].networkIp), * }); * const group = new gcp.compute.NetworkEndpointGroup("group", { * name: "my-lb-neg", * network: _default.id, * subnetwork: defaultSubnetwork.id, * defaultPort: 90, * zone: "us-central1-a", * }); * ``` * * ## Import * * NetworkEndpoint can be imported using any of these accepted formats: * * * `projects/{{project}}/zones/{{zone}}/networkEndpointGroups/{{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}}` * * * `{{project}}/{{zone}}/{{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}}` * * * `{{zone}}/{{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}}` * * * `{{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}}` * * When using the `pulumi import` command, NetworkEndpoint can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:compute/networkEndpoint:NetworkEndpoint default projects/{{project}}/zones/{{zone}}/networkEndpointGroups/{{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}} * ``` * * ```sh * $ pulumi import gcp:compute/networkEndpoint:NetworkEndpoint default {{project}}/{{zone}}/{{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}} * ``` * * ```sh * $ pulumi import gcp:compute/networkEndpoint:NetworkEndpoint default {{zone}}/{{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}} * ``` * * ```sh * $ pulumi import gcp:compute/networkEndpoint:NetworkEndpoint default {{network_endpoint_group}}/{{instance}}/{{ip_address}}/{{port}} * ``` */ export declare class NetworkEndpoint extends pulumi.CustomResource { /** * Get an existing NetworkEndpoint resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: NetworkEndpointState, opts?: pulumi.CustomResourceOptions): NetworkEndpoint; /** * Returns true if the given object is an instance of NetworkEndpoint. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is NetworkEndpoint; /** * The name for a specific VM instance that the IP address belongs to. * This is required for network endpoints of type GCE_VM_IP_PORT. * The instance must be in the same zone of network endpoint group. */ readonly instance: pulumi.Output; /** * IPv4 address of network endpoint. The IP address must belong * to a VM in GCE (either the primary IP or as part of an aliased IP * range). */ readonly ipAddress: pulumi.Output; /** * The network endpoint group this endpoint is part of. * * * - - - */ readonly networkEndpointGroup: pulumi.Output; /** * Port number of network endpoint. * **Note** `port` is required unless the Network Endpoint Group is created * with the type of `GCE_VM_IP` */ readonly port: pulumi.Output; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ readonly project: pulumi.Output; /** * Zone where the containing network endpoint group is located. */ readonly zone: pulumi.Output; /** * Create a NetworkEndpoint resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: NetworkEndpointArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering NetworkEndpoint resources. */ export interface NetworkEndpointState { /** * The name for a specific VM instance that the IP address belongs to. * This is required for network endpoints of type GCE_VM_IP_PORT. * The instance must be in the same zone of network endpoint group. */ instance?: pulumi.Input; /** * IPv4 address of network endpoint. The IP address must belong * to a VM in GCE (either the primary IP or as part of an aliased IP * range). */ ipAddress?: pulumi.Input; /** * The network endpoint group this endpoint is part of. * * * - - - */ networkEndpointGroup?: pulumi.Input; /** * Port number of network endpoint. * **Note** `port` is required unless the Network Endpoint Group is created * with the type of `GCE_VM_IP` */ port?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * Zone where the containing network endpoint group is located. */ zone?: pulumi.Input; } /** * The set of arguments for constructing a NetworkEndpoint resource. */ export interface NetworkEndpointArgs { /** * The name for a specific VM instance that the IP address belongs to. * This is required for network endpoints of type GCE_VM_IP_PORT. * The instance must be in the same zone of network endpoint group. */ instance?: pulumi.Input; /** * IPv4 address of network endpoint. The IP address must belong * to a VM in GCE (either the primary IP or as part of an aliased IP * range). */ ipAddress: pulumi.Input; /** * The network endpoint group this endpoint is part of. * * * - - - */ networkEndpointGroup: pulumi.Input; /** * Port number of network endpoint. * **Note** `port` is required unless the Network Endpoint Group is created * with the type of `GCE_VM_IP` */ port?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * Zone where the containing network endpoint group is located. */ zone?: pulumi.Input; }