@pulumi/gcp
Version:
A Pulumi package for creating and managing Google Cloud Platform resources.
212 lines (211 loc) • 7.98 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
/**
* Manage a network peering's route settings without managing the peering as
* a whole. This resource is primarily intended for use with GCP-generated
* peerings that shouldn't otherwise be managed by other tools. Deleting this
* resource is a no-op and the peering will not be modified.
*
* To get more information about NetworkPeeringRoutesConfig, see:
*
* * [API documentation](https://cloud.google.com/compute/docs/reference/rest/v1/networks/updatePeering)
* * How-to Guides
* * [Official Documentation](https://cloud.google.com/vpc/docs/vpc-peering)
*
* ## Example Usage
*
* ### Network Peering Routes Config Basic
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gcp from "@pulumi/gcp";
*
* const networkPrimary = new gcp.compute.Network("network_primary", {
* name: "primary-network",
* autoCreateSubnetworks: false,
* });
* const networkSecondary = new gcp.compute.Network("network_secondary", {
* name: "secondary-network",
* autoCreateSubnetworks: false,
* });
* const peeringPrimary = new gcp.compute.NetworkPeering("peering_primary", {
* name: "primary-peering",
* network: networkPrimary.id,
* peerNetwork: networkSecondary.id,
* importCustomRoutes: true,
* exportCustomRoutes: true,
* importSubnetRoutesWithPublicIp: true,
* exportSubnetRoutesWithPublicIp: true,
* });
* const peeringPrimaryRoutes = new gcp.compute.NetworkPeeringRoutesConfig("peering_primary_routes", {
* peering: peeringPrimary.name,
* network: networkPrimary.name,
* importCustomRoutes: true,
* exportCustomRoutes: true,
* importSubnetRoutesWithPublicIp: true,
* exportSubnetRoutesWithPublicIp: true,
* });
* const peeringSecondary = new gcp.compute.NetworkPeering("peering_secondary", {
* name: "secondary-peering",
* network: networkSecondary.id,
* peerNetwork: networkPrimary.id,
* });
* ```
*
* ## Import
*
* NetworkPeeringRoutesConfig can be imported using any of these accepted formats:
*
* * `projects/{{project}}/global/networks/{{network}}/networkPeerings/{{peering}}`
*
* * `{{project}}/{{network}}/{{peering}}`
*
* * `{{network}}/{{peering}}`
*
* When using the `pulumi import` command, NetworkPeeringRoutesConfig can be imported using one of the formats above. For example:
*
* ```sh
* $ pulumi import gcp:compute/networkPeeringRoutesConfig:NetworkPeeringRoutesConfig default projects/{{project}}/global/networks/{{network}}/networkPeerings/{{peering}}
* ```
*
* ```sh
* $ pulumi import gcp:compute/networkPeeringRoutesConfig:NetworkPeeringRoutesConfig default {{project}}/{{network}}/{{peering}}
* ```
*
* ```sh
* $ pulumi import gcp:compute/networkPeeringRoutesConfig:NetworkPeeringRoutesConfig default {{network}}/{{peering}}
* ```
*/
export declare class NetworkPeeringRoutesConfig extends pulumi.CustomResource {
/**
* Get an existing NetworkPeeringRoutesConfig 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<pulumi.ID>, state?: NetworkPeeringRoutesConfigState, opts?: pulumi.CustomResourceOptions): NetworkPeeringRoutesConfig;
/**
* Returns true if the given object is an instance of NetworkPeeringRoutesConfig. 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 NetworkPeeringRoutesConfig;
/**
* Whether to export the custom routes to the peer network.
*/
readonly exportCustomRoutes: pulumi.Output<boolean>;
/**
* Whether subnet routes with public IP range are exported.
* IPv4 special-use ranges are always exported to peers and
* are not controlled by this field.
*/
readonly exportSubnetRoutesWithPublicIp: pulumi.Output<boolean>;
/**
* Whether to import the custom routes to the peer network.
*/
readonly importCustomRoutes: pulumi.Output<boolean>;
/**
* Whether subnet routes with public IP range are imported.
* IPv4 special-use ranges are always imported from peers and
* are not controlled by this field.
*/
readonly importSubnetRoutesWithPublicIp: pulumi.Output<boolean>;
/**
* The name of the primary network for the peering.
*/
readonly network: pulumi.Output<string>;
/**
* Name of the peering.
*/
readonly peering: pulumi.Output<string>;
/**
* The ID of the project in which the resource belongs.
* If it is not provided, the provider project is used.
*/
readonly project: pulumi.Output<string>;
/**
* Create a NetworkPeeringRoutesConfig 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: NetworkPeeringRoutesConfigArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering NetworkPeeringRoutesConfig resources.
*/
export interface NetworkPeeringRoutesConfigState {
/**
* Whether to export the custom routes to the peer network.
*/
exportCustomRoutes?: pulumi.Input<boolean>;
/**
* Whether subnet routes with public IP range are exported.
* IPv4 special-use ranges are always exported to peers and
* are not controlled by this field.
*/
exportSubnetRoutesWithPublicIp?: pulumi.Input<boolean>;
/**
* Whether to import the custom routes to the peer network.
*/
importCustomRoutes?: pulumi.Input<boolean>;
/**
* Whether subnet routes with public IP range are imported.
* IPv4 special-use ranges are always imported from peers and
* are not controlled by this field.
*/
importSubnetRoutesWithPublicIp?: pulumi.Input<boolean>;
/**
* The name of the primary network for the peering.
*/
network?: pulumi.Input<string>;
/**
* Name of the peering.
*/
peering?: pulumi.Input<string>;
/**
* The ID of the project in which the resource belongs.
* If it is not provided, the provider project is used.
*/
project?: pulumi.Input<string>;
}
/**
* The set of arguments for constructing a NetworkPeeringRoutesConfig resource.
*/
export interface NetworkPeeringRoutesConfigArgs {
/**
* Whether to export the custom routes to the peer network.
*/
exportCustomRoutes: pulumi.Input<boolean>;
/**
* Whether subnet routes with public IP range are exported.
* IPv4 special-use ranges are always exported to peers and
* are not controlled by this field.
*/
exportSubnetRoutesWithPublicIp?: pulumi.Input<boolean>;
/**
* Whether to import the custom routes to the peer network.
*/
importCustomRoutes: pulumi.Input<boolean>;
/**
* Whether subnet routes with public IP range are imported.
* IPv4 special-use ranges are always imported from peers and
* are not controlled by this field.
*/
importSubnetRoutesWithPublicIp?: pulumi.Input<boolean>;
/**
* The name of the primary network for the peering.
*/
network: pulumi.Input<string>;
/**
* Name of the peering.
*/
peering: pulumi.Input<string>;
/**
* The ID of the project in which the resource belongs.
* If it is not provided, the provider project is used.
*/
project?: pulumi.Input<string>;
}