Cập nhật volume

PUT/v3/{project_id}/volumes/{volume_id}

Cập nhật các thuộc tính có thể sửa của volume: tên, mô tả và metadata. Dung lượng và type không thay đổi ở đây; dùng thao tác extend hoặc retype volume thay thế.

info

Nguồn: update-a-volume

Request

Tham số

project_idstringbắt buộcpath

UUID của project.

volume_idstringbắt buộcpath

UUID của volume.

volumeobjectbắt buộcbody

Object chứa volume.

3 trường

namestringbody

Tên mới của volume.

descriptionstringbody

Mô tả mới của volume.

metadataobjectbody

Cặp key/value metadata gắn với volume.

Request mẫu

curl -ks -X PUT -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
-d '{
  "volume": {
    "name": "vol3"
  }
}' https://api.vietnix.cloud:8776/v3/{project_id}/volumes/{volume_id}

Response

Response mẫu

Response body

{
  "volume": {
    "id": "de5b7dfc-e3e8-4f14-9969-98d61af40329",
    "name": "vol3",
    "description": "Volume 2",
    "status": "available",
    "size": 3,
    "volume_type": "default",
    "attachments": [],
    "multiattach": false,
    "metadata": {},
    "created_at": "2026-02-18T09:12:44.000000",
    "updated_at": "2026-02-18T09:41:02.000000"
  }
}

Mã trạng thái

Thành công

Mã	Mô tả
200 - OK	Volume đã được cập nhật.

Lỗi

Mã	Mô tả
400 - Bad Request	Nội dung request không hợp lệ.
401 - Unauthorized	Cần xác thực trước khi gửi request.
403 - Forbidden	Policy không cho phép user hiện tại thực hiện thao tác này.
404 - Not Found	Volume không tồn tại hoặc không hiển thị với project của bạn.

note

Đổi tên volume không thay đổi đường dẫn device bên trong guest đang gắn volume. Metadata được thay thế cho các key bạn gửi, không được merge với map hiện có.