List floating IPs in a project.

GET

/v1/projects/{projectId}/network/floating-ips

Code sample: Shell / cURL

curl --request GET \
  --url https://stratum.example.com/v1/projects/example/network/floating-ips \
  --header 'Authorization: Bearer <token>'

• A Stratum cluster endpoint.

Authorizations

• bearerAuth

Parameters

Path Parameters

projectId

required

string

/^p-[a-z0-9-]+$/

Query Parameters

region

string

Responses

200

Floating IPs.

Media typeapplication/json

object

items

required

Array<object>

object

id

required

string

/^fip-[a-z0-9-]+$/

projectId

string

address

required

string format: ipv4

region

required

string

state

required

string

Allowed values: available allocated associated releasing released error

associatedNICId

The network interface this FIP is associated with. Empty for a FIP owned by a NAT gateway, a resolver inbound endpoint, a Client VPN endpoint or a load balancer — those express the association through their own field below, so a client must not treat this as “the” association.

string

associatedNATGWId

The NAT gateway whose external address this FIP is. Empty otherwise.

string

associatedRIEId

The resolver inbound endpoint this FIP fronts. Empty when the FIP fronts no endpoint. Read-only convenience on the Get/List read models.

string

associatedClientVpnId

The Client VPN endpoint this FIP is the public ingress of. Empty when the FIP fronts no endpoint. Keeps the FIP in state: associated so it cannot be released or hijacked while a terminator uses it. Read-only convenience on the Get/List read models.

string

associatedLoadBalancerId

The internet-facing load balancer this FIP fronts, resolved one-hop from the LB association. Empty when the FIP fronts no LB. Read-only convenience on the Get/List read models.

string

tags

AWS-shape resource tags. Freeform UTF-8 keys (1-128 bytes, no leading/trailing whitespace) mapped to freeform UTF-8 values (0-256 bytes). Max 50 tags per resource. Reserved prefixes (stratum.dev/, stratum.platform_health., stratum:, aws:) return 400 RESERVED_NAMESPACE on customer input. PATCH replaces the whole map..

object

<= 50 properties

key

additional properties

string

<= 256 characters

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

createdBy

string

nextPageToken

string

isTruncated

True when the server had more rows than it returned. The response is a valid prefix of the result, not the whole of it.

Without this flag a client at the server’s row ceiling receives a full page and no nextPageToken, which means “this is the complete set” — so data it never saw would be indistinguishable from data that does not exist.

It does not imply a cursor exists. These queries do not all sort on a total order, so a resumable token cannot be minted for them yet. The remedy is to narrow the request (a filter, or a tighter scope), not to page.

boolean

Example

{
  "items": [
    {
      "state": "available"
    }
  ]
}