1. Packages
  2. Scaleway
  3. API Docs
  4. edgeservices
  5. HeadStage
Scaleway v1.41.1 published on Monday, Jan 12, 2026 by pulumiverse
scaleway logo
Scaleway v1.41.1 published on Monday, Jan 12, 2026 by pulumiverse

    Sets the Scaleway Edge Services head stage of your pipeline.

    Example Usage

    Basic

    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    const main = new scaleway.edgeservices.Pipeline("main", {
        name: "my-edge_services-pipeline",
        description: "pipeline description",
    });
    const mainDnsStage = new scaleway.edgeservices.DnsStage("main", {
        pipelineId: main.id,
        tlsStageId: mainScalewayEdgeServicesTlsStage.id,
        fqdns: ["subdomain.example.com"],
    });
    const mainHeadStage = new scaleway.edgeservices.HeadStage("main", {
        pipelineId: main.id,
        headStageId: mainDnsStage.id,
    });
    
    import pulumi
    import pulumiverse_scaleway as scaleway
    
    main = scaleway.edgeservices.Pipeline("main",
        name="my-edge_services-pipeline",
        description="pipeline description")
    main_dns_stage = scaleway.edgeservices.DnsStage("main",
        pipeline_id=main.id,
        tls_stage_id=main_scaleway_edge_services_tls_stage["id"],
        fqdns=["subdomain.example.com"])
    main_head_stage = scaleway.edgeservices.HeadStage("main",
        pipeline_id=main.id,
        head_stage_id=main_dns_stage.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 {
    		main, err := edgeservices.NewPipeline(ctx, "main", &edgeservices.PipelineArgs{
    			Name:        pulumi.String("my-edge_services-pipeline"),
    			Description: pulumi.String("pipeline description"),
    		})
    		if err != nil {
    			return err
    		}
    		mainDnsStage, err := edgeservices.NewDnsStage(ctx, "main", &edgeservices.DnsStageArgs{
    			PipelineId: main.ID(),
    			TlsStageId: pulumi.Any(mainScalewayEdgeServicesTlsStage.Id),
    			Fqdns: pulumi.StringArray{
    				pulumi.String("subdomain.example.com"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		_, err = edgeservices.NewHeadStage(ctx, "main", &edgeservices.HeadStageArgs{
    			PipelineId:  main.ID(),
    			HeadStageId: mainDnsStage.ID(),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scaleway = Pulumiverse.Scaleway;
    
    return await Deployment.RunAsync(() => 
    {
        var main = new Scaleway.Edgeservices.Pipeline("main", new()
        {
            Name = "my-edge_services-pipeline",
            Description = "pipeline description",
        });
    
        var mainDnsStage = new Scaleway.Edgeservices.DnsStage("main", new()
        {
            PipelineId = main.Id,
            TlsStageId = mainScalewayEdgeServicesTlsStage.Id,
            Fqdns = new[]
            {
                "subdomain.example.com",
            },
        });
    
        var mainHeadStage = new Scaleway.Edgeservices.HeadStage("main", new()
        {
            PipelineId = main.Id,
            HeadStageId = mainDnsStage.Id,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scaleway.edgeservices.Pipeline;
    import com.pulumi.scaleway.edgeservices.PipelineArgs;
    import com.pulumi.scaleway.edgeservices.DnsStage;
    import com.pulumi.scaleway.edgeservices.DnsStageArgs;
    import com.pulumi.scaleway.edgeservices.HeadStage;
    import com.pulumi.scaleway.edgeservices.HeadStageArgs;
    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) {
            var main = new Pipeline("main", PipelineArgs.builder()
                .name("my-edge_services-pipeline")
                .description("pipeline description")
                .build());
    
            var mainDnsStage = new DnsStage("mainDnsStage", DnsStageArgs.builder()
                .pipelineId(main.id())
                .tlsStageId(mainScalewayEdgeServicesTlsStage.id())
                .fqdns("subdomain.example.com")
                .build());
    
            var mainHeadStage = new HeadStage("mainHeadStage", HeadStageArgs.builder()
                .pipelineId(main.id())
                .headStageId(mainDnsStage.id())
                .build());
    
        }
    }
    
    resources:
      main:
        type: scaleway:edgeservices:Pipeline
        properties:
          name: my-edge_services-pipeline
          description: pipeline description
      mainDnsStage:
        type: scaleway:edgeservices:DnsStage
        name: main
        properties:
          pipelineId: ${main.id}
          tlsStageId: ${mainScalewayEdgeServicesTlsStage.id}
          fqdns:
            - subdomain.example.com
      mainHeadStage:
        type: scaleway:edgeservices:HeadStage
        name: main
        properties:
          pipelineId: ${main.id}
          headStageId: ${mainDnsStage.id}
    

    Create HeadStage Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new HeadStage(name: string, args: HeadStageArgs, opts?: CustomResourceOptions);
    @overload
    def HeadStage(resource_name: str,
                  args: HeadStageArgs,
                  opts: Optional[ResourceOptions] = None)
    
    @overload
    def HeadStage(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  pipeline_id: Optional[str] = None,
                  head_stage_id: Optional[str] = None)
    func NewHeadStage(ctx *Context, name string, args HeadStageArgs, opts ...ResourceOption) (*HeadStage, error)
    public HeadStage(string name, HeadStageArgs args, CustomResourceOptions? opts = null)
    public HeadStage(String name, HeadStageArgs args)
    public HeadStage(String name, HeadStageArgs args, CustomResourceOptions options)
    
    type: scaleway:edgeservices:HeadStage
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args HeadStageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args HeadStageArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args HeadStageArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args HeadStageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args HeadStageArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var headStageResource = new Scaleway.Edgeservices.HeadStage("headStageResource", new()
    {
        PipelineId = "string",
        HeadStageId = "string",
    });
    
    example, err := edgeservices.NewHeadStage(ctx, "headStageResource", &edgeservices.HeadStageArgs{
    	PipelineId:  pulumi.String("string"),
    	HeadStageId: pulumi.String("string"),
    })
    
    var headStageResource = new HeadStage("headStageResource", HeadStageArgs.builder()
        .pipelineId("string")
        .headStageId("string")
        .build());
    
    head_stage_resource = scaleway.edgeservices.HeadStage("headStageResource",
        pipeline_id="string",
        head_stage_id="string")
    
    const headStageResource = new scaleway.edgeservices.HeadStage("headStageResource", {
        pipelineId: "string",
        headStageId: "string",
    });
    
    type: scaleway:edgeservices:HeadStage
    properties:
        headStageId: string
        pipelineId: string
    

    HeadStage Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The HeadStage resource accepts the following input properties:

    PipelineId string
    The ID of the pipeline.
    HeadStageId string
    The ID of head stage of the pipeline.
    PipelineId string
    The ID of the pipeline.
    HeadStageId string
    The ID of head stage of the pipeline.
    pipelineId String
    The ID of the pipeline.
    headStageId String
    The ID of head stage of the pipeline.
    pipelineId string
    The ID of the pipeline.
    headStageId string
    The ID of head stage of the pipeline.
    pipeline_id str
    The ID of the pipeline.
    head_stage_id str
    The ID of head stage of the pipeline.
    pipelineId String
    The ID of the pipeline.
    headStageId String
    The ID of head stage of the pipeline.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the HeadStage resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing HeadStage Resource

    Get an existing HeadStage resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: HeadStageState, opts?: CustomResourceOptions): HeadStage
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            head_stage_id: Optional[str] = None,
            pipeline_id: Optional[str] = None) -> HeadStage
    func GetHeadStage(ctx *Context, name string, id IDInput, state *HeadStageState, opts ...ResourceOption) (*HeadStage, error)
    public static HeadStage Get(string name, Input<string> id, HeadStageState? state, CustomResourceOptions? opts = null)
    public static HeadStage get(String name, Output<String> id, HeadStageState state, CustomResourceOptions options)
    resources:  _:    type: scaleway:edgeservices:HeadStage    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    HeadStageId string
    The ID of head stage of the pipeline.
    PipelineId string
    The ID of the pipeline.
    HeadStageId string
    The ID of head stage of the pipeline.
    PipelineId string
    The ID of the pipeline.
    headStageId String
    The ID of head stage of the pipeline.
    pipelineId String
    The ID of the pipeline.
    headStageId string
    The ID of head stage of the pipeline.
    pipelineId string
    The ID of the pipeline.
    head_stage_id str
    The ID of head stage of the pipeline.
    pipeline_id str
    The ID of the pipeline.
    headStageId String
    The ID of head stage of the pipeline.
    pipelineId String
    The ID of the pipeline.

    Import

    Head stages can be imported using the {id}, e.g.

    bash

    $ pulumi import scaleway:edgeservices/headStage:HeadStage main 11111111-1111-1111-1111-111111111111
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    scaleway pulumiverse/pulumi-scaleway
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scaleway Terraform Provider.
    scaleway logo
    Scaleway v1.41.1 published on Monday, Jan 12, 2026 by pulumiverse
      Meet Neo: Your AI Platform Teammate