Volumes

Get volume by id

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:b04a130c-cdab-423e-b76d-a1ac0b8ca8c1

Response

Returns volume details

OR

Example response

{
  "id": "aa4b07b2-d661-4238-87f1-2d8ae651e0bc",
  "instance_id": "56256bca-d488-4fb6-aa9b-7f1183675595",
  "instances": [
    {
      "id": "56256bca-d488-4fb6-aa9b-7f1183675595",
      "auto_rental_extension": null,
      "ip": "123.123.123.123",
      "instance_type": "4A100.88V",
      "status": "running",
      "os_volume_id": "77cfbad4-67ee-475c-99e7-8d7bc61c3e71",
      "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",
  "created_by_user_id": "7dfc2631-0158-4f74-93f6-6b46dcb90fef",
  "status": "attached",
  "size": 100,
  "is_os_volume": true,
  "target": "vda",
  "type": "NVMe",
  "location": "FIN-01",
  "ssh_key_ids": [
    "e846855f-b180-4381-be95-110b550cbfec"
  ],
  "pseudo_path": "volume-84Ca37Jf",
  "create_directory_command": "mkdir -p /mnt/volume",
  "mount_command": "mount -t nfs -o nconnect=16 nfs.fin-01.datacrunch.io:volume-88eb67d0 /mnt/volume",
  "filesystem_to_fstab_command": "grep -qxF 'nfs.fin-01.datacrunch.io:volume-88eb67d0 /mnt/volume nfs defaults 0 0' /etc/fstab || echo 'nfs.fin-01.datacrunch.io:volume-88eb67d0 /mnt/volume nfs defaults 0 0' | sudo tee -a /etc/fstab",
  "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

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