published on Thursday, Jul 9, 2026 by pulumiverse
published on Thursday, Jul 9, 2026 by pulumiverse
Gets information about a VPC ingress rule.
An ingress routing rule routes incoming traffic from a peered VPC to a specific private IP address within a destination VPC’s Private Network.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";
// Retrieve a VPC ingress rule by filters
const byPn = scaleway.network.getIngressRule({
nexthopPrivateNetworkId: "fr-par/11111111-1111-1111-1111-111111111111",
});
import pulumi
import pulumi_scaleway as scaleway
# Retrieve a VPC ingress rule by filters
by_pn = scaleway.network.get_ingress_rule(nexthop_private_network_id="fr-par/11111111-1111-1111-1111-111111111111")
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// Retrieve a VPC ingress rule by filters
_, err := network.LookupIngressRule(ctx, &network.LookupIngressRuleArgs{
NexthopPrivateNetworkId: pulumi.StringRef("fr-par/11111111-1111-1111-1111-111111111111"),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;
return await Deployment.RunAsync(() =>
{
// Retrieve a VPC ingress rule by filters
var byPn = Scaleway.Network.GetIngressRule.Invoke(new()
{
NexthopPrivateNetworkId = "fr-par/11111111-1111-1111-1111-111111111111",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.network.NetworkFunctions;
import com.pulumi.scaleway.network.inputs.GetIngressRuleArgs;
import java.util.ArrayList;
import java.util.Arrays;
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) {
// Retrieve a VPC ingress rule by filters
final var byPn = NetworkFunctions.getIngressRule(GetIngressRuleArgs.builder()
.nexthopPrivateNetworkId("fr-par/11111111-1111-1111-1111-111111111111")
.build());
}
}
variables:
# Retrieve a VPC ingress rule by filters
byPn:
fn::invoke:
function: scaleway:network:getIngressRule
arguments:
nexthopPrivateNetworkId: fr-par/11111111-1111-1111-1111-111111111111
Example coming soon!
import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";
// Retrieve a VPC ingress rule by its ID
const byId = scaleway.network.getIngressRule({
ingressRuleId: "fr-par/11111111-1111-1111-1111-111111111111",
});
import pulumi
import pulumi_scaleway as scaleway
# Retrieve a VPC ingress rule by its ID
by_id = scaleway.network.get_ingress_rule(ingress_rule_id="fr-par/11111111-1111-1111-1111-111111111111")
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// Retrieve a VPC ingress rule by its ID
_, err := network.LookupIngressRule(ctx, &network.LookupIngressRuleArgs{
IngressRuleId: pulumi.StringRef("fr-par/11111111-1111-1111-1111-111111111111"),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;
return await Deployment.RunAsync(() =>
{
// Retrieve a VPC ingress rule by its ID
var byId = Scaleway.Network.GetIngressRule.Invoke(new()
{
IngressRuleId = "fr-par/11111111-1111-1111-1111-111111111111",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.network.NetworkFunctions;
import com.pulumi.scaleway.network.inputs.GetIngressRuleArgs;
import java.util.ArrayList;
import java.util.Arrays;
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) {
// Retrieve a VPC ingress rule by its ID
final var byId = NetworkFunctions.getIngressRule(GetIngressRuleArgs.builder()
.ingressRuleId("fr-par/11111111-1111-1111-1111-111111111111")
.build());
}
}
variables:
# Retrieve a VPC ingress rule by its ID
byId:
fn::invoke:
function: scaleway:network:getIngressRule
arguments:
ingressRuleId: fr-par/11111111-1111-1111-1111-111111111111
Example coming soon!
Using getIngressRule
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getIngressRule(args: GetIngressRuleArgs, opts?: InvokeOptions): Promise<GetIngressRuleResult>
function getIngressRuleOutput(args: GetIngressRuleOutputArgs, opts?: InvokeOptions): Output<GetIngressRuleResult>def get_ingress_rule(ingress_rule_id: Optional[str] = None,
is_ipv6: Optional[bool] = None,
nexthop_private_network_id: Optional[str] = None,
nexthop_resource_ip: Optional[str] = None,
region: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
vpc_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetIngressRuleResult
def get_ingress_rule_output(ingress_rule_id: pulumi.Input[Optional[str]] = None,
is_ipv6: pulumi.Input[Optional[bool]] = None,
nexthop_private_network_id: pulumi.Input[Optional[str]] = None,
nexthop_resource_ip: pulumi.Input[Optional[str]] = None,
region: pulumi.Input[Optional[str]] = None,
tags: pulumi.Input[Optional[Sequence[pulumi.Input[str]]]] = None,
vpc_id: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetIngressRuleResult]func LookupIngressRule(ctx *Context, args *LookupIngressRuleArgs, opts ...InvokeOption) (*LookupIngressRuleResult, error)
func LookupIngressRuleOutput(ctx *Context, args *LookupIngressRuleOutputArgs, opts ...InvokeOption) LookupIngressRuleResultOutput> Note: This function is named LookupIngressRule in the Go SDK.
public static class GetIngressRule
{
public static Task<GetIngressRuleResult> InvokeAsync(GetIngressRuleArgs args, InvokeOptions? opts = null)
public static Output<GetIngressRuleResult> Invoke(GetIngressRuleInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetIngressRuleResult> getIngressRule(GetIngressRuleArgs args, InvokeOptions options)
public static Output<GetIngressRuleResult> getIngressRule(GetIngressRuleArgs args, InvokeOptions options)
fn::invoke:
function: scaleway:network/getIngressRule:getIngressRule
arguments:
# arguments dictionarydata "scaleway_network_getingressrule" "name" {
# arguments
}The following arguments are supported:
- Ingress
Rule stringId The ID of the VPC ingress rule. Conflicts with all filter arguments below.
The following arguments can be used to look up a VPC ingress rule via the list API. They all conflict with
ingressRuleId:- Is
Ipv6 bool - Only ingress rules with the matching IP version will be returned.
- Nexthop
Private stringNetwork Id - The nexthop private network ID to filter for.
- Nexthop
Resource stringIp - The nexthop resource IP to filter for.
- Region string
region) The region in which the ingress rule exists.- List<string>
- List of tags to filter for.
- Vpc
Id string - The VPC ID to filter for.
- Ingress
Rule stringId The ID of the VPC ingress rule. Conflicts with all filter arguments below.
The following arguments can be used to look up a VPC ingress rule via the list API. They all conflict with
ingressRuleId:- Is
Ipv6 bool - Only ingress rules with the matching IP version will be returned.
- Nexthop
Private stringNetwork Id - The nexthop private network ID to filter for.
- Nexthop
Resource stringIp - The nexthop resource IP to filter for.
- Region string
region) The region in which the ingress rule exists.- []string
- List of tags to filter for.
- Vpc
Id string - The VPC ID to filter for.
- ingress_
rule_ stringid The ID of the VPC ingress rule. Conflicts with all filter arguments below.
The following arguments can be used to look up a VPC ingress rule via the list API. They all conflict with
ingressRuleId:- is_
ipv6 bool - Only ingress rules with the matching IP version will be returned.
- nexthop_
private_ stringnetwork_ id - The nexthop private network ID to filter for.
- nexthop_
resource_ stringip - The nexthop resource IP to filter for.
- region string
region) The region in which the ingress rule exists.- list(string)
- List of tags to filter for.
- vpc_
id string - The VPC ID to filter for.
- ingress
Rule StringId The ID of the VPC ingress rule. Conflicts with all filter arguments below.
The following arguments can be used to look up a VPC ingress rule via the list API. They all conflict with
ingressRuleId:- is
Ipv6 Boolean - Only ingress rules with the matching IP version will be returned.
- nexthop
Private StringNetwork Id - The nexthop private network ID to filter for.
- nexthop
Resource StringIp - The nexthop resource IP to filter for.
- region String
region) The region in which the ingress rule exists.- List<String>
- List of tags to filter for.
- vpc
Id String - The VPC ID to filter for.
- ingress
Rule stringId The ID of the VPC ingress rule. Conflicts with all filter arguments below.
The following arguments can be used to look up a VPC ingress rule via the list API. They all conflict with
ingressRuleId:- is
Ipv6 boolean - Only ingress rules with the matching IP version will be returned.
- nexthop
Private stringNetwork Id - The nexthop private network ID to filter for.
- nexthop
Resource stringIp - The nexthop resource IP to filter for.
- region string
region) The region in which the ingress rule exists.- string[]
- List of tags to filter for.
- vpc
Id string - The VPC ID to filter for.
- ingress_
rule_ strid The ID of the VPC ingress rule. Conflicts with all filter arguments below.
The following arguments can be used to look up a VPC ingress rule via the list API. They all conflict with
ingressRuleId:- is_
ipv6 bool - Only ingress rules with the matching IP version will be returned.
- nexthop_
private_ strnetwork_ id - The nexthop private network ID to filter for.
- nexthop_
resource_ strip - The nexthop resource IP to filter for.
- region str
region) The region in which the ingress rule exists.- Sequence[str]
- List of tags to filter for.
- vpc_
id str - The VPC ID to filter for.
- ingress
Rule StringId The ID of the VPC ingress rule. Conflicts with all filter arguments below.
The following arguments can be used to look up a VPC ingress rule via the list API. They all conflict with
ingressRuleId:- is
Ipv6 Boolean - Only ingress rules with the matching IP version will be returned.
- nexthop
Private StringNetwork Id - The nexthop private network ID to filter for.
- nexthop
Resource StringIp - The nexthop resource IP to filter for.
- region String
region) The region in which the ingress rule exists.- List<String>
- List of tags to filter for.
- vpc
Id String - The VPC ID to filter for.
getIngressRule Result
The following output properties are available:
- Created
At string - Description string
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Ipv6 bool - Source string
- Updated
At string - Ingress
Rule stringId - Nexthop
Private stringNetwork Id - Nexthop
Resource stringIp - Region string
- List<string>
- Vpc
Id string
- Created
At string - Description string
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Ipv6 bool - Source string
- Updated
At string - Ingress
Rule stringId - Nexthop
Private stringNetwork Id - Nexthop
Resource stringIp - Region string
- []string
- Vpc
Id string
- created_
at string - description string
- id string
- The provider-assigned unique ID for this managed resource.
- is_
ipv6 bool - source string
- updated_
at string - ingress_
rule_ stringid - nexthop_
private_ stringnetwork_ id - nexthop_
resource_ stringip - region string
- list(string)
- vpc_
id string
- created
At String - description String
- id String
- The provider-assigned unique ID for this managed resource.
- is
Ipv6 Boolean - source String
- updated
At String - ingress
Rule StringId - nexthop
Private StringNetwork Id - nexthop
Resource StringIp - region String
- List<String>
- vpc
Id String
- created
At string - description string
- id string
- The provider-assigned unique ID for this managed resource.
- is
Ipv6 boolean - source string
- updated
At string - ingress
Rule stringId - nexthop
Private stringNetwork Id - nexthop
Resource stringIp - region string
- string[]
- vpc
Id string
- created_
at str - description str
- id str
- The provider-assigned unique ID for this managed resource.
- is_
ipv6 bool - source str
- updated_
at str - ingress_
rule_ strid - nexthop_
private_ strnetwork_ id - nexthop_
resource_ strip - region str
- Sequence[str]
- vpc_
id str
- created
At String - description String
- id String
- The provider-assigned unique ID for this managed resource.
- is
Ipv6 Boolean - source String
- updated
At String - ingress
Rule StringId - nexthop
Private StringNetwork Id - nexthop
Resource StringIp - region String
- List<String>
- vpc
Id String
Package Details
- Repository
- scaleway pulumiverse/pulumi-scaleway
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
scalewayTerraform Provider.
published on Thursday, Jul 9, 2026 by pulumiverse