Volumes

Get volume by id

Changed on
get/v1/volumes/{volume_id}

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/volumes/{volume_id}
  • Auth: HTTP bearer

Path parameters

volume_idstring required
Example:2b61f504-10fe-4e73-a752-cf8ddb81349e

Response

Returns volume details

OR

Example response

{
  "id": "50494c5e-3ec0-4681-a4d9-10a51d47a7ac",
  "instances": [
    {
      "id": "b6c33a1a-9d83-497d-8169-cab3097b99cc",
      "auto_rental_extension": null,
      "ip": "123.123.123.123",
      "instance_type": "4A100.88V",
      "status": "running",
      "os_volume_id": "08014786-b3df-48cd-87f4-db70c622d161",
      "hostname": "hazy-star-swims-fin-01",
      "instance_template": {
        "instance_type": "4A100.88V",
        "cpu_cores": 128,
        "gpu_number": 4,
        "gpu_vram_gb": 80,
        "ram_gb": 512
      },
      "instance_model": {
        "code": "A100_80G",
        "manufacturer": "NVIDIA",
        "category": "GPU",
        "cluster_model_code": null
      }
    }
  ],
  "name": "OS-NVMe-84Ca37Jf",
  "created_at": "2024-07-08T19:19:54.247Z",
  "status": "attached",
  "size": 100,
  "is_os_volume": true,
  "type": "NVMe",
  "location": "FIN-01",
  "ssh_key_ids": [
    "9d7be80c-a65a-4b26-8cf1-96ea77d3997a"
  ],
  "contract": "LONG_TERM",
  "base_hourly_cost": 0.0273972602739726,
  "monthly_price": 20,
  "currency": "eur",
  "long_term": {
    "end_date": "2025-01-08T19:34:16.663Z",
    "long_term_period": "3 months",
    "discount_percentage": 14,
    "auto_rental_extension": false,
    "next_period_price": 49.93356,
    "current_period_price": 49.93356
  },
  "tags": [
    {
      "id": "tag_0aB1cD2eF3gH4iJ5kL6mN7",
      "key": "environment",
      "value": "production"
    }
  ]
}

Changes

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • breaking

      the //// response's property type changed from string to object for status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status