Skip to main content

PublicIpResponsePagedResponse

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 public IP.

    projectIdstring<uuid>

    Id of the project the public IP belongs to.

    networkIdstring<uuid>

    Id of the network the public IP is bound to.

    operationResourceOperation (string)

    Allowed value for operation.

    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]

    ip IPAddress (string)

    Allowed value for ip.

    addressFamilyAddressFamily (string)

    Allowed value for address family.

    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>

    Unique identifier of the scope.

    isIPv6Multicastboolean

    Boolean flag that controls is ipv6 multicast.

    isIPv6LinkLocalboolean

    Boolean flag that controls is ipv6 link local.

    isIPv6SiteLocalboolean

    Boolean flag that controls is ipv6 site local.

    isIPv6Teredoboolean

    Boolean flag that controls is ipv6 teredo.

    isIPv6UniqueLocalboolean

    Boolean flag that controls is ipv6 unique local.

    isIPv4MappedToIPv6boolean

    Boolean flag that controls is ipv4 mapped to ipv6.

    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

    Allowed value for rule.

    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.

  • ]
  • vms object[]nullable

    The VMs reachable through the public IP.

  • Array [
  • vmIdstring<uuid>

    Id of the VM.

    vmNamestringnullable

    Name of the VM, when known.

  • ]
  • ]
  • 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.

    PublicIpResponsePagedResponse
    {
    "items": [
    {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "networkId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "operation": "Provision",
    "operationStatus": "Queued",
    "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
    }
    }
    ],
    "vms": [
    {
    "vmId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "vmName": "string"
    }
    ]
    }
    ],
    "total": 0,
    "page": 0,
    "pageSize": 0,
    "totalPages": 0,
    "hasNextPage": true
    }