1. Packages
  2. Packages
  3. OVH
  4. API Docs
  5. getCloudFloatingIps
Viewing docs for OVHCloud v2.17.0
published on Friday, Jul 17, 2026 by OVHcloud
ovh logo
Viewing docs for OVHCloud v2.17.0
published on Friday, Jul 17, 2026 by OVHcloud

    Use this data source to list the floating IPs of a public cloud project.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as ovh from "@ovhcloud/pulumi-ovh";
    
    const ips = ovh.getCloudFloatingIps({
        serviceName: "<public cloud project ID>",
    });
    export const floatingIpAddresses = ips.then(ips => .map(ip => (ip.id)));
    
    import pulumi
    import pulumi_ovh as ovh
    
    ips = ovh.get_cloud_floating_ips(service_name="<public cloud project ID>")
    pulumi.export("floatingIpAddresses", [ip.id for ip in ips.floating_ips])
    
    Example coming soon!
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ovh = Pulumi.Ovh;
    
    return await Deployment.RunAsync(() => 
    {
        var ips = Ovh.GetCloudFloatingIps.Invoke(new()
        {
            ServiceName = "<public cloud project ID>",
        });
    
        return new Dictionary<string, object?>
        {
            ["floatingIpAddresses"] = .Select(ip => 
            {
                return ip.Id;
            }).ToList(),
        };
    });
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    

    Using getCloudFloatingIps

    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 getCloudFloatingIps(args: GetCloudFloatingIpsArgs, opts?: InvokeOptions): Promise<GetCloudFloatingIpsResult>
    function getCloudFloatingIpsOutput(args: GetCloudFloatingIpsOutputArgs, opts?: InvokeOptions): Output<GetCloudFloatingIpsResult>
    def get_cloud_floating_ips(service_name: Optional[str] = None,
                               opts: Optional[InvokeOptions] = None) -> GetCloudFloatingIpsResult
    def get_cloud_floating_ips_output(service_name: pulumi.Input[Optional[str]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetCloudFloatingIpsResult]
    func GetCloudFloatingIps(ctx *Context, args *GetCloudFloatingIpsArgs, opts ...InvokeOption) (*GetCloudFloatingIpsResult, error)
    func GetCloudFloatingIpsOutput(ctx *Context, args *GetCloudFloatingIpsOutputArgs, opts ...InvokeOption) GetCloudFloatingIpsResultOutput

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

    public static class GetCloudFloatingIps 
    {
        public static Task<GetCloudFloatingIpsResult> InvokeAsync(GetCloudFloatingIpsArgs args, InvokeOptions? opts = null)
        public static Output<GetCloudFloatingIpsResult> Invoke(GetCloudFloatingIpsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetCloudFloatingIpsResult> getCloudFloatingIps(GetCloudFloatingIpsArgs args, InvokeOptions options)
    public static Output<GetCloudFloatingIpsResult> getCloudFloatingIps(GetCloudFloatingIpsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ovh:index/getCloudFloatingIps:getCloudFloatingIps
      arguments:
        # arguments dictionary
    data "ovh_get_cloud_floating_ips" "name" {
        # arguments
    }

    The following arguments are supported:

    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.
    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.
    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.
    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.
    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.
    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.
    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.

    getCloudFloatingIps Result

    The following output properties are available:

    FloatingIps List<GetCloudFloatingIpsFloatingIp>
    List of floating IPs. Each element exports:
    Id string
    The provider-assigned unique ID for this managed resource.
    ServiceName string
    FloatingIps []GetCloudFloatingIpsFloatingIp
    List of floating IPs. Each element exports:
    Id string
    The provider-assigned unique ID for this managed resource.
    ServiceName string
    floating_ips list(object)
    List of floating IPs. Each element exports:
    id string
    The provider-assigned unique ID for this managed resource.
    service_name string
    floatingIps List<GetCloudFloatingIpsFloatingIp>
    List of floating IPs. Each element exports:
    id String
    The provider-assigned unique ID for this managed resource.
    serviceName String
    floatingIps GetCloudFloatingIpsFloatingIp[]
    List of floating IPs. Each element exports:
    id string
    The provider-assigned unique ID for this managed resource.
    serviceName string
    floating_ips Sequence[GetCloudFloatingIpsFloatingIp]
    List of floating IPs. Each element exports:
    id str
    The provider-assigned unique ID for this managed resource.
    service_name str
    floatingIps List<Property Map>
    List of floating IPs. Each element exports:
    id String
    The provider-assigned unique ID for this managed resource.
    serviceName String

    Supporting Types

    GetCloudFloatingIpsFloatingIp

    Checksum string
    Computed hash representing the current target specification value.
    CreatedAt string
    Creation date of the floating IP.
    CurrentState GetCloudFloatingIpsFloatingIpCurrentState
    Current state of the floating IP:
    CurrentTasks List<GetCloudFloatingIpsFloatingIpCurrentTask>
    Ongoing asynchronous tasks related to the floating IP. Each element exports:
    Description string
    Description of the floating IP.
    Id string
    Identifier of the current task.
    Location GetCloudFloatingIpsFloatingIpLocation
    Location details:
    ResourceStatus string
    Floating IP readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    UpdatedAt string
    Last update date of the floating IP.
    Checksum string
    Computed hash representing the current target specification value.
    CreatedAt string
    Creation date of the floating IP.
    CurrentState GetCloudFloatingIpsFloatingIpCurrentState
    Current state of the floating IP:
    CurrentTasks []GetCloudFloatingIpsFloatingIpCurrentTask
    Ongoing asynchronous tasks related to the floating IP. Each element exports:
    Description string
    Description of the floating IP.
    Id string
    Identifier of the current task.
    Location GetCloudFloatingIpsFloatingIpLocation
    Location details:
    ResourceStatus string
    Floating IP readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    UpdatedAt string
    Last update date of the floating IP.
    checksum string
    Computed hash representing the current target specification value.
    created_at string
    Creation date of the floating IP.
    current_state object
    Current state of the floating IP:
    current_tasks list(object)
    Ongoing asynchronous tasks related to the floating IP. Each element exports:
    description string
    Description of the floating IP.
    id string
    Identifier of the current task.
    location object
    Location details:
    resource_status string
    Floating IP readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updated_at string
    Last update date of the floating IP.
    checksum String
    Computed hash representing the current target specification value.
    createdAt String
    Creation date of the floating IP.
    currentState GetCloudFloatingIpsFloatingIpCurrentState
    Current state of the floating IP:
    currentTasks List<GetCloudFloatingIpsFloatingIpCurrentTask>
    Ongoing asynchronous tasks related to the floating IP. Each element exports:
    description String
    Description of the floating IP.
    id String
    Identifier of the current task.
    location GetCloudFloatingIpsFloatingIpLocation
    Location details:
    resourceStatus String
    Floating IP readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updatedAt String
    Last update date of the floating IP.
    checksum string
    Computed hash representing the current target specification value.
    createdAt string
    Creation date of the floating IP.
    currentState GetCloudFloatingIpsFloatingIpCurrentState
    Current state of the floating IP:
    currentTasks GetCloudFloatingIpsFloatingIpCurrentTask[]
    Ongoing asynchronous tasks related to the floating IP. Each element exports:
    description string
    Description of the floating IP.
    id string
    Identifier of the current task.
    location GetCloudFloatingIpsFloatingIpLocation
    Location details:
    resourceStatus string
    Floating IP readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updatedAt string
    Last update date of the floating IP.
    checksum str
    Computed hash representing the current target specification value.
    created_at str
    Creation date of the floating IP.
    current_state GetCloudFloatingIpsFloatingIpCurrentState
    Current state of the floating IP:
    current_tasks Sequence[GetCloudFloatingIpsFloatingIpCurrentTask]
    Ongoing asynchronous tasks related to the floating IP. Each element exports:
    description str
    Description of the floating IP.
    id str
    Identifier of the current task.
    location GetCloudFloatingIpsFloatingIpLocation
    Location details:
    resource_status str
    Floating IP readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updated_at str
    Last update date of the floating IP.
    checksum String
    Computed hash representing the current target specification value.
    createdAt String
    Creation date of the floating IP.
    currentState Property Map
    Current state of the floating IP:
    currentTasks List<Property Map>
    Ongoing asynchronous tasks related to the floating IP. Each element exports:
    description String
    Description of the floating IP.
    id String
    Identifier of the current task.
    location Property Map
    Location details:
    resourceStatus String
    Floating IP readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY, UPDATING).
    updatedAt String
    Last update date of the floating IP.

    GetCloudFloatingIpsFloatingIpCurrentState

    AssociatedResource GetCloudFloatingIpsFloatingIpCurrentStateAssociatedResource
    Resource the floating IP is currently attached to. Null when the floating IP is not attached to any resource:
    Description string
    Description of the floating IP.
    Id string
    Identifier of the current task.
    Ip string
    IP address of the floating IP.
    Location GetCloudFloatingIpsFloatingIpCurrentStateLocation
    Location details:
    Network GetCloudFloatingIpsFloatingIpCurrentStateNetwork
    External network the floating IP belongs to:
    Status string
    Current global status of the current task.
    AssociatedResource GetCloudFloatingIpsFloatingIpCurrentStateAssociatedResource
    Resource the floating IP is currently attached to. Null when the floating IP is not attached to any resource:
    Description string
    Description of the floating IP.
    Id string
    Identifier of the current task.
    Ip string
    IP address of the floating IP.
    Location GetCloudFloatingIpsFloatingIpCurrentStateLocation
    Location details:
    Network GetCloudFloatingIpsFloatingIpCurrentStateNetwork
    External network the floating IP belongs to:
    Status string
    Current global status of the current task.
    associated_resource object
    Resource the floating IP is currently attached to. Null when the floating IP is not attached to any resource:
    description string
    Description of the floating IP.
    id string
    Identifier of the current task.
    ip string
    IP address of the floating IP.
    location object
    Location details:
    network object
    External network the floating IP belongs to:
    status string
    Current global status of the current task.
    associatedResource GetCloudFloatingIpsFloatingIpCurrentStateAssociatedResource
    Resource the floating IP is currently attached to. Null when the floating IP is not attached to any resource:
    description String
    Description of the floating IP.
    id String
    Identifier of the current task.
    ip String
    IP address of the floating IP.
    location GetCloudFloatingIpsFloatingIpCurrentStateLocation
    Location details:
    network GetCloudFloatingIpsFloatingIpCurrentStateNetwork
    External network the floating IP belongs to:
    status String
    Current global status of the current task.
    associatedResource GetCloudFloatingIpsFloatingIpCurrentStateAssociatedResource
    Resource the floating IP is currently attached to. Null when the floating IP is not attached to any resource:
    description string
    Description of the floating IP.
    id string
    Identifier of the current task.
    ip string
    IP address of the floating IP.
    location GetCloudFloatingIpsFloatingIpCurrentStateLocation
    Location details:
    network GetCloudFloatingIpsFloatingIpCurrentStateNetwork
    External network the floating IP belongs to:
    status string
    Current global status of the current task.
    associated_resource GetCloudFloatingIpsFloatingIpCurrentStateAssociatedResource
    Resource the floating IP is currently attached to. Null when the floating IP is not attached to any resource:
    description str
    Description of the floating IP.
    id str
    Identifier of the current task.
    ip str
    IP address of the floating IP.
    location GetCloudFloatingIpsFloatingIpCurrentStateLocation
    Location details:
    network GetCloudFloatingIpsFloatingIpCurrentStateNetwork
    External network the floating IP belongs to:
    status str
    Current global status of the current task.
    associatedResource Property Map
    Resource the floating IP is currently attached to. Null when the floating IP is not attached to any resource:
    description String
    Description of the floating IP.
    id String
    Identifier of the current task.
    ip String
    IP address of the floating IP.
    location Property Map
    Location details:
    network Property Map
    External network the floating IP belongs to:
    status String
    Current global status of the current task.

    GetCloudFloatingIpsFloatingIpCurrentStateAssociatedResource

    Id string
    Identifier of the current task.
    Type string
    Type of the current task.
    Id string
    Identifier of the current task.
    Type string
    Type of the current task.
    id string
    Identifier of the current task.
    type string
    Type of the current task.
    id String
    Identifier of the current task.
    type String
    Type of the current task.
    id string
    Identifier of the current task.
    type string
    Type of the current task.
    id str
    Identifier of the current task.
    type str
    Type of the current task.
    id String
    Identifier of the current task.
    type String
    Type of the current task.

    GetCloudFloatingIpsFloatingIpCurrentStateLocation

    AvailabilityZone string
    Availability zone.
    Region string
    Region.
    AvailabilityZone string
    Availability zone.
    Region string
    Region.
    availability_zone string
    Availability zone.
    region string
    Region.
    availabilityZone String
    Availability zone.
    region String
    Region.
    availabilityZone string
    Availability zone.
    region string
    Region.
    availability_zone str
    Availability zone.
    region str
    Region.
    availabilityZone String
    Availability zone.
    region String
    Region.

    GetCloudFloatingIpsFloatingIpCurrentStateNetwork

    Id string
    Identifier of the current task.
    Id string
    Identifier of the current task.
    id string
    Identifier of the current task.
    id String
    Identifier of the current task.
    id string
    Identifier of the current task.
    id str
    Identifier of the current task.
    id String
    Identifier of the current task.

    GetCloudFloatingIpsFloatingIpCurrentTask

    Errors List<GetCloudFloatingIpsFloatingIpCurrentTaskError>
    Errors that occurred on the task:
    Id string
    Identifier of the current task.
    Link string
    Link to the task details.
    Status string
    Current global status of the current task.
    Type string
    Type of the current task.
    Errors []GetCloudFloatingIpsFloatingIpCurrentTaskError
    Errors that occurred on the task:
    Id string
    Identifier of the current task.
    Link string
    Link to the task details.
    Status string
    Current global status of the current task.
    Type string
    Type of the current task.
    errors list(object)
    Errors that occurred on the task:
    id string
    Identifier of the current task.
    link string
    Link to the task details.
    status string
    Current global status of the current task.
    type string
    Type of the current task.
    errors List<GetCloudFloatingIpsFloatingIpCurrentTaskError>
    Errors that occurred on the task:
    id String
    Identifier of the current task.
    link String
    Link to the task details.
    status String
    Current global status of the current task.
    type String
    Type of the current task.
    errors GetCloudFloatingIpsFloatingIpCurrentTaskError[]
    Errors that occurred on the task:
    id string
    Identifier of the current task.
    link string
    Link to the task details.
    status string
    Current global status of the current task.
    type string
    Type of the current task.
    errors Sequence[GetCloudFloatingIpsFloatingIpCurrentTaskError]
    Errors that occurred on the task:
    id str
    Identifier of the current task.
    link str
    Link to the task details.
    status str
    Current global status of the current task.
    type str
    Type of the current task.
    errors List<Property Map>
    Errors that occurred on the task:
    id String
    Identifier of the current task.
    link String
    Link to the task details.
    status String
    Current global status of the current task.
    type String
    Type of the current task.

    GetCloudFloatingIpsFloatingIpCurrentTaskError

    Message string
    Error description.
    Message string
    Error description.
    message string
    Error description.
    message String
    Error description.
    message string
    Error description.
    message str
    Error description.
    message String
    Error description.

    GetCloudFloatingIpsFloatingIpLocation

    AvailabilityZone string
    Availability zone.
    Region string
    Region.
    AvailabilityZone string
    Availability zone.
    Region string
    Region.
    availability_zone string
    Availability zone.
    region string
    Region.
    availabilityZone String
    Availability zone.
    region String
    Region.
    availabilityZone string
    Availability zone.
    region string
    Region.
    availability_zone str
    Availability zone.
    region str
    Region.
    availabilityZone String
    Availability zone.
    region String
    Region.

    Package Details

    Repository
    ovh ovh/pulumi-ovh
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ovh Terraform Provider.
    ovh logo
    Viewing docs for OVHCloud v2.17.0
    published on Friday, Jul 17, 2026 by OVHcloud

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial