1. Packages
  2. Ibm Provider
  3. API Docs
  4. getDnsGlbs
ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud

ibm.getDnsGlbs

Explore with Pulumi AI

ibm logo
ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud

    Retrieve the details of an existing IBM Cloud infrastructure private DNS Global Load Balancers as a read-only data source. For more information, see working with global Load Balancers.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const test1 = ibm.getDnsGlbs({
        instanceId: ibm_resource_instance["test-pdns-instance"].guid,
        zoneId: ibm_dns_zone["test-pdns-zone"].zone_id,
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    test1 = ibm.get_dns_glbs(instance_id=ibm_resource_instance["test-pdns-instance"]["guid"],
        zone_id=ibm_dns_zone["test-pdns-zone"]["zone_id"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.GetDnsGlbs(ctx, &ibm.GetDnsGlbsArgs{
    			InstanceId: ibm_resource_instance.TestPdnsInstance.Guid,
    			ZoneId:     ibm_dns_zone.TestPdnsZone.Zone_id,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var test1 = Ibm.GetDnsGlbs.Invoke(new()
        {
            InstanceId = ibm_resource_instance.Test_pdns_instance.Guid,
            ZoneId = ibm_dns_zone.Test_pdns_zone.Zone_id,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IbmFunctions;
    import com.pulumi.ibm.inputs.GetDnsGlbsArgs;
    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) {
            final var test1 = IbmFunctions.getDnsGlbs(GetDnsGlbsArgs.builder()
                .instanceId(ibm_resource_instance.test-pdns-instance().guid())
                .zoneId(ibm_dns_zone.test-pdns-zone().zone_id())
                .build());
    
        }
    }
    
    variables:
      test1:
        fn::invoke:
          function: ibm:getDnsGlbs
          arguments:
            instanceId: ${ibm_resource_instance"test-pdns-instance"[%!s(MISSING)].guid}
            zoneId: ${ibm_dns_zone"test-pdns-zone"[%!s(MISSING)].zone_id}
    

    Using getDnsGlbs

    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 getDnsGlbs(args: GetDnsGlbsArgs, opts?: InvokeOptions): Promise<GetDnsGlbsResult>
    function getDnsGlbsOutput(args: GetDnsGlbsOutputArgs, opts?: InvokeOptions): Output<GetDnsGlbsResult>
    def get_dns_glbs(id: Optional[str] = None,
                     instance_id: Optional[str] = None,
                     zone_id: Optional[str] = None,
                     opts: Optional[InvokeOptions] = None) -> GetDnsGlbsResult
    def get_dns_glbs_output(id: Optional[pulumi.Input[str]] = None,
                     instance_id: Optional[pulumi.Input[str]] = None,
                     zone_id: Optional[pulumi.Input[str]] = None,
                     opts: Optional[InvokeOptions] = None) -> Output[GetDnsGlbsResult]
    func GetDnsGlbs(ctx *Context, args *GetDnsGlbsArgs, opts ...InvokeOption) (*GetDnsGlbsResult, error)
    func GetDnsGlbsOutput(ctx *Context, args *GetDnsGlbsOutputArgs, opts ...InvokeOption) GetDnsGlbsResultOutput

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

    public static class GetDnsGlbs 
    {
        public static Task<GetDnsGlbsResult> InvokeAsync(GetDnsGlbsArgs args, InvokeOptions? opts = null)
        public static Output<GetDnsGlbsResult> Invoke(GetDnsGlbsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDnsGlbsResult> getDnsGlbs(GetDnsGlbsArgs args, InvokeOptions options)
    public static Output<GetDnsGlbsResult> getDnsGlbs(GetDnsGlbsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getDnsGlbs:getDnsGlbs
      arguments:
        # arguments dictionary

    The following arguments are supported:

    InstanceId string
    The GUID of the private DNS service instance.
    ZoneId string
    The ID of the private DNS zone.
    Id string
    InstanceId string
    The GUID of the private DNS service instance.
    ZoneId string
    The ID of the private DNS zone.
    Id string
    instanceId String
    The GUID of the private DNS service instance.
    zoneId String
    The ID of the private DNS zone.
    id String
    instanceId string
    The GUID of the private DNS service instance.
    zoneId string
    The ID of the private DNS zone.
    id string
    instance_id str
    The GUID of the private DNS service instance.
    zone_id str
    The ID of the private DNS zone.
    id str
    instanceId String
    The GUID of the private DNS service instance.
    zoneId String
    The ID of the private DNS zone.
    id String

    getDnsGlbs Result

    The following output properties are available:

    DnsGlbs List<GetDnsGlbsDnsGlb>
    (List) List of all private DNS Load balancers in the IBM Cloud infrastructure.
    Id string
    InstanceId string
    ZoneId string
    DnsGlbs []GetDnsGlbsDnsGlb
    (List) List of all private DNS Load balancers in the IBM Cloud infrastructure.
    Id string
    InstanceId string
    ZoneId string
    dnsGlbs List<GetDnsGlbsDnsGlb>
    (List) List of all private DNS Load balancers in the IBM Cloud infrastructure.
    id String
    instanceId String
    zoneId String
    dnsGlbs GetDnsGlbsDnsGlb[]
    (List) List of all private DNS Load balancers in the IBM Cloud infrastructure.
    id string
    instanceId string
    zoneId string
    dns_glbs Sequence[GetDnsGlbsDnsGlb]
    (List) List of all private DNS Load balancers in the IBM Cloud infrastructure.
    id str
    instance_id str
    zone_id str
    dnsGlbs List<Property Map>
    (List) List of all private DNS Load balancers in the IBM Cloud infrastructure.
    id String
    instanceId String
    zoneId String

    Supporting Types

    GetDnsGlbsDnsGlb

    AzPools List<GetDnsGlbsDnsGlbAzPool>
    (List) Map availability zones to the pool ID's.
    CreatedOn string
    (Timestamp) The date and time when the Load Balancer was created.
    DefaultPools List<string>
    (String) TA list of pool IDs ordered by their failover priority.
    Description string
    (String) The descriptive text of the DNS Load balancers.
    Enabled bool
    FallbackPool string
    (String) The pool ID to use when all other pools are detected as unhealthy.
    GlbId string
    (String) The Load Balancer ID.
    Health string
    (String) Healthy state of the Load Balancer. Possible values are DOWN, UP, or DEGRADED.
    ModifiedOn string
    (Timestamp) The date and time when the Load Balancer was modified.
    Name string
    (String) The name of the DNS Load balancers.
    Ttl double
    (String) The time to live in second.
    AzPools []GetDnsGlbsDnsGlbAzPool
    (List) Map availability zones to the pool ID's.
    CreatedOn string
    (Timestamp) The date and time when the Load Balancer was created.
    DefaultPools []string
    (String) TA list of pool IDs ordered by their failover priority.
    Description string
    (String) The descriptive text of the DNS Load balancers.
    Enabled bool
    FallbackPool string
    (String) The pool ID to use when all other pools are detected as unhealthy.
    GlbId string
    (String) The Load Balancer ID.
    Health string
    (String) Healthy state of the Load Balancer. Possible values are DOWN, UP, or DEGRADED.
    ModifiedOn string
    (Timestamp) The date and time when the Load Balancer was modified.
    Name string
    (String) The name of the DNS Load balancers.
    Ttl float64
    (String) The time to live in second.
    azPools List<GetDnsGlbsDnsGlbAzPool>
    (List) Map availability zones to the pool ID's.
    createdOn String
    (Timestamp) The date and time when the Load Balancer was created.
    defaultPools List<String>
    (String) TA list of pool IDs ordered by their failover priority.
    description String
    (String) The descriptive text of the DNS Load balancers.
    enabled Boolean
    fallbackPool String
    (String) The pool ID to use when all other pools are detected as unhealthy.
    glbId String
    (String) The Load Balancer ID.
    health String
    (String) Healthy state of the Load Balancer. Possible values are DOWN, UP, or DEGRADED.
    modifiedOn String
    (Timestamp) The date and time when the Load Balancer was modified.
    name String
    (String) The name of the DNS Load balancers.
    ttl Double
    (String) The time to live in second.
    azPools GetDnsGlbsDnsGlbAzPool[]
    (List) Map availability zones to the pool ID's.
    createdOn string
    (Timestamp) The date and time when the Load Balancer was created.
    defaultPools string[]
    (String) TA list of pool IDs ordered by their failover priority.
    description string
    (String) The descriptive text of the DNS Load balancers.
    enabled boolean
    fallbackPool string
    (String) The pool ID to use when all other pools are detected as unhealthy.
    glbId string
    (String) The Load Balancer ID.
    health string
    (String) Healthy state of the Load Balancer. Possible values are DOWN, UP, or DEGRADED.
    modifiedOn string
    (Timestamp) The date and time when the Load Balancer was modified.
    name string
    (String) The name of the DNS Load balancers.
    ttl number
    (String) The time to live in second.
    az_pools Sequence[GetDnsGlbsDnsGlbAzPool]
    (List) Map availability zones to the pool ID's.
    created_on str
    (Timestamp) The date and time when the Load Balancer was created.
    default_pools Sequence[str]
    (String) TA list of pool IDs ordered by their failover priority.
    description str
    (String) The descriptive text of the DNS Load balancers.
    enabled bool
    fallback_pool str
    (String) The pool ID to use when all other pools are detected as unhealthy.
    glb_id str
    (String) The Load Balancer ID.
    health str
    (String) Healthy state of the Load Balancer. Possible values are DOWN, UP, or DEGRADED.
    modified_on str
    (Timestamp) The date and time when the Load Balancer was modified.
    name str
    (String) The name of the DNS Load balancers.
    ttl float
    (String) The time to live in second.
    azPools List<Property Map>
    (List) Map availability zones to the pool ID's.
    createdOn String
    (Timestamp) The date and time when the Load Balancer was created.
    defaultPools List<String>
    (String) TA list of pool IDs ordered by their failover priority.
    description String
    (String) The descriptive text of the DNS Load balancers.
    enabled Boolean
    fallbackPool String
    (String) The pool ID to use when all other pools are detected as unhealthy.
    glbId String
    (String) The Load Balancer ID.
    health String
    (String) Healthy state of the Load Balancer. Possible values are DOWN, UP, or DEGRADED.
    modifiedOn String
    (Timestamp) The date and time when the Load Balancer was modified.
    name String
    (String) The name of the DNS Load balancers.
    ttl Number
    (String) The time to live in second.

    GetDnsGlbsDnsGlbAzPool

    AvailabilityZone string
    (String) The availability zone.
    Pools List<string>
    (String) List of Load Balancer pools.
    AvailabilityZone string
    (String) The availability zone.
    Pools []string
    (String) List of Load Balancer pools.
    availabilityZone String
    (String) The availability zone.
    pools List<String>
    (String) List of Load Balancer pools.
    availabilityZone string
    (String) The availability zone.
    pools string[]
    (String) List of Load Balancer pools.
    availability_zone str
    (String) The availability zone.
    pools Sequence[str]
    (String) List of Load Balancer pools.
    availabilityZone String
    (String) The availability zone.
    pools List<String>
    (String) List of Load Balancer pools.

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud