1. Packages
  2. Gcore Provider
  3. API Docs
  4. getCloudReservedFixedIp
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

    Reserved fixed IPs are static IP addresses that persist independently of instances and can be used as virtual IPs (VIPs) for high availability.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const exampleCloudReservedFixedIp = gcore.getCloudReservedFixedIp({
        projectId: 0,
        regionId: 0,
        portId: "port_id",
    });
    
    import pulumi
    import pulumi_gcore as gcore
    
    example_cloud_reserved_fixed_ip = gcore.get_cloud_reserved_fixed_ip(project_id=0,
        region_id=0,
        port_id="port_id")
    
    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.LookupCloudReservedFixedIp(ctx, &gcore.LookupCloudReservedFixedIpArgs{
    			ProjectId: pulumi.Float64Ref(0),
    			RegionId:  pulumi.Float64Ref(0),
    			PortId:    "port_id",
    		}, 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 exampleCloudReservedFixedIp = Gcore.GetCloudReservedFixedIp.Invoke(new()
        {
            ProjectId = 0,
            RegionId = 0,
            PortId = "port_id",
        });
    
    });
    
    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.GetCloudReservedFixedIpArgs;
    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 exampleCloudReservedFixedIp = GcoreFunctions.getCloudReservedFixedIp(GetCloudReservedFixedIpArgs.builder()
                .projectId(0)
                .regionId(0)
                .portId("port_id")
                .build());
    
        }
    }
    
    variables:
      exampleCloudReservedFixedIp:
        fn::invoke:
          function: gcore:getCloudReservedFixedIp
          arguments:
            projectId: 0
            regionId: 0
            portId: port_id
    

    Using getCloudReservedFixedIp

    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 getCloudReservedFixedIp(args: GetCloudReservedFixedIpArgs, opts?: InvokeOptions): Promise<GetCloudReservedFixedIpResult>
    function getCloudReservedFixedIpOutput(args: GetCloudReservedFixedIpOutputArgs, opts?: InvokeOptions): Output<GetCloudReservedFixedIpResult>
    def get_cloud_reserved_fixed_ip(port_id: Optional[str] = None,
                                    project_id: Optional[float] = None,
                                    region_id: Optional[float] = None,
                                    opts: Optional[InvokeOptions] = None) -> GetCloudReservedFixedIpResult
    def get_cloud_reserved_fixed_ip_output(port_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[GetCloudReservedFixedIpResult]
    func LookupCloudReservedFixedIp(ctx *Context, args *LookupCloudReservedFixedIpArgs, opts ...InvokeOption) (*LookupCloudReservedFixedIpResult, error)
    func LookupCloudReservedFixedIpOutput(ctx *Context, args *LookupCloudReservedFixedIpOutputArgs, opts ...InvokeOption) LookupCloudReservedFixedIpResultOutput

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

    public static class GetCloudReservedFixedIp 
    {
        public static Task<GetCloudReservedFixedIpResult> InvokeAsync(GetCloudReservedFixedIpArgs args, InvokeOptions? opts = null)
        public static Output<GetCloudReservedFixedIpResult> Invoke(GetCloudReservedFixedIpInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetCloudReservedFixedIpResult> getCloudReservedFixedIp(GetCloudReservedFixedIpArgs args, InvokeOptions options)
    public static Output<GetCloudReservedFixedIpResult> getCloudReservedFixedIp(GetCloudReservedFixedIpArgs args, InvokeOptions options)
    
    fn::invoke:
      function: gcore:index/getCloudReservedFixedIp:getCloudReservedFixedIp
      arguments:
        # arguments dictionary

    The following arguments are supported:

    PortId string
    ProjectId double
    RegionId double
    PortId string
    ProjectId float64
    RegionId float64
    portId String
    projectId Double
    regionId Double
    portId string
    projectId number
    regionId number
    portId String
    projectId Number
    regionId Number

    getCloudReservedFixedIp Result

    The following output properties are available:

    AllowedAddressPairs List<GetCloudReservedFixedIpAllowedAddressPair>
    Group of subnet masks and/or IP addresses that share the current IP as VIP
    Attachments List<GetCloudReservedFixedIpAttachment>
    Reserved fixed IP attachment entities
    CreatedAt string
    Datetime when the reserved fixed IP was created
    CreatorTaskId string
    Task that created this entity
    FixedIpAddress string
    IPv4 address of the reserved fixed IP
    FixedIpv6Address string
    IPv6 address of the reserved fixed IP
    Id string
    The provider-assigned unique ID for this managed resource.
    IsExternal bool
    If reserved fixed IP belongs to a public network
    IsVip bool
    If reserved fixed IP is a VIP
    Name string
    Reserved fixed IP name
    Network GetCloudReservedFixedIpNetwork
    Network details
    NetworkId string
    ID of the network the port is attached to
    PortId string
    Region string
    Region name
    Status string
    Underlying port status
    SubnetId string
    ID of the subnet that owns the IP address
    SubnetV6Id string
    ID of the subnet that owns the IPv6 address
    UpdatedAt string
    Datetime when the reserved fixed IP was last updated
    ProjectId double
    RegionId double
    AllowedAddressPairs []GetCloudReservedFixedIpAllowedAddressPair
    Group of subnet masks and/or IP addresses that share the current IP as VIP
    Attachments []GetCloudReservedFixedIpAttachment
    Reserved fixed IP attachment entities
    CreatedAt string
    Datetime when the reserved fixed IP was created
    CreatorTaskId string
    Task that created this entity
    FixedIpAddress string
    IPv4 address of the reserved fixed IP
    FixedIpv6Address string
    IPv6 address of the reserved fixed IP
    Id string
    The provider-assigned unique ID for this managed resource.
    IsExternal bool
    If reserved fixed IP belongs to a public network
    IsVip bool
    If reserved fixed IP is a VIP
    Name string
    Reserved fixed IP name
    Network GetCloudReservedFixedIpNetwork
    Network details
    NetworkId string
    ID of the network the port is attached to
    PortId string
    Region string
    Region name
    Status string
    Underlying port status
    SubnetId string
    ID of the subnet that owns the IP address
    SubnetV6Id string
    ID of the subnet that owns the IPv6 address
    UpdatedAt string
    Datetime when the reserved fixed IP was last updated
    ProjectId float64
    RegionId float64
    allowedAddressPairs List<GetCloudReservedFixedIpAllowedAddressPair>
    Group of subnet masks and/or IP addresses that share the current IP as VIP
    attachments List<GetCloudReservedFixedIpAttachment>
    Reserved fixed IP attachment entities
    createdAt String
    Datetime when the reserved fixed IP was created
    creatorTaskId String
    Task that created this entity
    fixedIpAddress String
    IPv4 address of the reserved fixed IP
    fixedIpv6Address String
    IPv6 address of the reserved fixed IP
    id String
    The provider-assigned unique ID for this managed resource.
    isExternal Boolean
    If reserved fixed IP belongs to a public network
    isVip Boolean
    If reserved fixed IP is a VIP
    name String
    Reserved fixed IP name
    network GetCloudReservedFixedIpNetwork
    Network details
    networkId String
    ID of the network the port is attached to
    portId String
    region String
    Region name
    status String
    Underlying port status
    subnetId String
    ID of the subnet that owns the IP address
    subnetV6Id String
    ID of the subnet that owns the IPv6 address
    updatedAt String
    Datetime when the reserved fixed IP was last updated
    projectId Double
    regionId Double
    allowedAddressPairs GetCloudReservedFixedIpAllowedAddressPair[]
    Group of subnet masks and/or IP addresses that share the current IP as VIP
    attachments GetCloudReservedFixedIpAttachment[]
    Reserved fixed IP attachment entities
    createdAt string
    Datetime when the reserved fixed IP was created
    creatorTaskId string
    Task that created this entity
    fixedIpAddress string
    IPv4 address of the reserved fixed IP
    fixedIpv6Address string
    IPv6 address of the reserved fixed IP
    id string
    The provider-assigned unique ID for this managed resource.
    isExternal boolean
    If reserved fixed IP belongs to a public network
    isVip boolean
    If reserved fixed IP is a VIP
    name string
    Reserved fixed IP name
    network GetCloudReservedFixedIpNetwork
    Network details
    networkId string
    ID of the network the port is attached to
    portId string
    region string
    Region name
    status string
    Underlying port status
    subnetId string
    ID of the subnet that owns the IP address
    subnetV6Id string
    ID of the subnet that owns the IPv6 address
    updatedAt string
    Datetime when the reserved fixed IP was last updated
    projectId number
    regionId number
    allowed_address_pairs Sequence[GetCloudReservedFixedIpAllowedAddressPair]
    Group of subnet masks and/or IP addresses that share the current IP as VIP
    attachments Sequence[GetCloudReservedFixedIpAttachment]
    Reserved fixed IP attachment entities
    created_at str
    Datetime when the reserved fixed IP was created
    creator_task_id str
    Task that created this entity
    fixed_ip_address str
    IPv4 address of the reserved fixed IP
    fixed_ipv6_address str
    IPv6 address of the reserved fixed IP
    id str
    The provider-assigned unique ID for this managed resource.
    is_external bool
    If reserved fixed IP belongs to a public network
    is_vip bool
    If reserved fixed IP is a VIP
    name str
    Reserved fixed IP name
    network GetCloudReservedFixedIpNetwork
    Network details
    network_id str
    ID of the network the port is attached to
    port_id str
    region str
    Region name
    status str
    Underlying port status
    subnet_id str
    ID of the subnet that owns the IP address
    subnet_v6_id str
    ID of the subnet that owns the IPv6 address
    updated_at str
    Datetime when the reserved fixed IP was last updated
    project_id float
    region_id float
    allowedAddressPairs List<Property Map>
    Group of subnet masks and/or IP addresses that share the current IP as VIP
    attachments List<Property Map>
    Reserved fixed IP attachment entities
    createdAt String
    Datetime when the reserved fixed IP was created
    creatorTaskId String
    Task that created this entity
    fixedIpAddress String
    IPv4 address of the reserved fixed IP
    fixedIpv6Address String
    IPv6 address of the reserved fixed IP
    id String
    The provider-assigned unique ID for this managed resource.
    isExternal Boolean
    If reserved fixed IP belongs to a public network
    isVip Boolean
    If reserved fixed IP is a VIP
    name String
    Reserved fixed IP name
    network Property Map
    Network details
    networkId String
    ID of the network the port is attached to
    portId String
    region String
    Region name
    status String
    Underlying port status
    subnetId String
    ID of the subnet that owns the IP address
    subnetV6Id String
    ID of the subnet that owns the IPv6 address
    updatedAt String
    Datetime when the reserved fixed IP was last updated
    projectId Number
    regionId Number

    Supporting Types

    GetCloudReservedFixedIpAllowedAddressPair

    IpAddress string
    Subnet mask or IP address of the port specified in allowed_address_pairs
    MacAddress string
    MAC address of the port specified in allowed_address_pairs
    IpAddress string
    Subnet mask or IP address of the port specified in allowed_address_pairs
    MacAddress string
    MAC address of the port specified in allowed_address_pairs
    ipAddress String
    Subnet mask or IP address of the port specified in allowed_address_pairs
    macAddress String
    MAC address of the port specified in allowed_address_pairs
    ipAddress string
    Subnet mask or IP address of the port specified in allowed_address_pairs
    macAddress string
    MAC address of the port specified in allowed_address_pairs
    ip_address str
    Subnet mask or IP address of the port specified in allowed_address_pairs
    mac_address str
    MAC address of the port specified in allowed_address_pairs
    ipAddress String
    Subnet mask or IP address of the port specified in allowed_address_pairs
    macAddress String
    MAC address of the port specified in allowed_address_pairs

    GetCloudReservedFixedIpAttachment

    ResourceId string
    Resource ID
    ResourceType string
    Resource type
    ResourceId string
    Resource ID
    ResourceType string
    Resource type
    resourceId String
    Resource ID
    resourceType String
    Resource type
    resourceId string
    Resource ID
    resourceType string
    Resource type
    resource_id str
    Resource ID
    resource_type str
    Resource type
    resourceId String
    Resource ID
    resourceType String
    Resource type

    GetCloudReservedFixedIpNetwork

    CreatedAt string
    Datetime when the network was created
    CreatorTaskId string
    Task that created this entity
    Default bool
    True if network has is_default attribute
    External bool
    True if the network router:external attribute
    Id string
    Network ID
    Mtu double
    MTU (maximum transmission unit). Default value is 1450
    Name string
    Network name
    PortSecurityEnabled bool
    Indicates port_security_enabled status of all newly created in the network ports.
    ProjectId double
    Project ID
    Region string
    Region name
    RegionId double
    Region ID
    SegmentationId double
    Id of network segment
    Shared bool
    True when the network is shared with your project by external owner
    Subnets List<string>
    List of subnetworks
    Tags List<GetCloudReservedFixedIpNetworkTag>
    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.
    Type string
    Network type (vlan, vxlan)
    UpdatedAt string
    Datetime when the network was last updated
    CreatedAt string
    Datetime when the network was created
    CreatorTaskId string
    Task that created this entity
    Default bool
    True if network has is_default attribute
    External bool
    True if the network router:external attribute
    Id string
    Network ID
    Mtu float64
    MTU (maximum transmission unit). Default value is 1450
    Name string
    Network name
    PortSecurityEnabled bool
    Indicates port_security_enabled status of all newly created in the network ports.
    ProjectId float64
    Project ID
    Region string
    Region name
    RegionId float64
    Region ID
    SegmentationId float64
    Id of network segment
    Shared bool
    True when the network is shared with your project by external owner
    Subnets []string
    List of subnetworks
    Tags []GetCloudReservedFixedIpNetworkTag
    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.
    Type string
    Network type (vlan, vxlan)
    UpdatedAt string
    Datetime when the network was last updated
    createdAt String
    Datetime when the network was created
    creatorTaskId String
    Task that created this entity
    default_ Boolean
    True if network has is_default attribute
    external Boolean
    True if the network router:external attribute
    id String
    Network ID
    mtu Double
    MTU (maximum transmission unit). Default value is 1450
    name String
    Network name
    portSecurityEnabled Boolean
    Indicates port_security_enabled status of all newly created in the network ports.
    projectId Double
    Project ID
    region String
    Region name
    regionId Double
    Region ID
    segmentationId Double
    Id of network segment
    shared Boolean
    True when the network is shared with your project by external owner
    subnets List<String>
    List of subnetworks
    tags List<GetCloudReservedFixedIpNetworkTag>
    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.
    type String
    Network type (vlan, vxlan)
    updatedAt String
    Datetime when the network was last updated
    createdAt string
    Datetime when the network was created
    creatorTaskId string
    Task that created this entity
    default boolean
    True if network has is_default attribute
    external boolean
    True if the network router:external attribute
    id string
    Network ID
    mtu number
    MTU (maximum transmission unit). Default value is 1450
    name string
    Network name
    portSecurityEnabled boolean
    Indicates port_security_enabled status of all newly created in the network ports.
    projectId number
    Project ID
    region string
    Region name
    regionId number
    Region ID
    segmentationId number
    Id of network segment
    shared boolean
    True when the network is shared with your project by external owner
    subnets string[]
    List of subnetworks
    tags GetCloudReservedFixedIpNetworkTag[]
    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.
    type string
    Network type (vlan, vxlan)
    updatedAt string
    Datetime when the network was last updated
    created_at str
    Datetime when the network was created
    creator_task_id str
    Task that created this entity
    default bool
    True if network has is_default attribute
    external bool
    True if the network router:external attribute
    id str
    Network ID
    mtu float
    MTU (maximum transmission unit). Default value is 1450
    name str
    Network name
    port_security_enabled bool
    Indicates port_security_enabled status of all newly created in the network ports.
    project_id float
    Project ID
    region str
    Region name
    region_id float
    Region ID
    segmentation_id float
    Id of network segment
    shared bool
    True when the network is shared with your project by external owner
    subnets Sequence[str]
    List of subnetworks
    tags Sequence[GetCloudReservedFixedIpNetworkTag]
    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.
    type str
    Network type (vlan, vxlan)
    updated_at str
    Datetime when the network was last updated
    createdAt String
    Datetime when the network was created
    creatorTaskId String
    Task that created this entity
    default Boolean
    True if network has is_default attribute
    external Boolean
    True if the network router:external attribute
    id String
    Network ID
    mtu Number
    MTU (maximum transmission unit). Default value is 1450
    name String
    Network name
    portSecurityEnabled Boolean
    Indicates port_security_enabled status of all newly created in the network ports.
    projectId Number
    Project ID
    region String
    Region name
    regionId Number
    Region ID
    segmentationId Number
    Id of network segment
    shared Boolean
    True when the network is shared with your project by external owner
    subnets List<String>
    List of subnetworks
    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.
    type String
    Network type (vlan, vxlan)
    updatedAt String
    Datetime when the network was last updated

    GetCloudReservedFixedIpNetworkTag

    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.