import * as pulumi from "@pulumi/pulumi"; /** * Manages a private VPC connection with a GCP service provider. For more information see * [the official documentation](https://cloud.google.com/vpc/docs/configure-private-services-access#creating-connection) * and * [API](https://cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.connections). * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * // Create a VPC network * const peeringNetwork = new gcp.compute.Network("peering_network", {name: "peering-network"}); * // Create an IP address * const privateIpAlloc = new gcp.compute.GlobalAddress("private_ip_alloc", { * name: "private-ip-alloc", * purpose: "VPC_PEERING", * addressType: "INTERNAL", * prefixLength: 16, * network: peeringNetwork.id, * }); * // Create a private connection * const _default = new gcp.servicenetworking.Connection("default", { * network: peeringNetwork.id, * service: "servicenetworking.googleapis.com", * reservedPeeringRanges: [privateIpAlloc.name], * }); * // (Optional) Import or export custom routes * const peeringRoutes = new gcp.compute.NetworkPeeringRoutesConfig("peering_routes", { * peering: _default.peering, * network: peeringNetwork.name, * importCustomRoutes: true, * exportCustomRoutes: true, * }); * ``` * * ## Import * * ServiceNetworkingConnection can be imported using any of these accepted formats * * * `{{peering-network}}:{{service}}` * * `projects/{{project}}/global/networks/{{peering-network}}:{{service}}` * * When using the `pulumi import` command, NAME_HERE can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:servicenetworking/connection:Connection default {{peering-network}}:{{service}} * $ pulumi import gcp:servicenetworking/connection:Connection default /projects/{{project}}/global/networks/{{peering-network}}:{{service}} * ``` */ export declare class Connection extends pulumi.CustomResource { /** * Get an existing Connection 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?: ConnectionState, opts?: pulumi.CustomResourceOptions): Connection; /** * Returns true if the given object is an instance of Connection. 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 Connection; /** * The deletion policy for the service networking connection. Setting to ABANDON allows the resource to be abandoned rather than deleted. This will enable a successful pulumi destroy when destroying CloudSQL instances. Use with care as it can lead to dangling resources. */ readonly deletionPolicy: pulumi.Output; /** * Name of VPC network connected with service producers using VPC peering. */ readonly network: pulumi.Output; /** * (Computed) The name of the VPC Network Peering connection that was created by the service producer. */ readonly peering: pulumi.Output; /** * Named IP address range(s) of PEERING type reserved for * this service provider. Note that invoking this method with a different range when connection * is already established will not reallocate already provisioned service producer subnetworks. */ readonly reservedPeeringRanges: pulumi.Output; /** * Provider peering service that is managing peering connectivity for a * service provider organization. For Google services that support this functionality it is * 'servicenetworking.googleapis.com'. */ readonly service: pulumi.Output; /** * When set to true, enforce an update of the reserved peering ranges on the existing service networking connection in case of a new connection creation failure. */ readonly updateOnCreationFail: pulumi.Output; /** * Create a Connection 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: ConnectionArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering Connection resources. */ export interface ConnectionState { /** * The deletion policy for the service networking connection. Setting to ABANDON allows the resource to be abandoned rather than deleted. This will enable a successful pulumi destroy when destroying CloudSQL instances. Use with care as it can lead to dangling resources. */ deletionPolicy?: pulumi.Input; /** * Name of VPC network connected with service producers using VPC peering. */ network?: pulumi.Input; /** * (Computed) The name of the VPC Network Peering connection that was created by the service producer. */ peering?: pulumi.Input; /** * Named IP address range(s) of PEERING type reserved for * this service provider. Note that invoking this method with a different range when connection * is already established will not reallocate already provisioned service producer subnetworks. */ reservedPeeringRanges?: pulumi.Input[]>; /** * Provider peering service that is managing peering connectivity for a * service provider organization. For Google services that support this functionality it is * 'servicenetworking.googleapis.com'. */ service?: pulumi.Input; /** * When set to true, enforce an update of the reserved peering ranges on the existing service networking connection in case of a new connection creation failure. */ updateOnCreationFail?: pulumi.Input; } /** * The set of arguments for constructing a Connection resource. */ export interface ConnectionArgs { /** * The deletion policy for the service networking connection. Setting to ABANDON allows the resource to be abandoned rather than deleted. This will enable a successful pulumi destroy when destroying CloudSQL instances. Use with care as it can lead to dangling resources. */ deletionPolicy?: pulumi.Input; /** * Name of VPC network connected with service producers using VPC peering. */ network: pulumi.Input; /** * Named IP address range(s) of PEERING type reserved for * this service provider. Note that invoking this method with a different range when connection * is already established will not reallocate already provisioned service producer subnetworks. */ reservedPeeringRanges: pulumi.Input[]>; /** * Provider peering service that is managing peering connectivity for a * service provider organization. For Google services that support this functionality it is * 'servicenetworking.googleapis.com'. */ service: pulumi.Input; /** * When set to true, enforce an update of the reserved peering ranges on the existing service networking connection in case of a new connection creation failure. */ updateOnCreationFail?: pulumi.Input; }