gcore 0.22.0 published on Wednesday, Apr 30, 2025 by g-core
gcore.getFloatingip
Explore with Pulumi AI
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 pr = gcore.getProject({
name: "test",
});
const rg = gcore.getRegion({
name: "ED-10 Preprod",
});
const ip = Promise.all([rg, pr]).then(([rg, pr]) => gcore.getFloatingip({
floatingIpAddress: "10.100.179.172",
regionId: rg.id,
projectId: pr.id,
}));
const ipByFixedIp = Promise.all([rg, pr]).then(([rg, pr]) => gcore.getFloatingip({
fixedIpAddress: "192.168.42.12",
regionId: rg.id,
projectId: pr.id,
}));
export const view = ip;
import pulumi
import pulumi_gcore as gcore
pr = gcore.get_project(name="test")
rg = gcore.get_region(name="ED-10 Preprod")
ip = gcore.get_floatingip(floating_ip_address="10.100.179.172",
region_id=rg.id,
project_id=pr.id)
ip_by_fixed_ip = gcore.get_floatingip(fixed_ip_address="192.168.42.12",
region_id=rg.id,
project_id=pr.id)
pulumi.export("view", ip)
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/gcore"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
pr, err := gcore.GetProject(ctx, &gcore.GetProjectArgs{
Name: "test",
}, nil)
if err != nil {
return err
}
rg, err := gcore.GetRegion(ctx, &gcore.GetRegionArgs{
Name: "ED-10 Preprod",
}, nil)
if err != nil {
return err
}
ip, err := gcore.LookupFloatingip(ctx, &gcore.LookupFloatingipArgs{
FloatingIpAddress: pulumi.StringRef("10.100.179.172"),
RegionId: pulumi.Float64Ref(rg.Id),
ProjectId: pulumi.Float64Ref(pr.Id),
}, nil)
if err != nil {
return err
}
_, err = gcore.LookupFloatingip(ctx, &gcore.LookupFloatingipArgs{
FixedIpAddress: pulumi.StringRef("192.168.42.12"),
RegionId: pulumi.Float64Ref(rg.Id),
ProjectId: pulumi.Float64Ref(pr.Id),
}, nil)
if err != nil {
return err
}
ctx.Export("view", ip)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcore = Pulumi.Gcore;
return await Deployment.RunAsync(() =>
{
var pr = Gcore.GetProject.Invoke(new()
{
Name = "test",
});
var rg = Gcore.GetRegion.Invoke(new()
{
Name = "ED-10 Preprod",
});
var ip = Gcore.GetFloatingip.Invoke(new()
{
FloatingIpAddress = "10.100.179.172",
RegionId = rg.Apply(getRegionResult => getRegionResult.Id),
ProjectId = pr.Apply(getProjectResult => getProjectResult.Id),
});
var ipByFixedIp = Gcore.GetFloatingip.Invoke(new()
{
FixedIpAddress = "192.168.42.12",
RegionId = rg.Apply(getRegionResult => getRegionResult.Id),
ProjectId = pr.Apply(getProjectResult => getProjectResult.Id),
});
return new Dictionary<string, object?>
{
["view"] = ip,
};
});
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.GetProjectArgs;
import com.pulumi.gcore.inputs.GetRegionArgs;
import com.pulumi.gcore.inputs.GetFloatingipArgs;
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 pr = GcoreFunctions.getProject(GetProjectArgs.builder()
.name("test")
.build());
final var rg = GcoreFunctions.getRegion(GetRegionArgs.builder()
.name("ED-10 Preprod")
.build());
final var ip = GcoreFunctions.getFloatingip(GetFloatingipArgs.builder()
.floatingIpAddress("10.100.179.172")
.regionId(rg.applyValue(getRegionResult -> getRegionResult.id()))
.projectId(pr.applyValue(getProjectResult -> getProjectResult.id()))
.build());
final var ipByFixedIp = GcoreFunctions.getFloatingip(GetFloatingipArgs.builder()
.fixedIpAddress("192.168.42.12")
.regionId(rg.applyValue(getRegionResult -> getRegionResult.id()))
.projectId(pr.applyValue(getProjectResult -> getProjectResult.id()))
.build());
ctx.export("view", ip.applyValue(getFloatingipResult -> getFloatingipResult));
}
}
variables:
pr:
fn::invoke:
function: gcore:getProject
arguments:
name: test
rg:
fn::invoke:
function: gcore:getRegion
arguments:
name: ED-10 Preprod
ip:
fn::invoke:
function: gcore:getFloatingip
arguments:
floatingIpAddress: 10.100.179.172
regionId: ${rg.id}
projectId: ${pr.id}
ipByFixedIp:
fn::invoke:
function: gcore:getFloatingip
arguments:
fixedIpAddress: 192.168.42.12
regionId: ${rg.id}
projectId: ${pr.id}
outputs:
view: ${ip}
Using getFloatingip
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 getFloatingip(args: GetFloatingipArgs, opts?: InvokeOptions): Promise<GetFloatingipResult>
function getFloatingipOutput(args: GetFloatingipOutputArgs, opts?: InvokeOptions): Output<GetFloatingipResult>
def get_floatingip(fixed_ip_address: Optional[str] = None,
floating_ip_address: Optional[str] = None,
id: Optional[str] = None,
metadata_k: Optional[str] = None,
metadata_kv: Optional[Mapping[str, str]] = None,
port_id: Optional[str] = None,
project_id: Optional[float] = None,
project_name: Optional[str] = None,
region_id: Optional[float] = None,
region_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetFloatingipResult
def get_floatingip_output(fixed_ip_address: Optional[pulumi.Input[str]] = None,
floating_ip_address: Optional[pulumi.Input[str]] = None,
id: Optional[pulumi.Input[str]] = None,
metadata_k: Optional[pulumi.Input[str]] = None,
metadata_kv: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
port_id: Optional[pulumi.Input[str]] = None,
project_id: Optional[pulumi.Input[float]] = None,
project_name: Optional[pulumi.Input[str]] = None,
region_id: Optional[pulumi.Input[float]] = None,
region_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetFloatingipResult]
func LookupFloatingip(ctx *Context, args *LookupFloatingipArgs, opts ...InvokeOption) (*LookupFloatingipResult, error)
func LookupFloatingipOutput(ctx *Context, args *LookupFloatingipOutputArgs, opts ...InvokeOption) LookupFloatingipResultOutput
> Note: This function is named LookupFloatingip
in the Go SDK.
public static class GetFloatingip
{
public static Task<GetFloatingipResult> InvokeAsync(GetFloatingipArgs args, InvokeOptions? opts = null)
public static Output<GetFloatingipResult> Invoke(GetFloatingipInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetFloatingipResult> getFloatingip(GetFloatingipArgs args, InvokeOptions options)
public static Output<GetFloatingipResult> getFloatingip(GetFloatingipArgs args, InvokeOptions options)
fn::invoke:
function: gcore:index/getFloatingip:getFloatingip
arguments:
# arguments dictionary
The following arguments are supported:
- Fixed
Ip stringAddress - Floating
Ip stringAddress - Id string
- The ID of this resource.
- Metadata
K string - Metadata
Kv Dictionary<string, string> - Port
Id string - Project
Id double - Project
Name string - Region
Id double - Region
Name string
- Fixed
Ip stringAddress - Floating
Ip stringAddress - Id string
- The ID of this resource.
- Metadata
K string - Metadata
Kv map[string]string - Port
Id string - Project
Id float64 - Project
Name string - Region
Id float64 - Region
Name string
- fixed
Ip StringAddress - floating
Ip StringAddress - id String
- The ID of this resource.
- metadata
K String - metadata
Kv Map<String,String> - port
Id String - project
Id Double - project
Name String - region
Id Double - region
Name String
- fixed
Ip stringAddress - floating
Ip stringAddress - id string
- The ID of this resource.
- metadata
K string - metadata
Kv {[key: string]: string} - port
Id string - project
Id number - project
Name string - region
Id number - region
Name string
- fixed_
ip_ straddress - floating_
ip_ straddress - id str
- The ID of this resource.
- metadata_
k str - metadata_
kv Mapping[str, str] - port_
id str - project_
id float - project_
name str - region_
id float - region_
name str
- fixed
Ip StringAddress - floating
Ip StringAddress - id String
- The ID of this resource.
- metadata
K String - metadata
Kv Map<String> - port
Id String - project
Id Number - project
Name String - region
Id Number - region
Name String
getFloatingip Result
The following output properties are available:
- Fixed
Ip stringAddress - Floating
Ip stringAddress - Id string
- The ID of this resource.
- Metadata
Read List<GetOnlies Floatingip Metadata Read Only> - Router
Id string - Status string
- Metadata
K string - Metadata
Kv Dictionary<string, string> - Port
Id string - Project
Id double - Project
Name string - Region
Id double - Region
Name string
- Fixed
Ip stringAddress - Floating
Ip stringAddress - Id string
- The ID of this resource.
- Metadata
Read []GetOnlies Floatingip Metadata Read Only - Router
Id string - Status string
- Metadata
K string - Metadata
Kv map[string]string - Port
Id string - Project
Id float64 - Project
Name string - Region
Id float64 - Region
Name string
- fixed
Ip StringAddress - floating
Ip StringAddress - id String
- The ID of this resource.
- metadata
Read List<GetOnlies Floatingip Metadata Read Only> - router
Id String - status String
- metadata
K String - metadata
Kv Map<String,String> - port
Id String - project
Id Double - project
Name String - region
Id Double - region
Name String
- fixed
Ip stringAddress - floating
Ip stringAddress - id string
- The ID of this resource.
- metadata
Read GetOnlies Floatingip Metadata Read Only[] - router
Id string - status string
- metadata
K string - metadata
Kv {[key: string]: string} - port
Id string - project
Id number - project
Name string - region
Id number - region
Name string
- fixed_
ip_ straddress - floating_
ip_ straddress - id str
- The ID of this resource.
- metadata_
read_ Sequence[Getonlies Floatingip Metadata Read Only] - router_
id str - status str
- metadata_
k str - metadata_
kv Mapping[str, str] - port_
id str - project_
id float - project_
name str - region_
id float - region_
name str
- fixed
Ip StringAddress - floating
Ip StringAddress - id String
- The ID of this resource.
- metadata
Read List<Property Map>Onlies - router
Id String - status String
- metadata
K String - metadata
Kv Map<String> - port
Id String - project
Id Number - project
Name String - region
Id Number - region
Name String
Supporting Types
GetFloatingipMetadataReadOnly
Package Details
- Repository
- gcore g-core/terraform-provider-gcore
- License
- Notes
- This Pulumi package is based on the
gcore
Terraform Provider.