1. Packages
  2. Gcore Provider
  3. API Docs
  4. getCloudFloatingIp
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core
gcore logo
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core

    A floating IP is a static IP address that points to one of your Instances. It allows you to redirect network traffic to any of your Instances in the same datacenter.

    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.

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    gcore logo
    Viewing docs for gcore 2.0.0-alpha.2
    published on Tuesday, Mar 24, 2026 by g-core
      Try Pulumi Cloud free. Your team will thank you.