Support API Key Authentication

Rent a cluster

Changed on

Rent several nodes of one InfiniBand fabric as a single all-or-nothing order. Every node is given a WireGuard overlay address so NCCL's bootstrap can find its peers; the tensors travel over InfiniBand. Whole nodes only, and only the cluster image. An Idempotency-Key header makes a retry safe exactly as on POST /executors/{executor_uuid}/rent.

post/executors/cluster/rent

Request

  • Base URL: https://lium.io/api
  • URL: https://lium.io/api/executors/cluster/rent
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring

Makes a retry safe: within 24 h the same key with the byte-identical body returns the first call's answer with Idempotent-Replayed: true; a different body is 422 idempotency_key_reused; a repeat while the first call runs is 409 idempotency_in_progress; a repeat of a call that may have rented but whose answer was not recorded is 409 idempotency_outcome_unknown, with no expiry.

X-Customer-Refstring

Your tag for the end customer of this one rental; overrides the key's customer_ref.

Request body

pod_namestring required
template_idstring uuid nullable
gpu_countinteger nullable
volume_idstring nullable
backup_log_idstring uuid nullable
restore_pathstring nullable
skip_add_agent_ssh_keyboolean nullable
termination_hoursinteger nullable
initial_port_countinteger nullable
enable_jupyterboolean nullable
enable_volume_encryptionboolean nullable
enable_backupsboolean
dockerfile_contentstring nullable
ncu_profilingboolean
executor_uuidsstring[] required

Example request

{
  "backup_log_id": "123e4567-e89b-12d3-a456-426614174000",
  "enable_jupyter": false,
  "initial_port_count": 10,
  "pod_name": "123e4567-e89b-12d3-a456-426614174000",
  "restore_path": "/home/user/data",
  "skip_add_agent_ssh_key": false,
  "template_id": "b21be992-dde1-4aa1-a42f-6787c7af9846",
  "termination_hours": 24,
  "user_public_key": [
    "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMo32AY0vFK7g5FBIBcyPdxaxSEM5rEc0kEzMVveA9b+",
    "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMo32AY0vFK7g5FBIBcyPdxaxSEM5rEc0kEzMVveA9eb+"
  ],
  "volume_id": "123e4567-e89b-12d3-a456-426614174000"
}

Response

Rent a cluster of nodes on one InfiniBand fabric

unknown required

Changes