Skip to main content

VmResponsePagedResponse

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 VM.

    namestringnullable

    Host name of the VM.

    projectIdstring<uuid>

    Id of the project the VM belongs to.

    saleIdstring<uuid>

    Id of the tariff (sale) the VM was provisioned with.

    imageIdstring<uuid>

    Id of the OS image the VM was installed from.

    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]

    bootStatusVmBootStatus (string)

    Current boot lifecycle status.

    Possible values: [Stopped, Running]

    cpuinteger<int32>

    Number of CPU cores allocated to the VM.

    ramGbnumber<double>

    Amount of RAM allocated to the VM, in gigabytes.

    diskGbnumber<double>

    Amount of disk space allocated to the VM, in gigabytes.

    createdAtstring<date-time>

    When the VM was created.

    updatedAtstring<date-time>

    When the VM was last updated.

    networks object[]nullable

    Networks the VM is attached to.

  • Array [
  • idstring<uuid>

    Id of the network.

    namestringnullable

    Name of the network.

    typeNetworkType (string)

    Type discriminator of the resource.

    Possible values: [Wan, Lan]

    createdAtstring<date-time>

    When the network was created.

    publicIp object

    Allowed value for public ip.

    geolocationstringnullable

    Geolocation of the public IP.

    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.

  • ]
  • networksInterfaces object[]nullable

    The VM's network interfaces and their assigned addresses.

  • Array [
  • networkIdstring<uuid>

    Id of the network this interface is attached to.

    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.

  • ]
  • portForwardRules object[]nullable

    Port forwarding rules configured for the VM.

  • Array [
  • networkIdstring<uuid>

    Id of the network the rule applies to.

    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.

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

    VmResponsePagedResponse
    {
    "items": [
    {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "saleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "imageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "operation": "Provision",
    "operationStatus": "Queued",
    "bootStatus": "Stopped",
    "cpu": 0,
    "ramGb": 0,
    "diskGb": 0,
    "createdAt": "2024-07-29T15:51:28.071Z",
    "updatedAt": "2024-07-29T15:51:28.071Z",
    "networks": [
    {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "type": "Wan",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "publicIp": {
    "geolocation": "string",
    "ip": "192.168.0.1"
    }
    }
    ],
    "networksInterfaces": [
    {
    "networkId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "ip": "192.168.0.1"
    }
    ],
    "portForwardRules": [
    {
    "networkId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "Created",
    "rule": {
    "mode": "SpecificPorts",
    "protocol": "Tcp",
    "externalPort": 0,
    "internalPort": 0
    }
    }
    ]
    }
    ],
    "total": 0,
    "page": 0,
    "pageSize": 0,
    "totalPages": 0,
    "hasNextPage": true
    }