1. Packages
  2. Ionoscloud Provider
  3. API Docs
  4. getIpfailover
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionoscloud.getIpfailover

Explore with Pulumi AI

ionoscloud logo
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

    The IP Failover data source can be used to search for and return an existing IP Failover object. You need to provide the datacenter_id and the id of the lan to get the ip failover object for the provided datacenter. If a single match is found, it will be returned. If your search results in multiple matches, an error will be returned.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as ionoscloud from "@pulumi/ionoscloud";
    
    const example = ionoscloud.getIpfailover({
        datacenterId: "datacenter_id",
        lanId: "lan_id",
    });
    
    import pulumi
    import pulumi_ionoscloud as ionoscloud
    
    example = ionoscloud.get_ipfailover(datacenter_id="datacenter_id",
        lan_id="lan_id")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ionoscloud/v6/ionoscloud"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ionoscloud.LookupIpfailover(ctx, &ionoscloud.LookupIpfailoverArgs{
    			DatacenterId: "datacenter_id",
    			LanId:        "lan_id",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ionoscloud = Pulumi.Ionoscloud;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Ionoscloud.GetIpfailover.Invoke(new()
        {
            DatacenterId = "datacenter_id",
            LanId = "lan_id",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ionoscloud.IonoscloudFunctions;
    import com.pulumi.ionoscloud.inputs.GetIpfailoverArgs;
    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 example = IonoscloudFunctions.getIpfailover(GetIpfailoverArgs.builder()
                .datacenterId("datacenter_id")
                .lanId("lan_id")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: ionoscloud:getIpfailover
          arguments:
            datacenterId: datacenter_id
            lanId: lan_id
    

    Using getIpfailover

    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 getIpfailover(args: GetIpfailoverArgs, opts?: InvokeOptions): Promise<GetIpfailoverResult>
    function getIpfailoverOutput(args: GetIpfailoverOutputArgs, opts?: InvokeOptions): Output<GetIpfailoverResult>
    def get_ipfailover(datacenter_id: Optional[str] = None,
                       ip: Optional[str] = None,
                       lan_id: Optional[str] = None,
                       timeouts: Optional[GetIpfailoverTimeouts] = None,
                       opts: Optional[InvokeOptions] = None) -> GetIpfailoverResult
    def get_ipfailover_output(datacenter_id: Optional[pulumi.Input[str]] = None,
                       ip: Optional[pulumi.Input[str]] = None,
                       lan_id: Optional[pulumi.Input[str]] = None,
                       timeouts: Optional[pulumi.Input[GetIpfailoverTimeoutsArgs]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetIpfailoverResult]
    func LookupIpfailover(ctx *Context, args *LookupIpfailoverArgs, opts ...InvokeOption) (*LookupIpfailoverResult, error)
    func LookupIpfailoverOutput(ctx *Context, args *LookupIpfailoverOutputArgs, opts ...InvokeOption) LookupIpfailoverResultOutput

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

    public static class GetIpfailover 
    {
        public static Task<GetIpfailoverResult> InvokeAsync(GetIpfailoverArgs args, InvokeOptions? opts = null)
        public static Output<GetIpfailoverResult> Invoke(GetIpfailoverInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetIpfailoverResult> getIpfailover(GetIpfailoverArgs args, InvokeOptions options)
    public static Output<GetIpfailoverResult> getIpfailover(GetIpfailoverArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ionoscloud:index/getIpfailover:getIpfailover
      arguments:
        # arguments dictionary

    The following arguments are supported:

    DatacenterId string
    The ID of the datacenter containing the ip failover datasource
    Ip string
    The reserved IP address to be used in the IP failover group.
    LanId string
    The id of the lan of which the IP failover belongs
    Timeouts GetIpfailoverTimeouts
    DatacenterId string
    The ID of the datacenter containing the ip failover datasource
    Ip string
    The reserved IP address to be used in the IP failover group.
    LanId string
    The id of the lan of which the IP failover belongs
    Timeouts GetIpfailoverTimeouts
    datacenterId String
    The ID of the datacenter containing the ip failover datasource
    ip String
    The reserved IP address to be used in the IP failover group.
    lanId String
    The id of the lan of which the IP failover belongs
    timeouts GetIpfailoverTimeouts
    datacenterId string
    The ID of the datacenter containing the ip failover datasource
    ip string
    The reserved IP address to be used in the IP failover group.
    lanId string
    The id of the lan of which the IP failover belongs
    timeouts GetIpfailoverTimeouts
    datacenter_id str
    The ID of the datacenter containing the ip failover datasource
    ip str
    The reserved IP address to be used in the IP failover group.
    lan_id str
    The id of the lan of which the IP failover belongs
    timeouts GetIpfailoverTimeouts
    datacenterId String
    The ID of the datacenter containing the ip failover datasource
    ip String
    The reserved IP address to be used in the IP failover group.
    lanId String
    The id of the lan of which the IP failover belongs
    timeouts Property Map

    getIpfailover Result

    The following output properties are available:

    DatacenterId string
    The ID of a Data Center.
    Id string
    Ip string
    The reserved IP address to be used in the IP failover group.
    LanId string
    The ID of a LAN.
    Nicuuid string
    The ID of a NIC.
    Timeouts GetIpfailoverTimeouts
    DatacenterId string
    The ID of a Data Center.
    Id string
    Ip string
    The reserved IP address to be used in the IP failover group.
    LanId string
    The ID of a LAN.
    Nicuuid string
    The ID of a NIC.
    Timeouts GetIpfailoverTimeouts
    datacenterId String
    The ID of a Data Center.
    id String
    ip String
    The reserved IP address to be used in the IP failover group.
    lanId String
    The ID of a LAN.
    nicuuid String
    The ID of a NIC.
    timeouts GetIpfailoverTimeouts
    datacenterId string
    The ID of a Data Center.
    id string
    ip string
    The reserved IP address to be used in the IP failover group.
    lanId string
    The ID of a LAN.
    nicuuid string
    The ID of a NIC.
    timeouts GetIpfailoverTimeouts
    datacenter_id str
    The ID of a Data Center.
    id str
    ip str
    The reserved IP address to be used in the IP failover group.
    lan_id str
    The ID of a LAN.
    nicuuid str
    The ID of a NIC.
    timeouts GetIpfailoverTimeouts
    datacenterId String
    The ID of a Data Center.
    id String
    ip String
    The reserved IP address to be used in the IP failover group.
    lanId String
    The ID of a LAN.
    nicuuid String
    The ID of a NIC.
    timeouts Property Map

    Supporting Types

    GetIpfailoverTimeouts

    Create string
    Default string
    Delete string
    Update string
    Create string
    Default string
    Delete string
    Update string
    create String
    default_ String
    delete String
    update String
    create string
    default string
    delete string
    update string
    create String
    default String
    delete String
    update String

    Package Details

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