1. Packages
  2. Packages
  3. Scaleway
  4. API Docs
  5. edgeservices
  6. getBackendStage
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse
scaleway logo
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse

    Gets information about an Edge Services backend stage.

    A backend stage defines the origin (Scaleway Object Storage bucket or Load Balancer) that Edge Services forwards requests to.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Retrieve an Edge Services backend stage by its ID
    const byId = scaleway.edgeservices.getBackendStage({
        backendStageId: "11111111-1111-1111-1111-111111111111",
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Retrieve an Edge Services backend stage by its ID
    by_id = scaleway.edgeservices.get_backend_stage(backend_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 backend stage by its ID
    		_, err := edgeservices.LookupBackendStage(ctx, &edgeservices.LookupBackendStageArgs{
    			BackendStageId: 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 backend stage by its ID
        var byId = Scaleway.Edgeservices.GetBackendStage.Invoke(new()
        {
            BackendStageId = "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.GetBackendStageArgs;
    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 backend stage by its ID
            final var byId = EdgeservicesFunctions.getBackendStage(GetBackendStageArgs.builder()
                .backendStageId("11111111-1111-1111-1111-111111111111")
                .build());
    
        }
    }
    
    variables:
      # Retrieve an Edge Services backend stage by its ID
      byId:
        fn::invoke:
          function: scaleway:edgeservices:getBackendStage
          arguments:
            backendStageId: 11111111-1111-1111-1111-111111111111
    
    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Retrieve an Edge Services backend stage by pipeline ID
    const byPipeline = scaleway.edgeservices.getBackendStage({
        pipelineId: main.id,
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Retrieve an Edge Services backend stage by pipeline ID
    by_pipeline = scaleway.edgeservices.get_backend_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 backend stage by pipeline ID
    		_, err := edgeservices.LookupBackendStage(ctx, &edgeservices.LookupBackendStageArgs{
    			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 backend stage by pipeline ID
        var byPipeline = Scaleway.Edgeservices.GetBackendStage.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.GetBackendStageArgs;
    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 backend stage by pipeline ID
            final var byPipeline = EdgeservicesFunctions.getBackendStage(GetBackendStageArgs.builder()
                .pipelineId(main.id())
                .build());
    
        }
    }
    
    variables:
      # Retrieve an Edge Services backend stage by pipeline ID
      byPipeline:
        fn::invoke:
          function: scaleway:edgeservices:getBackendStage
          arguments:
            pipelineId: ${main.id}
    

    Using getBackendStage

    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 getBackendStage(args: GetBackendStageArgs, opts?: InvokeOptions): Promise<GetBackendStageResult>
    function getBackendStageOutput(args: GetBackendStageOutputArgs, opts?: InvokeOptions): Output<GetBackendStageResult>
    def get_backend_stage(backend_stage_id: Optional[str] = None,
                          bucket_name: Optional[str] = None,
                          bucket_region: Optional[str] = None,
                          lb_id: Optional[str] = None,
                          pipeline_id: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetBackendStageResult
    def get_backend_stage_output(backend_stage_id: Optional[pulumi.Input[str]] = None,
                          bucket_name: Optional[pulumi.Input[str]] = None,
                          bucket_region: Optional[pulumi.Input[str]] = None,
                          lb_id: Optional[pulumi.Input[str]] = None,
                          pipeline_id: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetBackendStageResult]
    func LookupBackendStage(ctx *Context, args *LookupBackendStageArgs, opts ...InvokeOption) (*LookupBackendStageResult, error)
    func LookupBackendStageOutput(ctx *Context, args *LookupBackendStageOutputArgs, opts ...InvokeOption) LookupBackendStageResultOutput

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

    public static class GetBackendStage 
    {
        public static Task<GetBackendStageResult> InvokeAsync(GetBackendStageArgs args, InvokeOptions? opts = null)
        public static Output<GetBackendStageResult> Invoke(GetBackendStageInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetBackendStageResult> getBackendStage(GetBackendStageArgs args, InvokeOptions options)
    public static Output<GetBackendStageResult> getBackendStage(GetBackendStageArgs args, InvokeOptions options)
    
    fn::invoke:
      function: scaleway:edgeservices/getBackendStage:getBackendStage
      arguments:
        # arguments dictionary

    The following arguments are supported:

    BackendStageId string

    The ID of the backend stage.

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

    BucketName string
    Filter by S3 bucket name.
    BucketRegion string
    Filter by S3 bucket region.
    LbId string
    Filter by Load Balancer ID.
    PipelineId string
    The ID of the pipeline.
    BackendStageId string

    The ID of the backend stage.

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

    BucketName string
    Filter by S3 bucket name.
    BucketRegion string
    Filter by S3 bucket region.
    LbId string
    Filter by Load Balancer ID.
    PipelineId string
    The ID of the pipeline.
    backendStageId String

    The ID of the backend stage.

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

    bucketName String
    Filter by S3 bucket name.
    bucketRegion String
    Filter by S3 bucket region.
    lbId String
    Filter by Load Balancer ID.
    pipelineId String
    The ID of the pipeline.
    backendStageId string

    The ID of the backend stage.

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

    bucketName string
    Filter by S3 bucket name.
    bucketRegion string
    Filter by S3 bucket region.
    lbId string
    Filter by Load Balancer ID.
    pipelineId string
    The ID of the pipeline.
    backend_stage_id str

    The ID of the backend stage.

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

    bucket_name str
    Filter by S3 bucket name.
    bucket_region str
    Filter by S3 bucket region.
    lb_id str
    Filter by Load Balancer ID.
    pipeline_id str
    The ID of the pipeline.
    backendStageId String

    The ID of the backend stage.

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

    bucketName String
    Filter by S3 bucket name.
    bucketRegion String
    Filter by S3 bucket region.
    lbId String
    Filter by Load Balancer ID.
    pipelineId String
    The ID of the pipeline.

    getBackendStage Result

    The following output properties are available:

    CreatedAt string
    Id string
    The provider-assigned unique ID for this managed resource.
    LbBackendConfigs []GetBackendStageLbBackendConfig
    ProjectId string
    S3BackendConfigs []GetBackendStageS3BackendConfig
    UpdatedAt string
    BackendStageId string
    BucketName string
    BucketRegion string
    LbId string
    PipelineId string
    createdAt String
    id String
    The provider-assigned unique ID for this managed resource.
    lbBackendConfigs List<GetBackendStageLbBackendConfig>
    projectId String
    s3BackendConfigs List<GetBackendStageS3BackendConfig>
    updatedAt String
    backendStageId String
    bucketName String
    bucketRegion String
    lbId String
    pipelineId String
    createdAt string
    id string
    The provider-assigned unique ID for this managed resource.
    lbBackendConfigs GetBackendStageLbBackendConfig[]
    projectId string
    s3BackendConfigs GetBackendStageS3BackendConfig[]
    updatedAt string
    backendStageId string
    bucketName string
    bucketRegion string
    lbId string
    pipelineId string
    createdAt String
    id String
    The provider-assigned unique ID for this managed resource.
    lbBackendConfigs List<Property Map>
    projectId String
    s3BackendConfigs List<Property Map>
    updatedAt String
    backendStageId String
    bucketName String
    bucketRegion String
    lbId String
    pipelineId String

    Supporting Types

    GetBackendStageLbBackendConfig

    lbConfigs List<Property Map>
    The Load Balancer configuration

    GetBackendStageLbBackendConfigLbConfig

    DomainName string
    Fully Qualified Domain Name (in the format subdomain.example.com) to use in HTTP requests sent towards your Load Balancer
    FrontendId string
    ID of the frontend linked to the Load Balancer
    HasWebsocket bool
    Defines whether to forward websocket requests to the load balancer
    Id string
    ID of the Load Balancer
    IsSsl bool
    Defines whether the Load Balancer's frontend handles SSL connections
    Zone string
    The zone you want to attach the resource to
    DomainName string
    Fully Qualified Domain Name (in the format subdomain.example.com) to use in HTTP requests sent towards your Load Balancer
    FrontendId string
    ID of the frontend linked to the Load Balancer
    HasWebsocket bool
    Defines whether to forward websocket requests to the load balancer
    Id string
    ID of the Load Balancer
    IsSsl bool
    Defines whether the Load Balancer's frontend handles SSL connections
    Zone string
    The zone you want to attach the resource to
    domainName String
    Fully Qualified Domain Name (in the format subdomain.example.com) to use in HTTP requests sent towards your Load Balancer
    frontendId String
    ID of the frontend linked to the Load Balancer
    hasWebsocket Boolean
    Defines whether to forward websocket requests to the load balancer
    id String
    ID of the Load Balancer
    isSsl Boolean
    Defines whether the Load Balancer's frontend handles SSL connections
    zone String
    The zone you want to attach the resource to
    domainName string
    Fully Qualified Domain Name (in the format subdomain.example.com) to use in HTTP requests sent towards your Load Balancer
    frontendId string
    ID of the frontend linked to the Load Balancer
    hasWebsocket boolean
    Defines whether to forward websocket requests to the load balancer
    id string
    ID of the Load Balancer
    isSsl boolean
    Defines whether the Load Balancer's frontend handles SSL connections
    zone string
    The zone you want to attach the resource to
    domain_name str
    Fully Qualified Domain Name (in the format subdomain.example.com) to use in HTTP requests sent towards your Load Balancer
    frontend_id str
    ID of the frontend linked to the Load Balancer
    has_websocket bool
    Defines whether to forward websocket requests to the load balancer
    id str
    ID of the Load Balancer
    is_ssl bool
    Defines whether the Load Balancer's frontend handles SSL connections
    zone str
    The zone you want to attach the resource to
    domainName String
    Fully Qualified Domain Name (in the format subdomain.example.com) to use in HTTP requests sent towards your Load Balancer
    frontendId String
    ID of the frontend linked to the Load Balancer
    hasWebsocket Boolean
    Defines whether to forward websocket requests to the load balancer
    id String
    ID of the Load Balancer
    isSsl Boolean
    Defines whether the Load Balancer's frontend handles SSL connections
    zone String
    The zone you want to attach the resource to

    GetBackendStageS3BackendConfig

    BucketName string
    Filter by S3 bucket name.
    BucketRegion string
    Filter by S3 bucket region.
    IsWebsite bool
    Defines whether the bucket website feature is enabled.
    BucketName string
    Filter by S3 bucket name.
    BucketRegion string
    Filter by S3 bucket region.
    IsWebsite bool
    Defines whether the bucket website feature is enabled.
    bucketName String
    Filter by S3 bucket name.
    bucketRegion String
    Filter by S3 bucket region.
    isWebsite Boolean
    Defines whether the bucket website feature is enabled.
    bucketName string
    Filter by S3 bucket name.
    bucketRegion string
    Filter by S3 bucket region.
    isWebsite boolean
    Defines whether the bucket website feature is enabled.
    bucket_name str
    Filter by S3 bucket name.
    bucket_region str
    Filter by S3 bucket region.
    is_website bool
    Defines whether the bucket website feature is enabled.
    bucketName String
    Filter by S3 bucket name.
    bucketRegion String
    Filter by S3 bucket region.
    isWebsite Boolean
    Defines whether the bucket website feature is enabled.

    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
      Try Pulumi Cloud free. Your team will thank you.