1. Packages
  2. Packages
  3. Scaleway
  4. API Docs
  5. edgeservices
  6. getRouteStage
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse
Schema (JSON)
pulumiverse/pulumi-scaleway

scaleway.edgeservices.getRouteStage

scaleway logo
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse
Schema (JSON)
pulumiverse/pulumi-scaleway

    Gets information about an Edge Services route stage.

    A route stage defines HTTP request routing rules that forward requests to different backend stages based on method and path matching.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

// Retrieve an Edge Services route stage by its ID
const byId = scaleway.edgeservices.getRouteStage({
    routeStageId: "11111111-1111-1111-1111-111111111111",
});

    import pulumi
import pulumi_scaleway as scaleway

# Retrieve an Edge Services route stage by its ID
by_id = scaleway.edgeservices.get_route_stage(route_stage_id="11111111-1111-1111-1111-111111111111")

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/edgeservices"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Retrieve an Edge Services route stage by its ID
		_, err := edgeservices.LookupRouteStage(ctx, &edgeservices.LookupRouteStageArgs{
			RouteStageId: pulumi.StringRef("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 an Edge Services route stage by its ID
    var byId = Scaleway.Edgeservices.GetRouteStage.Invoke(new()
    {
        RouteStageId = "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.edgeservices.EdgeservicesFunctions;
import com.pulumi.scaleway.edgeservices.inputs.GetRouteStageArgs;
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) {
        // Retrieve an Edge Services route stage by its ID
        final var byId = EdgeservicesFunctions.getRouteStage(GetRouteStageArgs.builder()
            .routeStageId("11111111-1111-1111-1111-111111111111")
            .build());

    }
}

    variables:
  # Retrieve an Edge Services route stage by its ID
  byId:
    fn::invoke:
      function: scaleway:edgeservices:getRouteStage
      arguments:
        routeStageId: 11111111-1111-1111-1111-111111111111

    import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";

// Retrieve an Edge Services route stage by pipeline ID
const byPipeline = scaleway.edgeservices.getRouteStage({
    pipelineId: main.id,
});

    import pulumi
import pulumi_scaleway as scaleway

# Retrieve an Edge Services route stage by pipeline ID
by_pipeline = scaleway.edgeservices.get_route_stage(pipeline_id=main["id"])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/edgeservices"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Retrieve an Edge Services route stage by pipeline ID
		_, err := edgeservices.LookupRouteStage(ctx, &edgeservices.LookupRouteStageArgs{
			PipelineId: pulumi.StringRef(main.Id),
		}, 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 an Edge Services route stage by pipeline ID
    var byPipeline = Scaleway.Edgeservices.GetRouteStage.Invoke(new()
    {
        PipelineId = main.Id,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.edgeservices.EdgeservicesFunctions;
import com.pulumi.scaleway.edgeservices.inputs.GetRouteStageArgs;
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) {
        // Retrieve an Edge Services route stage by pipeline ID
        final var byPipeline = EdgeservicesFunctions.getRouteStage(GetRouteStageArgs.builder()
            .pipelineId(main.id())
            .build());

    }
}

    variables:
  # Retrieve an Edge Services route stage by pipeline ID
  byPipeline:
    fn::invoke:
      function: scaleway:edgeservices:getRouteStage
      arguments:
        pipelineId: ${main.id}

    Using getRouteStage

    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 getRouteStage(args: GetRouteStageArgs, opts?: InvokeOptions): Promise<GetRouteStageResult>
function getRouteStageOutput(args: GetRouteStageOutputArgs, opts?: InvokeOptions): Output<GetRouteStageResult>
    def get_route_stage(pipeline_id: Optional[str] = None,
                    route_stage_id: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetRouteStageResult
def get_route_stage_output(pipeline_id: Optional[pulumi.Input[str]] = None,
                    route_stage_id: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetRouteStageResult]
    func LookupRouteStage(ctx *Context, args *LookupRouteStageArgs, opts ...InvokeOption) (*LookupRouteStageResult, error)
func LookupRouteStageOutput(ctx *Context, args *LookupRouteStageOutputArgs, opts ...InvokeOption) LookupRouteStageResultOutput

    > Note: This function is named LookupRouteStage in the Go SDK.

    public static class GetRouteStage 
{
    public static Task<GetRouteStageResult> InvokeAsync(GetRouteStageArgs args, InvokeOptions? opts = null)
    public static Output<GetRouteStageResult> Invoke(GetRouteStageInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetRouteStageResult> getRouteStage(GetRouteStageArgs args, InvokeOptions options)
public static Output<GetRouteStageResult> getRouteStage(GetRouteStageArgs args, InvokeOptions options)

    fn::invoke:
  function: scaleway:edgeservices/getRouteStage:getRouteStage
  arguments:
    # arguments dictionary

    The following arguments are supported:

    PipelineId string
    The ID of the pipeline.
    RouteStageId string

    The ID of the route stage. Conflicts with all filter arguments below.

    The following filter arguments are supported (cannot be used with routeStageId):

    PipelineId string
    The ID of the pipeline.
    RouteStageId string

    The ID of the route stage. Conflicts with all filter arguments below.

    The following filter arguments are supported (cannot be used with routeStageId):

    pipelineId String
    The ID of the pipeline.
    routeStageId String

    The ID of the route stage. Conflicts with all filter arguments below.

    The following filter arguments are supported (cannot be used with routeStageId):

    pipelineId string
    The ID of the pipeline.
    routeStageId string

    The ID of the route stage. Conflicts with all filter arguments below.

    The following filter arguments are supported (cannot be used with routeStageId):

    pipeline_id str
    The ID of the pipeline.
    route_stage_id str

    The ID of the route stage. Conflicts with all filter arguments below.

    The following filter arguments are supported (cannot be used with routeStageId):

    pipelineId String
    The ID of the pipeline.
    routeStageId String

    The ID of the route stage. Conflicts with all filter arguments below.

    The following filter arguments are supported (cannot be used with routeStageId):

    getRouteStage Result

    The following output properties are available:

    BackendStageId string
    CreatedAt string
    Id string
    The provider-assigned unique ID for this managed resource.
    ProjectId string
    Rules List<Pulumiverse.Scaleway.Edgeservices.Outputs.GetRouteStageRule>
    UpdatedAt string
    WafStageId string
    PipelineId string
    RouteStageId string
    BackendStageId string
    CreatedAt string
    Id string
    The provider-assigned unique ID for this managed resource.
    ProjectId string
    Rules []GetRouteStageRule
    UpdatedAt string
    WafStageId string
    PipelineId string
    RouteStageId string
    backendStageId String
    createdAt String
    id String
    The provider-assigned unique ID for this managed resource.
    projectId String
    rules List<GetRouteStageRule>
    updatedAt String
    wafStageId String
    pipelineId String
    routeStageId String
    backendStageId string
    createdAt string
    id string
    The provider-assigned unique ID for this managed resource.
    projectId string
    rules GetRouteStageRule[]
    updatedAt string
    wafStageId string
    pipelineId string
    routeStageId string
    backend_stage_id str
    created_at str
    id str
    The provider-assigned unique ID for this managed resource.
    project_id str
    rules Sequence[GetRouteStageRule]
    updated_at str
    waf_stage_id str
    pipeline_id str
    route_stage_id str
    backendStageId String
    createdAt String
    id String
    The provider-assigned unique ID for this managed resource.
    projectId String
    rules List<Property Map>
    updatedAt String
    wafStageId String
    pipelineId String
    routeStageId String

    Supporting Types

    GetRouteStageRule

    BackendStageId string
    ID of the backend stage that requests matching the rule should be forwarded to
    RuleHttpMatches List<Pulumiverse.Scaleway.Edgeservices.Inputs.GetRouteStageRuleRuleHttpMatch>
    Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backendStageId field. Requests that do not match will be checked by the next rule's condition
    WafStageId string
    ID of the WAF stage that requests matching the rule should be forwarded to
    BackendStageId string
    ID of the backend stage that requests matching the rule should be forwarded to
    RuleHttpMatches []GetRouteStageRuleRuleHttpMatch
    Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backendStageId field. Requests that do not match will be checked by the next rule's condition
    WafStageId string
    ID of the WAF stage that requests matching the rule should be forwarded to
    backendStageId String
    ID of the backend stage that requests matching the rule should be forwarded to
    ruleHttpMatches List<GetRouteStageRuleRuleHttpMatch>
    Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backendStageId field. Requests that do not match will be checked by the next rule's condition
    wafStageId String
    ID of the WAF stage that requests matching the rule should be forwarded to
    backendStageId string
    ID of the backend stage that requests matching the rule should be forwarded to
    ruleHttpMatches GetRouteStageRuleRuleHttpMatch[]
    Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backendStageId field. Requests that do not match will be checked by the next rule's condition
    wafStageId string
    ID of the WAF stage that requests matching the rule should be forwarded to
    backend_stage_id str
    ID of the backend stage that requests matching the rule should be forwarded to
    rule_http_matches Sequence[GetRouteStageRuleRuleHttpMatch]
    Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backendStageId field. Requests that do not match will be checked by the next rule's condition
    waf_stage_id str
    ID of the WAF stage that requests matching the rule should be forwarded to
    backendStageId String
    ID of the backend stage that requests matching the rule should be forwarded to
    ruleHttpMatches List<Property Map>
    Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backendStageId field. Requests that do not match will be checked by the next rule's condition
    wafStageId String
    ID of the WAF stage that requests matching the rule should be forwarded to

    GetRouteStageRuleRuleHttpMatch

    HostFilters List<Pulumiverse.Scaleway.Edgeservices.Inputs.GetRouteStageRuleRuleHttpMatchHostFilter>
    Host to filter for. A request whose host matches the given filter will be considered to match the rule. All hosts will match if none is provided
    MethodFilters List<string>
    HTTP methods to filter for. A request using any of these methods will be considered to match the rule. Possible values are get, post, put, patch, delete, head, options. All methods will match if none is provided
    PathFilters List<Pulumiverse.Scaleway.Edgeservices.Inputs.GetRouteStageRuleRuleHttpMatchPathFilter>
    HTTP URL path to filter for. A request whose path matches the given filter will be considered to match the rule. All paths will match if none is provided
    HostFilters []GetRouteStageRuleRuleHttpMatchHostFilter
    Host to filter for. A request whose host matches the given filter will be considered to match the rule. All hosts will match if none is provided
    MethodFilters []string
    HTTP methods to filter for. A request using any of these methods will be considered to match the rule. Possible values are get, post, put, patch, delete, head, options. All methods will match if none is provided
    PathFilters []GetRouteStageRuleRuleHttpMatchPathFilter
    HTTP URL path to filter for. A request whose path matches the given filter will be considered to match the rule. All paths will match if none is provided
    hostFilters List<GetRouteStageRuleRuleHttpMatchHostFilter>
    Host to filter for. A request whose host matches the given filter will be considered to match the rule. All hosts will match if none is provided
    methodFilters List<String>
    HTTP methods to filter for. A request using any of these methods will be considered to match the rule. Possible values are get, post, put, patch, delete, head, options. All methods will match if none is provided
    pathFilters List<GetRouteStageRuleRuleHttpMatchPathFilter>
    HTTP URL path to filter for. A request whose path matches the given filter will be considered to match the rule. All paths will match if none is provided
    hostFilters GetRouteStageRuleRuleHttpMatchHostFilter[]
    Host to filter for. A request whose host matches the given filter will be considered to match the rule. All hosts will match if none is provided
    methodFilters string[]
    HTTP methods to filter for. A request using any of these methods will be considered to match the rule. Possible values are get, post, put, patch, delete, head, options. All methods will match if none is provided
    pathFilters GetRouteStageRuleRuleHttpMatchPathFilter[]
    HTTP URL path to filter for. A request whose path matches the given filter will be considered to match the rule. All paths will match if none is provided
    host_filters Sequence[GetRouteStageRuleRuleHttpMatchHostFilter]
    Host to filter for. A request whose host matches the given filter will be considered to match the rule. All hosts will match if none is provided
    method_filters Sequence[str]
    HTTP methods to filter for. A request using any of these methods will be considered to match the rule. Possible values are get, post, put, patch, delete, head, options. All methods will match if none is provided
    path_filters Sequence[GetRouteStageRuleRuleHttpMatchPathFilter]
    HTTP URL path to filter for. A request whose path matches the given filter will be considered to match the rule. All paths will match if none is provided
    hostFilters List<Property Map>
    Host to filter for. A request whose host matches the given filter will be considered to match the rule. All hosts will match if none is provided
    methodFilters List<String>
    HTTP methods to filter for. A request using any of these methods will be considered to match the rule. Possible values are get, post, put, patch, delete, head, options. All methods will match if none is provided
    pathFilters List<Property Map>
    HTTP URL path to filter for. A request whose path matches the given filter will be considered to match the rule. All paths will match if none is provided

    GetRouteStageRuleRuleHttpMatchHostFilter

    HostFilterType string
    The type of filter to match for the host path
    Value string
    The value to be matched for the host path
    HostFilterType string
    The type of filter to match for the host path
    Value string
    The value to be matched for the host path
    hostFilterType String
    The type of filter to match for the host path
    value String
    The value to be matched for the host path
    hostFilterType string
    The type of filter to match for the host path
    value string
    The value to be matched for the host path
    host_filter_type str
    The type of filter to match for the host path
    value str
    The value to be matched for the host path
    hostFilterType String
    The type of filter to match for the host path
    value String
    The value to be matched for the host path

    GetRouteStageRuleRuleHttpMatchPathFilter

    PathFilterType string
    The type of filter to match for the HTTP URL path. For now, all path filters must be written in regex and use the regex type
    Value string
    The value to be matched for the HTTP URL path
    PathFilterType string
    The type of filter to match for the HTTP URL path. For now, all path filters must be written in regex and use the regex type
    Value string
    The value to be matched for the HTTP URL path
    pathFilterType String
    The type of filter to match for the HTTP URL path. For now, all path filters must be written in regex and use the regex type
    value String
    The value to be matched for the HTTP URL path
    pathFilterType string
    The type of filter to match for the HTTP URL path. For now, all path filters must be written in regex and use the regex type
    value string
    The value to be matched for the HTTP URL path
    path_filter_type str
    The type of filter to match for the HTTP URL path. For now, all path filters must be written in regex and use the regex type
    value str
    The value to be matched for the HTTP URL path
    pathFilterType String
    The type of filter to match for the HTTP URL path. For now, all path filters must be written in regex and use the regex type
    value String
    The value to be matched for the HTTP URL path

    Package Details

    Repository
    scaleway pulumiverse/pulumi-scaleway
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scaleway Terraform Provider.
    scaleway logo
    Viewing docs for Scaleway v1.48.0
    published on Wednesday, Apr 29, 2026 by pulumiverse
    Schema (JSON)
    pulumiverse/pulumi-scaleway
      Try Pulumi Cloud free. Your team will thank you.