server

Detach a storage device from a Cloud Server

Detach a storage device identified by its device address or storage resource UUID. IDE and CD-ROM devices cannot be detached while the Cloud Server is started.

post/1.3/server/{uuid}/storage/detach

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/server/{uuid}/storage/detach
  • Auth: HTTP bearer

Path parameters

uuidstring uuid required

Universally unique identifier

Example:0414e0d7-4436-4037-9dd8-6eaf47dce599

Cloud Server UUID

Request body

Example request

{
  "storage_device": {
    "address": "virtio:0"
  }
}

Response

Storage device detached

Example response

{
  "server": {
    "boot_order": "disk",
    "core_number": "12",
    "created": 1705320000,
    "firewall": "on",
    "host": 7653311107,
    "hostname": "server1.example.com",
    "labels": {
      "label": [
        {
          "key": "env",
          "value": "development"
        }
      ]
    },
    "license": "0",
    "memory_amount": "130048",
    "nic_model": "virtio",
    "plan": "GPU-12xCPU-128GB-2xL40S",
    "plan_ipv4_bytes": "3565675343",
    "plan_ipv6_bytes": "4534432",
    "remote_access_enabled": "yes",
    "remote_access_type": "vnc",
    "server_group": "0b3d85b4-b3be-46ca-a1e2-3b5d40d60fb1",
    "simple_backup": "0100,dailies",
    "state": "started",
    "storage_devices": {
      "storage_device": [
        {
          "address": "virtio:0",
          "boot_disk": "1",
          "labels": [],
          "storage": "012580a1-32a1-466e-a323-689ca16f2d43",
          "storage_encrypted": "yes",
          "storage_size": 20,
          "storage_title": "Operating system disk",
          "type": "disk"
        }
      ]
    },
    "tags": {
      "tag": [
        "DEV",
        "Ubuntu"
      ]
    },
    "timezone": "UTC",
    "title": "Development GPU server",
    "uuid": "0077fa3d-32db-4b09-9f5f-30d9e9afb565",
    "video_model": "cirrus",
    "zone": "fi-hel1"
  }
}

Changes

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