Volumes

Get volume by id

get/v1/volumes/{volume_id}

Path parameters

volume_idstring required
Example:3f61e624-2e55-4eb9-914f-88a5001a1cf2

Response

Returns volume details

OR

Example response

{
  "id": "93c471c1-0810-49f8-a073-a81f999331b6",
  "instance_id": "d3a79bb2-85da-4921-b1e5-dd21d0da4f82",
  "instances": [
    {
      "id": "d3a79bb2-85da-4921-b1e5-dd21d0da4f82",
      "auto_rental_extension": null,
      "ip": "123.123.123.123",
      "instance_type": "4A100.88V",
      "status": "running",
      "os_volume_id": "514409f3-9b84-4ced-9d92-9a772603f50b",
      "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": [
    "537f578e-e336-4fee-a034-5397c6955115"
  ],
  "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

Changed in 1 of the 11 revisions of this API.2

    • added the required property oneOf[GetVolumeInTrashPublicResponseDto]/tags to the response with the 200 status

      response-required-property-added

    • added the required property oneOf[GetVolumePublicResponseDto]/tags to the response with the 200 status

      response-required-property-added