1. Packages
  2. stackit
  3. API Docs
  4. getDnsZone
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud
stackit logo
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud

    DNS Zone resource schema.

    Example Usage

    data "stackit_dns_zone" "example" {
      project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      zone_id    = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
    

    Using getDnsZone

    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 getDnsZone(args: GetDnsZoneArgs, opts?: InvokeOptions): Promise<GetDnsZoneResult>
    function getDnsZoneOutput(args: GetDnsZoneOutputArgs, opts?: InvokeOptions): Output<GetDnsZoneResult>
    def get_dns_zone(dns_name: Optional[str] = None,
                     project_id: Optional[str] = None,
                     zone_id: Optional[str] = None,
                     opts: Optional[InvokeOptions] = None) -> GetDnsZoneResult
    def get_dns_zone_output(dns_name: Optional[pulumi.Input[str]] = None,
                     project_id: Optional[pulumi.Input[str]] = None,
                     zone_id: Optional[pulumi.Input[str]] = None,
                     opts: Optional[InvokeOptions] = None) -> Output[GetDnsZoneResult]
    func LookupDnsZone(ctx *Context, args *LookupDnsZoneArgs, opts ...InvokeOption) (*LookupDnsZoneResult, error)
    func LookupDnsZoneOutput(ctx *Context, args *LookupDnsZoneOutputArgs, opts ...InvokeOption) LookupDnsZoneResultOutput

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

    public static class GetDnsZone 
    {
        public static Task<GetDnsZoneResult> InvokeAsync(GetDnsZoneArgs args, InvokeOptions? opts = null)
        public static Output<GetDnsZoneResult> Invoke(GetDnsZoneInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDnsZoneResult> getDnsZone(GetDnsZoneArgs args, InvokeOptions options)
    public static Output<GetDnsZoneResult> getDnsZone(GetDnsZoneArgs args, InvokeOptions options)
    
    fn::invoke:
      function: stackit:index/getDnsZone:getDnsZone
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ProjectId string
    STACKIT project ID to which the dns zone is associated.
    DnsName string
    The zone name. E.g. example.com
    ZoneId string
    The zone ID.
    ProjectId string
    STACKIT project ID to which the dns zone is associated.
    DnsName string
    The zone name. E.g. example.com
    ZoneId string
    The zone ID.
    projectId String
    STACKIT project ID to which the dns zone is associated.
    dnsName String
    The zone name. E.g. example.com
    zoneId String
    The zone ID.
    projectId string
    STACKIT project ID to which the dns zone is associated.
    dnsName string
    The zone name. E.g. example.com
    zoneId string
    The zone ID.
    project_id str
    STACKIT project ID to which the dns zone is associated.
    dns_name str
    The zone name. E.g. example.com
    zone_id str
    The zone ID.
    projectId String
    STACKIT project ID to which the dns zone is associated.
    dnsName String
    The zone name. E.g. example.com
    zoneId String
    The zone ID.

    getDnsZone Result

    The following output properties are available:

    Acl string
    The access control list.
    Active bool
    ContactEmail string
    A contact e-mail for the zone.
    DefaultTtl int
    Default time to live.
    Description string
    Description of the zone.
    ExpireTime int
    Expire time.
    Id string
    IsReverseZone bool
    Specifies, if the zone is a reverse zone or not.
    Name string
    The user given name of the zone.
    NegativeCache int
    Negative caching.
    Primaries List<string>
    Primary name server for secondary zone.
    PrimaryNameServer string
    Primary name server. FQDN.
    ProjectId string
    STACKIT project ID to which the dns zone is associated.
    RecordCount int
    Record count how many records are in the zone.
    RefreshTime int
    Refresh time.
    RetryTime int
    Retry time.
    SerialNumber int
    Serial number.
    State string
    Zone state.
    Type string
    Zone type.
    Visibility string
    Visibility of the zone.
    DnsName string
    The zone name. E.g. example.com
    ZoneId string
    The zone ID.
    Acl string
    The access control list.
    Active bool
    ContactEmail string
    A contact e-mail for the zone.
    DefaultTtl int
    Default time to live.
    Description string
    Description of the zone.
    ExpireTime int
    Expire time.
    Id string
    IsReverseZone bool
    Specifies, if the zone is a reverse zone or not.
    Name string
    The user given name of the zone.
    NegativeCache int
    Negative caching.
    Primaries []string
    Primary name server for secondary zone.
    PrimaryNameServer string
    Primary name server. FQDN.
    ProjectId string
    STACKIT project ID to which the dns zone is associated.
    RecordCount int
    Record count how many records are in the zone.
    RefreshTime int
    Refresh time.
    RetryTime int
    Retry time.
    SerialNumber int
    Serial number.
    State string
    Zone state.
    Type string
    Zone type.
    Visibility string
    Visibility of the zone.
    DnsName string
    The zone name. E.g. example.com
    ZoneId string
    The zone ID.
    acl String
    The access control list.
    active Boolean
    contactEmail String
    A contact e-mail for the zone.
    defaultTtl Integer
    Default time to live.
    description String
    Description of the zone.
    expireTime Integer
    Expire time.
    id String
    isReverseZone Boolean
    Specifies, if the zone is a reverse zone or not.
    name String
    The user given name of the zone.
    negativeCache Integer
    Negative caching.
    primaries List<String>
    Primary name server for secondary zone.
    primaryNameServer String
    Primary name server. FQDN.
    projectId String
    STACKIT project ID to which the dns zone is associated.
    recordCount Integer
    Record count how many records are in the zone.
    refreshTime Integer
    Refresh time.
    retryTime Integer
    Retry time.
    serialNumber Integer
    Serial number.
    state String
    Zone state.
    type String
    Zone type.
    visibility String
    Visibility of the zone.
    dnsName String
    The zone name. E.g. example.com
    zoneId String
    The zone ID.
    acl string
    The access control list.
    active boolean
    contactEmail string
    A contact e-mail for the zone.
    defaultTtl number
    Default time to live.
    description string
    Description of the zone.
    expireTime number
    Expire time.
    id string
    isReverseZone boolean
    Specifies, if the zone is a reverse zone or not.
    name string
    The user given name of the zone.
    negativeCache number
    Negative caching.
    primaries string[]
    Primary name server for secondary zone.
    primaryNameServer string
    Primary name server. FQDN.
    projectId string
    STACKIT project ID to which the dns zone is associated.
    recordCount number
    Record count how many records are in the zone.
    refreshTime number
    Refresh time.
    retryTime number
    Retry time.
    serialNumber number
    Serial number.
    state string
    Zone state.
    type string
    Zone type.
    visibility string
    Visibility of the zone.
    dnsName string
    The zone name. E.g. example.com
    zoneId string
    The zone ID.
    acl str
    The access control list.
    active bool
    contact_email str
    A contact e-mail for the zone.
    default_ttl int
    Default time to live.
    description str
    Description of the zone.
    expire_time int
    Expire time.
    id str
    is_reverse_zone bool
    Specifies, if the zone is a reverse zone or not.
    name str
    The user given name of the zone.
    negative_cache int
    Negative caching.
    primaries Sequence[str]
    Primary name server for secondary zone.
    primary_name_server str
    Primary name server. FQDN.
    project_id str
    STACKIT project ID to which the dns zone is associated.
    record_count int
    Record count how many records are in the zone.
    refresh_time int
    Refresh time.
    retry_time int
    Retry time.
    serial_number int
    Serial number.
    state str
    Zone state.
    type str
    Zone type.
    visibility str
    Visibility of the zone.
    dns_name str
    The zone name. E.g. example.com
    zone_id str
    The zone ID.
    acl String
    The access control list.
    active Boolean
    contactEmail String
    A contact e-mail for the zone.
    defaultTtl Number
    Default time to live.
    description String
    Description of the zone.
    expireTime Number
    Expire time.
    id String
    isReverseZone Boolean
    Specifies, if the zone is a reverse zone or not.
    name String
    The user given name of the zone.
    negativeCache Number
    Negative caching.
    primaries List<String>
    Primary name server for secondary zone.
    primaryNameServer String
    Primary name server. FQDN.
    projectId String
    STACKIT project ID to which the dns zone is associated.
    recordCount Number
    Record count how many records are in the zone.
    refreshTime Number
    Refresh time.
    retryTime Number
    Retry time.
    serialNumber Number
    Serial number.
    state String
    Zone state.
    type String
    Zone type.
    visibility String
    Visibility of the zone.
    dnsName String
    The zone name. E.g. example.com
    zoneId String
    The zone ID.

    Package Details

    Repository
    stackit stackitcloud/pulumi-stackit
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the stackit Terraform Provider.
    stackit logo
    Viewing docs for stackit v0.0.4
    published on Friday, Feb 20, 2026 by stackitcloud
      Try Pulumi Cloud free. Your team will thank you.