getCloudFloatingIps

gcore 2.0.0-alpha.2, Mar 24 26

Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core

Schema (JSON)

g-core/terraform-provider-gcore

Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core

Schema (JSON)

g-core/terraform-provider-gcore

Example Usage

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

const exampleCloudFloatingIps = gcore.getCloudFloatingIps({
    projectId: 1,
    regionId: 1,
    status: "ACTIVE",
    tagKeys: [
        "key1",
        "key2",
    ],
    tagKeyValue: "tag_key_value",
});

import pulumi
import pulumi_gcore as gcore

example_cloud_floating_ips = gcore.get_cloud_floating_ips(project_id=1,
    region_id=1,
    status="ACTIVE",
    tag_keys=[
        "key1",
        "key2",
    ],
    tag_key_value="tag_key_value")

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.GetCloudFloatingIps(ctx, &gcore.GetCloudFloatingIpsArgs{
			ProjectId: pulumi.Float64Ref(1),
			RegionId:  pulumi.Float64Ref(1),
			Status:    pulumi.StringRef("ACTIVE"),
			TagKeys: []string{
				"key1",
				"key2",
			},
			TagKeyValue: pulumi.StringRef("tag_key_value"),
		}, 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 exampleCloudFloatingIps = Gcore.GetCloudFloatingIps.Invoke(new()
    {
        ProjectId = 1,
        RegionId = 1,
        Status = "ACTIVE",
        TagKeys = new[]
        {
            "key1",
            "key2",
        },
        TagKeyValue = "tag_key_value",
    });

});

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.GetCloudFloatingIpsArgs;
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 exampleCloudFloatingIps = GcoreFunctions.getCloudFloatingIps(GetCloudFloatingIpsArgs.builder()
            .projectId(1)
            .regionId(1)
            .status("ACTIVE")
            .tagKeys(            
                "key1",
                "key2")
            .tagKeyValue("tag_key_value")
            .build());

    }
}

variables:
  exampleCloudFloatingIps:
    fn::invoke:
      function: gcore:getCloudFloatingIps
      arguments:
        projectId: 1
        regionId: 1
        status: ACTIVE
        tagKeys:
          - key1
          - key2
        tagKeyValue: tag_key_value

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(max_items: Optional[float] = None,
                           project_id: Optional[float] = None,
                           region_id: Optional[float] = None,
                           status: Optional[str] = None,
                           tag_key_value: Optional[str] = None,
                           tag_keys: Optional[Sequence[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> GetCloudFloatingIpsResult
def get_cloud_floating_ips_output(max_items: Optional[pulumi.Input[float]] = None,
                           project_id: Optional[pulumi.Input[float]] = None,
                           region_id: Optional[pulumi.Input[float]] = None,
                           status: Optional[pulumi.Input[str]] = None,
                           tag_key_value: Optional[pulumi.Input[str]] = None,
                           tag_keys: Optional[pulumi.Input[Sequence[pulumi.Input[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: gcore:index/getCloudFloatingIps:getCloudFloatingIps
  arguments:
    # arguments dictionary

The following arguments are supported:

MaxItems double: Max items to fetch, default: 1000
ProjectId double: Project ID
RegionId double: Region ID
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

MaxItems float64: Max items to fetch, default: 1000
ProjectId float64: Project ID
RegionId float64: Region ID
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

maxItems Double: Max items to fetch, default: 1000
projectId Double: Project ID
regionId Double: Region ID
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

maxItems number: Max items to fetch, default: 1000
projectId number: Project ID
regionId number: Region ID
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

max_items float: Max items to fetch, default: 1000
project_id float: Project ID
region_id float: Region ID
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

maxItems Number: Max items to fetch, default: 1000
projectId Number: Project ID
regionId Number: Region ID
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