Servers

Create Server

Deploy a new GPU server. A public IP address is assigned once the server is running. The first hour (hourly billing) is taken from the credit balance. Neither a saved card nor the automatic reload is required: the only requirement is paying the first hour. onFundsExhausted chooses what happens at the threshold; when the automatic reload is off, the answer carries autoReloadWarning.

post/servers

Request

  • Base URL: https://gpucloud.ca/api
  • URL: https://gpucloud.ca/api/servers
  • Auth: HTTP bearer

Request body

productIdstring required

GPU plan id (GET /v1/gpu), e.g. gpu-l40

sshKeyIdstring required

SSH key id (GET /settings/ssh-keys)

namestring

Optional server name

region'canada-montreal'

Deployment region

onFundsExhausted'HIBERNATE' | 'DELETE'

What happens to this hourly server when the balance reaches its threshold and no automatic reload brings it back. HIBERNATE: hibernated (its GPU place is kept, hourly hibernation fee), restarted as soon as the balance is back above the threshold, deleted after 12 hours without credit. DELETE: deleted at once, no hibernation fee, data lost. Machines that cannot be hibernated (spot) are always DELETE. Any other value: 400.

Example request

{
  "productId": "gpu-l40"
}

Response

Server created and provisioning started

Example response

{
  "data": {
    "status": "PROVISIONING"
  },
  "autoReloadWarning": {
    "message": "Without automatic reload, this server will be hibernated when your balance reaches $3.00 (its threshold), then deleted 12 h later without new credit. For an overnight job, turn on the automatic reload."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.