Skip to main content

Machine Statuses Overview

Machine statuses provide immediate insight into the rental availability of machines on the platform. This concise guide explains the significance of each status from a server-user perspective, helping you manage deployments and resource allocation efficiently.

Status Definitions​

available​

When a machine is marked as available, it is not currently rented and is ready for immediate deployment. This status indicates that the machine can accept jobs or deployments without any delay, making it ideal for clients looking to rent computing resources.

unavailable​

Machines with an unavailable status are not open for rental due to various reasons. This includes being currently rented by another vendor, undergoing maintenance, being offline, decommissioning, or other conditions rendering them unsuitable for immediate use.

Status Transitions and Their Implications​

  • available ➔ unavailable: This transition occurs when a machine is either rented by another vendor or becomes unsuitable for new rentals (e.g., due to maintenance or going offline).
  • unavailable ➔ available: A machine returns to rental availability after resolving issues that previously marked it as unavailable or when a rental period ends and it is not renewed.

Key Points for Users​

  • For Rent: Only machines with an available status are open for new rentals.
  • Maintenance and Monitoring: Machines marked as unavailable may be undergoing maintenance or are currently rented by another vendor. Monitoring these statuses helps in planning and resource management.

Practical Use​

To find machines based on their status, utilize the platform's API. For example, to list all machines currently unavailable for rent, you can use the following command:

curl -X GET "https://api.hiveon.ai/clore/v1/machines?filter=status:unavailable" -H "Accept: application/json"