Update a Volume

PUT

/volumes/{id}

Updates the Volume properties.

Note that when updating labels, the volume’s current set of labels will be replaced with the labels provided in the request body. So, for example, if you want to add a new label, you have to provide all existing labels plus the new label in the request body.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200The `volume` key contains the updated volume

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.hetzner.cloud/v1/volumes/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "labels": {
        "labelkey": "value"
    },
    "name": "database-storage"
}'

Response Example

{
    "volume": {
        "created": "2016-01-30T23:50:11.000Z",
        "format": "xfs",
        "id": 4711,
        "labels": {
            "labelkey": "value"
        },
        "linux_device": "/dev/disk/by-id/scsi-0HC_Volume_4711",
        "location": {
            "city": "Falkenstein",
            "country": "DE",
            "description": "Falkenstein DC Park 1",
            "id": 1,
            "latitude": 50.47612,
            "longitude": 12.370071,
            "name": "fsn1",
            "network_zone": "eu-central"
        },
        "name": "database-storage",
        "protection": {
            "delete": false
        },
        "server": 12,
        "size": 42,
        "status": "available"
    }
}

Modified at 2023-08-16 03:09:21

Get a Volume

Get all Actions for a Volume