getCloudFloatingIp

OVHCloud v2.17.0, Jul 17 26

Viewing docs for OVHCloud v2.17.0
published on Friday, Jul 17, 2026 by OVHcloud

Schema (JSON)

ovh/pulumi-ovh

Viewing docs for OVHCloud v2.17.0
published on Friday, Jul 17, 2026 by OVHcloud

Schema (JSON)

ovh/pulumi-ovh

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as ovh from "@ovhcloud/pulumi-ovh";

const ip = ovh.getCloudFloatingIp({
    serviceName: "<public cloud project ID>",
    id: "<floating IP address>",
});
export const floatingIpStatus = ip.then(ip => ip.resourceStatus);

import pulumi
import pulumi_ovh as ovh

ip = ovh.get_cloud_floating_ip(service_name="<public cloud project ID>",
    id="<floating IP address>")
pulumi.export("floatingIpStatus", ip.resource_status)

package main

import (
	"github.com/ovh/pulumi-ovh/sdk/v2/go/ovh"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		ip, err := ovh.LookupCloudFloatingIp(ctx, &ovh.LookupCloudFloatingIpArgs{
			ServiceName: pulumi.StringRef("<public cloud project ID>"),
			Id:          "<floating IP address>",
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("floatingIpStatus", ip.ResourceStatus)
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ovh = Pulumi.Ovh;

return await Deployment.RunAsync(() => 
{
    var ip = Ovh.GetCloudFloatingIp.Invoke(new()
    {
        ServiceName = "<public cloud project ID>",
        Id = "<floating IP address>",
    });

    return new Dictionary<string, object?>
    {
        ["floatingIpStatus"] = ip.Apply(getCloudFloatingIpResult => getCloudFloatingIpResult.ResourceStatus),
    };
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ovh.OvhFunctions;
import com.pulumi.ovh.inputs.GetCloudFloatingIpArgs;
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 ip = OvhFunctions.getCloudFloatingIp(GetCloudFloatingIpArgs.builder()
            .serviceName("<public cloud project ID>")
            .id("<floating IP address>")
            .build());

        ctx.export("floatingIpStatus", ip.resourceStatus());
    }
}

variables:
  ip:
    fn::invoke:
      function: ovh:getCloudFloatingIp
      arguments:
        serviceName: <public cloud project ID>
        id: <floating IP address>
outputs:
  floatingIpStatus: ${ip.resourceStatus}

Example coming soon!

Using getCloudFloatingIp

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 getCloudFloatingIp(args: GetCloudFloatingIpArgs, opts?: InvokeOptions): Promise<GetCloudFloatingIpResult>
function getCloudFloatingIpOutput(args: GetCloudFloatingIpOutputArgs, opts?: InvokeOptions): Output<GetCloudFloatingIpResult>

def get_cloud_floating_ip(id: Optional[str] = None,
                          service_name: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetCloudFloatingIpResult
def get_cloud_floating_ip_output(id: pulumi.Input[Optional[str]] = None,
                          service_name: pulumi.Input[Optional[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetCloudFloatingIpResult]

func LookupCloudFloatingIp(ctx *Context, args *LookupCloudFloatingIpArgs, opts ...InvokeOption) (*LookupCloudFloatingIpResult, error)
func LookupCloudFloatingIpOutput(ctx *Context, args *LookupCloudFloatingIpOutputArgs, opts ...InvokeOption) LookupCloudFloatingIpResultOutput

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

public static class GetCloudFloatingIp 
{
    public static Task<GetCloudFloatingIpResult> InvokeAsync(GetCloudFloatingIpArgs args, InvokeOptions? opts = null)
    public static Output<GetCloudFloatingIpResult> Invoke(GetCloudFloatingIpInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetCloudFloatingIpResult> getCloudFloatingIp(GetCloudFloatingIpArgs args, InvokeOptions options)
public static Output<GetCloudFloatingIpResult> getCloudFloatingIp(GetCloudFloatingIpArgs args, InvokeOptions options)

fn::invoke:
  function: ovh:index/getCloudFloatingIp:getCloudFloatingIp
  arguments:
    # arguments dictionary

data "ovh_get_cloud_floating_ip" "name" {
    # arguments
}

The following arguments are supported:

Id string: IP address of the floating IP.
ServiceName string: Service name of the resource representing the id of the cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.

Id string: IP address of the floating IP.
ServiceName string: Service name of the resource representing the id of the cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.

id string: IP address of the floating IP.
service_name string: Service name of the resource representing the id of the cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.

id String: IP address of the floating IP.
serviceName String: Service name of the resource representing the id of the cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.

id string: IP address of the floating IP.
serviceName string: Service name of the resource representing the id of the cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.

id str: IP address of the floating IP.
service_name str: Service name of the resource representing the id of the cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.

id String: IP address of the floating IP.
serviceName String: Service name of the resource representing the id of the cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.