1. Packages
  2. Packages
  3. Scaleway
  4. API Docs
  5. edgeservices
  6. getDnsStage
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 DNS stage.

    A DNS stage defines the Fully Qualified Domain Names (FQDNs) attached to an Edge Services pipeline and links them to the next processing stage.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Retrieve an Edge Services DNS stage by its ID
    const byId = scaleway.edgeservices.getDnsStage({
        dnsStageId: "11111111-1111-1111-1111-111111111111",
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Retrieve an Edge Services DNS stage by its ID
    by_id = scaleway.edgeservices.get_dns_stage(dns_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 DNS stage by its ID
    		_, err := edgeservices.LookupDnsStage(ctx, &edgeservices.LookupDnsStageArgs{
    			DnsStageId: 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 DNS stage by its ID
        var byId = Scaleway.Edgeservices.GetDnsStage.Invoke(new()
        {
            DnsStageId = "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.GetDnsStageArgs;
    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 DNS stage by its ID
            final var byId = EdgeservicesFunctions.getDnsStage(GetDnsStageArgs.builder()
                .dnsStageId("11111111-1111-1111-1111-111111111111")
                .build());
    
        }
    }
    
    variables:
      # Retrieve an Edge Services DNS stage by its ID
      byId:
        fn::invoke:
          function: scaleway:edgeservices:getDnsStage
          arguments:
            dnsStageId: 11111111-1111-1111-1111-111111111111
    
    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Retrieve an Edge Services DNS stage by pipeline ID and FQDN
    const byFqdn = scaleway.edgeservices.getDnsStage({
        pipelineId: main.id,
        fqdn: "cdn.example.com",
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Retrieve an Edge Services DNS stage by pipeline ID and FQDN
    by_fqdn = scaleway.edgeservices.get_dns_stage(pipeline_id=main["id"],
        fqdn="cdn.example.com")
    
    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 DNS stage by pipeline ID and FQDN
    		_, err := edgeservices.LookupDnsStage(ctx, &edgeservices.LookupDnsStageArgs{
    			PipelineId: pulumi.StringRef(main.Id),
    			Fqdn:       pulumi.StringRef("cdn.example.com"),
    		}, 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 DNS stage by pipeline ID and FQDN
        var byFqdn = Scaleway.Edgeservices.GetDnsStage.Invoke(new()
        {
            PipelineId = main.Id,
            Fqdn = "cdn.example.com",
        });
    
    });
    
    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.GetDnsStageArgs;
    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 DNS stage by pipeline ID and FQDN
            final var byFqdn = EdgeservicesFunctions.getDnsStage(GetDnsStageArgs.builder()
                .pipelineId(main.id())
                .fqdn("cdn.example.com")
                .build());
    
        }
    }
    
    variables:
      # Retrieve an Edge Services DNS stage by pipeline ID and FQDN
      byFqdn:
        fn::invoke:
          function: scaleway:edgeservices:getDnsStage
          arguments:
            pipelineId: ${main.id}
            fqdn: cdn.example.com
    

    Using getDnsStage

    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 getDnsStage(args: GetDnsStageArgs, opts?: InvokeOptions): Promise<GetDnsStageResult>
    function getDnsStageOutput(args: GetDnsStageOutputArgs, opts?: InvokeOptions): Output<GetDnsStageResult>
    def get_dns_stage(dns_stage_id: Optional[str] = None,
                      fqdn: Optional[str] = None,
                      pipeline_id: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetDnsStageResult
    def get_dns_stage_output(dns_stage_id: Optional[pulumi.Input[str]] = None,
                      fqdn: Optional[pulumi.Input[str]] = None,
                      pipeline_id: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetDnsStageResult]
    func LookupDnsStage(ctx *Context, args *LookupDnsStageArgs, opts ...InvokeOption) (*LookupDnsStageResult, error)
    func LookupDnsStageOutput(ctx *Context, args *LookupDnsStageOutputArgs, opts ...InvokeOption) LookupDnsStageResultOutput

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

    public static class GetDnsStage 
    {
        public static Task<GetDnsStageResult> InvokeAsync(GetDnsStageArgs args, InvokeOptions? opts = null)
        public static Output<GetDnsStageResult> Invoke(GetDnsStageInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDnsStageResult> getDnsStage(GetDnsStageArgs args, InvokeOptions options)
    public static Output<GetDnsStageResult> getDnsStage(GetDnsStageArgs args, InvokeOptions options)
    
    fn::invoke:
      function: scaleway:edgeservices/getDnsStage:getDnsStage
      arguments:
        # arguments dictionary

    The following arguments are supported:

    DnsStageId string

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

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

    Fqdn string
    FQDN to filter for (in the format subdomain.example.com).
    PipelineId string
    The ID of the pipeline.
    DnsStageId string

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

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

    Fqdn string
    FQDN to filter for (in the format subdomain.example.com).
    PipelineId string
    The ID of the pipeline.
    dnsStageId String

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

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

    fqdn String
    FQDN to filter for (in the format subdomain.example.com).
    pipelineId String
    The ID of the pipeline.
    dnsStageId string

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

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

    fqdn string
    FQDN to filter for (in the format subdomain.example.com).
    pipelineId string
    The ID of the pipeline.
    dns_stage_id str

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

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

    fqdn str
    FQDN to filter for (in the format subdomain.example.com).
    pipeline_id str
    The ID of the pipeline.
    dnsStageId String

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

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

    fqdn String
    FQDN to filter for (in the format subdomain.example.com).
    pipelineId String
    The ID of the pipeline.

    getDnsStage Result

    The following output properties are available:

    BackendStageId string
    CacheStageId string
    CreatedAt string
    DefaultFqdn string
    Fqdns List<string>
    Id string
    The provider-assigned unique ID for this managed resource.
    ProjectId string
    TlsStageId string
    Type string
    UpdatedAt string
    DnsStageId string
    Fqdn string
    PipelineId string
    BackendStageId string
    CacheStageId string
    CreatedAt string
    DefaultFqdn string
    Fqdns []string
    Id string
    The provider-assigned unique ID for this managed resource.
    ProjectId string
    TlsStageId string
    Type string
    UpdatedAt string
    DnsStageId string
    Fqdn string
    PipelineId string
    backendStageId String
    cacheStageId String
    createdAt String
    defaultFqdn String
    fqdns List<String>
    id String
    The provider-assigned unique ID for this managed resource.
    projectId String
    tlsStageId String
    type String
    updatedAt String
    dnsStageId String
    fqdn String
    pipelineId String
    backendStageId string
    cacheStageId string
    createdAt string
    defaultFqdn string
    fqdns string[]
    id string
    The provider-assigned unique ID for this managed resource.
    projectId string
    tlsStageId string
    type string
    updatedAt string
    dnsStageId string
    fqdn string
    pipelineId string
    backend_stage_id str
    cache_stage_id str
    created_at str
    default_fqdn str
    fqdns Sequence[str]
    id str
    The provider-assigned unique ID for this managed resource.
    project_id str
    tls_stage_id str
    type str
    updated_at str
    dns_stage_id str
    fqdn str
    pipeline_id str
    backendStageId String
    cacheStageId String
    createdAt String
    defaultFqdn String
    fqdns List<String>
    id String
    The provider-assigned unique ID for this managed resource.
    projectId String
    tlsStageId String
    type String
    updatedAt String
    dnsStageId String
    fqdn String
    pipelineId String

    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.