getCloudFloatingIp

gcore 2.0.0-alpha.3, Mar 30 26

Viewing docs for gcore 2.0.0-alpha.3
published on Monday, Mar 30, 2026 by g-core

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as gcore from "@pulumi/gcore";

const exampleCloudFloatingIp = gcore.getCloudFloatingIp({
    projectId: 1,
    regionId: 1,
    floatingIpId: "c64e5db1-5f1f-43ec-a8d9-5090df85b82d",
});

import pulumi
import pulumi_gcore as gcore

example_cloud_floating_ip = gcore.get_cloud_floating_ip(project_id=1,
    region_id=1,
    floating_ip_id="c64e5db1-5f1f-43ec-a8d9-5090df85b82d")

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := gcore.LookupCloudFloatingIp(ctx, &gcore.LookupCloudFloatingIpArgs{
			ProjectId:    pulumi.Float64Ref(1),
			RegionId:     pulumi.Float64Ref(1),
			FloatingIpId: pulumi.StringRef("c64e5db1-5f1f-43ec-a8d9-5090df85b82d"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var exampleCloudFloatingIp = Gcore.GetCloudFloatingIp.Invoke(new()
    {
        ProjectId = 1,
        RegionId = 1,
        FloatingIpId = "c64e5db1-5f1f-43ec-a8d9-5090df85b82d",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.GcoreFunctions;
import com.pulumi.gcore.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 exampleCloudFloatingIp = GcoreFunctions.getCloudFloatingIp(GetCloudFloatingIpArgs.builder()
            .projectId(1)
            .regionId(1)
            .floatingIpId("c64e5db1-5f1f-43ec-a8d9-5090df85b82d")
            .build());

    }
}

variables:
  exampleCloudFloatingIp:
    fn::invoke:
      function: gcore:getCloudFloatingIp
      arguments:
        projectId: 1
        regionId: 1
        floatingIpId: c64e5db1-5f1f-43ec-a8d9-5090df85b82d

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(find_one_by: Optional[GetCloudFloatingIpFindOneBy] = None,
                          floating_ip_id: Optional[str] = None,
                          project_id: Optional[float] = None,
                          region_id: Optional[float] = None,
                          opts: Optional[InvokeOptions] = None) -> GetCloudFloatingIpResult
def get_cloud_floating_ip_output(find_one_by: Optional[pulumi.Input[GetCloudFloatingIpFindOneByArgs]] = None,
                          floating_ip_id: Optional[pulumi.Input[str]] = None,
                          project_id: Optional[pulumi.Input[float]] = None,
                          region_id: Optional[pulumi.Input[float]] = 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: gcore:index/getCloudFloatingIp:getCloudFloatingIp
  arguments:
    # arguments dictionary

The following arguments are supported:

FindOneBy GetCloudFloatingIpFindOneBy
FloatingIpId string: Floating IP ID
ProjectId double: Project ID
RegionId double: Region ID

FindOneBy GetCloudFloatingIpFindOneBy
FloatingIpId string: Floating IP ID
ProjectId float64: Project ID
RegionId float64: Region ID

findOneBy GetCloudFloatingIpFindOneBy
floatingIpId String: Floating IP ID
projectId Double: Project ID
regionId Double: Region ID

findOneBy GetCloudFloatingIpFindOneBy
floatingIpId string: Floating IP ID
projectId number: Project ID
regionId number: Region ID

find_one_by GetCloudFloatingIpFindOneBy
floating_ip_id str: Floating IP ID
project_id float: Project ID
region_id float: Region ID

findOneBy Property Map
floatingIpId String: Floating IP ID
projectId Number: Project ID
regionId Number: Region ID

getCloudFloatingIp Result

The following output properties are available:

CreatedAt string: Datetime when the floating IP was created
CreatorTaskId string: Task that created this entity
FixedIpAddress string: IP address of the port the floating IP is attached to
FloatingIpAddress string: IP Address of the floating IP
Id string: Floating IP ID
PortId string: Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
Region string: Region name
RouterId string: Router ID
Status string: Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
Tags List<GetCloudFloatingIpTag>: List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
UpdatedAt string: Datetime when the floating IP was last updated
FindOneBy GetCloudFloatingIpFindOneBy
FloatingIpId string: Floating IP ID
ProjectId double: Project ID
RegionId double: Region ID

CreatedAt string: Datetime when the floating IP was created
CreatorTaskId string: Task that created this entity
FixedIpAddress string: IP address of the port the floating IP is attached to
FloatingIpAddress string: IP Address of the floating IP
Id string: Floating IP ID
PortId string: Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
Region string: Region name
RouterId string: Router ID
Status string: Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
Tags []GetCloudFloatingIpTag: List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
UpdatedAt string: Datetime when the floating IP was last updated
FindOneBy GetCloudFloatingIpFindOneBy
FloatingIpId string: Floating IP ID
ProjectId float64: Project ID
RegionId float64: Region ID

createdAt String: Datetime when the floating IP was created
creatorTaskId String: Task that created this entity
fixedIpAddress String: IP address of the port the floating IP is attached to
floatingIpAddress String: IP Address of the floating IP
id String: Floating IP ID
portId String: Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
region String: Region name
routerId String: Router ID
status String: Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tags List<GetCloudFloatingIpTag>: List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
updatedAt String: Datetime when the floating IP was last updated
findOneBy GetCloudFloatingIpFindOneBy
floatingIpId String: Floating IP ID
projectId Double: Project ID
regionId Double: Region ID

createdAt string: Datetime when the floating IP was created
creatorTaskId string: Task that created this entity
fixedIpAddress string: IP address of the port the floating IP is attached to
floatingIpAddress string: IP Address of the floating IP
id string: Floating IP ID
portId string: Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
region string: Region name
routerId string: Router ID
status string: Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tags GetCloudFloatingIpTag[]: List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
updatedAt string: Datetime when the floating IP was last updated
findOneBy GetCloudFloatingIpFindOneBy
floatingIpId string: Floating IP ID
projectId number: Project ID
regionId number: Region ID

created_at str: Datetime when the floating IP was created
creator_task_id str: Task that created this entity
fixed_ip_address str: IP address of the port the floating IP is attached to
floating_ip_address str: IP Address of the floating IP
id str: Floating IP ID
port_id str: Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
region str: Region name
router_id str: Router ID
status str: Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tags Sequence[GetCloudFloatingIpTag]: List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
updated_at str: Datetime when the floating IP was last updated
find_one_by GetCloudFloatingIpFindOneBy
floating_ip_id str: Floating IP ID
project_id float: Project ID
region_id float: Region ID

createdAt String: Datetime when the floating IP was created
creatorTaskId String: Task that created this entity
fixedIpAddress String: IP address of the port the floating IP is attached to
floatingIpAddress String: IP Address of the floating IP
id String: Floating IP ID
portId String: Port ID the floating IP is attached to. The fixed_ip_address is the IP address of the port.
region String: Region name
routerId String: Router ID
status String: Floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tags List<Property Map>: List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
updatedAt String: Datetime when the floating IP was last updated
findOneBy Property Map
floatingIpId String: Floating IP ID
projectId Number: Project ID
regionId Number: Region ID

Supporting Types

GetCloudFloatingIpFindOneBy

Status string: Filter by floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
TagKeyValue string: Optional. Filter by tag key-value pairs.
TagKeys List<string>: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

Status string: Filter by floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
TagKeyValue string: Optional. Filter by tag key-value pairs.
TagKeys []string: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

status String: Filter by floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tagKeyValue String: Optional. Filter by tag key-value pairs.
tagKeys List<String>: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

status string: Filter by floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tagKeyValue string: Optional. Filter by tag key-value pairs.
tagKeys string[]: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

status str: Filter by floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tag_key_value str: Optional. Filter by tag key-value pairs.
tag_keys Sequence[str]: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

status String: Filter by floating IP status. DOWN - unassigned (available). ACTIVE - attached to a port (in use). ERROR - error state. Available values: "ACTIVE", "DOWN", "ERROR".
tagKeyValue String: Optional. Filter by tag key-value pairs.
tagKeys List<String>: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

GetCloudFloatingIpTag

Key string: Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
ReadOnly bool: If true, the tag is read-only and cannot be modified by the user
Value string: Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

Key string: Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
ReadOnly bool: If true, the tag is read-only and cannot be modified by the user
Value string: Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

key String: Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
readOnly Boolean: If true, the tag is read-only and cannot be modified by the user
value String: Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

key string: Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
readOnly boolean: If true, the tag is read-only and cannot be modified by the user
value string: Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

key str: Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
read_only bool: If true, the tag is read-only and cannot be modified by the user
value str: Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

key String: Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
readOnly Boolean: If true, the tag is read-only and cannot be modified by the user
value String: Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.