Skip to main content

NetworkResponsePagedResponse

A generic page of results, used by list endpoints across this API.

items object[]nullable

The items on this page.

  • Array [
  • idstring<uuid>

    Id of the network.

    projectIdstring<uuid>

    Id of the project the network belongs to.

    namestringnullable

    The network's display name, when set.

    typeNetworkType (string)

    Type of the resource.

    Possible values: [Wan, Lan]

    operationResourceOperation (string)

    Last (or currently in-flight) operation recorded for the resource.

    Possible values: [Provision, Deprovision, AttachVm, ConfigureVm, DetachVm, Start, Stop, Reboot, CreateBackup, DeleteBackup, RestoreVmFromBackup, CreatePortForward, DeletePortForward, UpdatePortForward, Resize, RebuildVm]

    operationStatusApiOperationStatus (string)

    Current status of the asynchronous operation.

    Possible values: [Queued, InProgress, Compensation, Succeeded, Failed]

    statusResourceStatus (string)

    Current status of the resource.

    Possible values: [creating, active, updating, deleting, failed]

    createdAtstring<date-time>

    The date and time (UTC) at which the network was created.

    subnet object

    The network's addressing: CIDR block, gateway and address pool.

    cidr IPNetwork (string)

    CIDR block describing the subnet or network range.

    baseAddress IPAddress (string)

    First address of the network range.

    addressFamilyAddressFamily (string)

    Address family of the address (IPv4 or IPv6).

    Possible values: [Unknown, Unspecified, Unix, InterNetwork, ImpLink, Pup, Chaos, NS, Ipx, Iso, Osi, Ecma, DataKit, Ccitt, Sna, DecNet, DataLink, Lat, HyperChannel, AppleTalk, NetBios, VoiceView, FireFox, Banyan, Atm, InterNetworkV6, Cluster, Ieee12844, Irda, NetworkDesigners, Max, Packet, ControllerAreaNetwork]

    scopeIdinteger<int64>

    IPv6 scope identifier of the address.

    isIPv6Multicastboolean

    Whether the address is an IPv6 multicast address.

    isIPv6LinkLocalboolean

    Whether the address is an IPv6 link-local address.

    isIPv6SiteLocalboolean

    Whether the address is an IPv6 site-local address.

    isIPv6Teredoboolean

    Whether the address is an IPv6 Teredo address.

    isIPv6UniqueLocalboolean

    Whether the address is an IPv6 unique-local address.

    isIPv4MappedToIPv6boolean

    Whether the address is an IPv4 address mapped into the IPv6 space.

    addressinteger<int64>deprecated

    IP address value.

    prefixLengthinteger<int32>

    Prefix length of the network, in bits (the /24 in 10.0.0.0/24).

    poolStartIp IPAddress (string)

    First IP address in the allocation pool.

    addressFamilyAddressFamily (string)

    Address family of the address (IPv4 or IPv6).

    Possible values: [Unknown, Unspecified, Unix, InterNetwork, ImpLink, Pup, Chaos, NS, Ipx, Iso, Osi, Ecma, DataKit, Ccitt, Sna, DecNet, DataLink, Lat, HyperChannel, AppleTalk, NetBios, VoiceView, FireFox, Banyan, Atm, InterNetworkV6, Cluster, Ieee12844, Irda, NetworkDesigners, Max, Packet, ControllerAreaNetwork]

    scopeIdinteger<int64>

    IPv6 scope identifier of the address.

    isIPv6Multicastboolean

    Whether the address is an IPv6 multicast address.

    isIPv6LinkLocalboolean

    Whether the address is an IPv6 link-local address.

    isIPv6SiteLocalboolean

    Whether the address is an IPv6 site-local address.

    isIPv6Teredoboolean

    Whether the address is an IPv6 Teredo address.

    isIPv6UniqueLocalboolean

    Whether the address is an IPv6 unique-local address.

    isIPv4MappedToIPv6boolean

    Whether the address is an IPv4 address mapped into the IPv6 space.

    addressinteger<int64>deprecated

    IP address value.

    poolEndIpInclusive IPAddress (string)

    Last IP address included in the allocation pool.

    addressFamilyAddressFamily (string)

    Address family of the address (IPv4 or IPv6).

    Possible values: [Unknown, Unspecified, Unix, InterNetwork, ImpLink, Pup, Chaos, NS, Ipx, Iso, Osi, Ecma, DataKit, Ccitt, Sna, DecNet, DataLink, Lat, HyperChannel, AppleTalk, NetBios, VoiceView, FireFox, Banyan, Atm, InterNetworkV6, Cluster, Ieee12844, Irda, NetworkDesigners, Max, Packet, ControllerAreaNetwork]

    scopeIdinteger<int64>

    IPv6 scope identifier of the address.

    isIPv6Multicastboolean

    Whether the address is an IPv6 multicast address.

    isIPv6LinkLocalboolean

    Whether the address is an IPv6 link-local address.

    isIPv6SiteLocalboolean

    Whether the address is an IPv6 site-local address.

    isIPv6Teredoboolean

    Whether the address is an IPv6 Teredo address.

    isIPv6UniqueLocalboolean

    Whether the address is an IPv6 unique-local address.

    isIPv4MappedToIPv6boolean

    Whether the address is an IPv4 address mapped into the IPv6 space.

    addressinteger<int64>deprecated

    IP address value.

    gatewayIp IPAddress (string)

    Gateway IP address for the subnet.

    addressFamilyAddressFamily (string)

    Address family of the address (IPv4 or IPv6).

    Possible values: [Unknown, Unspecified, Unix, InterNetwork, ImpLink, Pup, Chaos, NS, Ipx, Iso, Osi, Ecma, DataKit, Ccitt, Sna, DecNet, DataLink, Lat, HyperChannel, AppleTalk, NetBios, VoiceView, FireFox, Banyan, Atm, InterNetworkV6, Cluster, Ieee12844, Irda, NetworkDesigners, Max, Packet, ControllerAreaNetwork]

    scopeIdinteger<int64>

    IPv6 scope identifier of the address.

    isIPv6Multicastboolean

    Whether the address is an IPv6 multicast address.

    isIPv6LinkLocalboolean

    Whether the address is an IPv6 link-local address.

    isIPv6SiteLocalboolean

    Whether the address is an IPv6 site-local address.

    isIPv6Teredoboolean

    Whether the address is an IPv6 Teredo address.

    isIPv6UniqueLocalboolean

    Whether the address is an IPv6 unique-local address.

    isIPv4MappedToIPv6boolean

    Whether the address is an IPv4 address mapped into the IPv6 space.

    addressinteger<int64>deprecated

    IP address value.

    vmsInterfaces object[]nullable

    The VMs attached to the network and their addresses.

  • Array [
  • vmIdstring<uuid>

    Id of the attached VM.

    vmNamestringnullable

    Name of the VM, when known.

    ip IPAddress (string)

    The IP address itself, in dotted-decimal form.

    addressFamilyAddressFamily (string)

    Address family of the address (IPv4 or IPv6).

    Possible values: [Unknown, Unspecified, Unix, InterNetwork, ImpLink, Pup, Chaos, NS, Ipx, Iso, Osi, Ecma, DataKit, Ccitt, Sna, DecNet, DataLink, Lat, HyperChannel, AppleTalk, NetBios, VoiceView, FireFox, Banyan, Atm, InterNetworkV6, Cluster, Ieee12844, Irda, NetworkDesigners, Max, Packet, ControllerAreaNetwork]

    scopeIdinteger<int64>

    IPv6 scope identifier of the address.

    isIPv6Multicastboolean

    Whether the address is an IPv6 multicast address.

    isIPv6LinkLocalboolean

    Whether the address is an IPv6 link-local address.

    isIPv6SiteLocalboolean

    Whether the address is an IPv6 site-local address.

    isIPv6Teredoboolean

    Whether the address is an IPv6 Teredo address.

    isIPv6UniqueLocalboolean

    Whether the address is an IPv6 unique-local address.

    isIPv4MappedToIPv6boolean

    Whether the address is an IPv4 address mapped into the IPv6 space.

    addressinteger<int64>deprecated

    IP address value.

  • ]
  • publicIp object

    The public IP address bound to the network, when one is attached.

    idstring<uuid>

    Id of the public IP.

    ip IPAddress (string)

    The IP address itself, in dotted-decimal form.

    addressFamilyAddressFamily (string)

    Address family of the address (IPv4 or IPv6).

    Possible values: [Unknown, Unspecified, Unix, InterNetwork, ImpLink, Pup, Chaos, NS, Ipx, Iso, Osi, Ecma, DataKit, Ccitt, Sna, DecNet, DataLink, Lat, HyperChannel, AppleTalk, NetBios, VoiceView, FireFox, Banyan, Atm, InterNetworkV6, Cluster, Ieee12844, Irda, NetworkDesigners, Max, Packet, ControllerAreaNetwork]

    scopeIdinteger<int64>

    IPv6 scope identifier of the address.

    isIPv6Multicastboolean

    Whether the address is an IPv6 multicast address.

    isIPv6LinkLocalboolean

    Whether the address is an IPv6 link-local address.

    isIPv6SiteLocalboolean

    Whether the address is an IPv6 site-local address.

    isIPv6Teredoboolean

    Whether the address is an IPv6 Teredo address.

    isIPv6UniqueLocalboolean

    Whether the address is an IPv6 unique-local address.

    isIPv4MappedToIPv6boolean

    Whether the address is an IPv4 address mapped into the IPv6 space.

    addressinteger<int64>deprecated

    IP address value.

    geolocationstringnullable

    The geographic location associated with the public IP.

    portForwardRules object[]nullable

    Port forwarding rules configured on the public IP.

  • Array [
  • vmIdstring<uuid>

    Id of the VM the rule targets.

    vmNamestringnullable

    Name of the target VM, when known.

    statusPortForwardStatus (string)

    Current status of the resource.

    Possible values: [Created, Creating, Updating, Deleting]

    rule object

    Parameters of the rule: protocol, mode and ports.

    modePortForwardMode (string)

    Mode that defines how the resource should behave.

    Possible values: [SpecificPorts, AllPorts]

    protocolPortForwardProtocol (string)

    Protocol used by the resource or forwarding rule.

    Possible values: [Tcp, Udp, TcpUdp]

    externalPortinteger<int32>nullable

    The externally exposed port, when applicable for the selected mode.

    internalPortinteger<int32>nullable

    The internal (VM-side) port the traffic is forwarded to, when applicable for the selected mode.

  • ]
  • ]
  • totalinteger<int32>

    Total number of items across all pages.

    pageinteger<int32>

    The current page number, starting at 1.

    pageSizeinteger<int32>

    Number of items per page.

    totalPagesinteger<int32>

    Total number of pages available.

    hasNextPageboolean

    Whether a next page is available.

    NetworkResponsePagedResponse
    {
    "items": [
    {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "type": "Wan",
    "operation": "Provision",
    "operationStatus": "Queued",
    "status": "creating",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "subnet": {
    "cidr": "10.0.0.0/24",
    "poolStartIp": "192.168.0.1",
    "poolEndIpInclusive": "192.168.0.1",
    "gatewayIp": "192.168.0.1"
    },
    "vmsInterfaces": [
    {
    "vmId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "vmName": "string",
    "ip": "192.168.0.1"
    }
    ],
    "publicIp": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "ip": "192.168.0.1",
    "geolocation": "string",
    "portForwardRules": [
    {
    "vmId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "vmName": "string",
    "status": "Created",
    "rule": {
    "mode": "SpecificPorts",
    "protocol": "Tcp",
    "externalPort": 0,
    "internalPort": 0
    }
    }
    ]
    }
    }
    ],
    "total": 0,
    "page": 0,
    "pageSize": 0,
    "totalPages": 0,
    "hasNextPage": true
    }