Chuyển tới nội dung chính

Cập nhật snapshot

PUT/v3/{project_id}/snapshots/{snapshot_id}

Cập nhật snapshot. Request cần token xác thực, gửi kèm trong header.

info

Nguồn: update-a-snapshot

Request​

Tham số​

project_idstringbắt buộcpath

UUID của project trong cloud multi-tenancy.

snapshot_idstringbắt buộcpath

UUID của snapshot.

snapshotobjectbắt buộcbody

Object snapshot.

namestringbắt buộcbody

Tên snapshot.

descriptionstringbody

Mô tả snapshot. Mặc định là None.

Request mẫu​

Dùng curl​

curl -ks -X PUT -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
-d '{
  "snapshot": {
    "name": "Snapshot-VM-west",
    "description": "Snapshot-VM-west - Ubuntu 22"
  }
}' https://api.vietnix.cloud:8776/v3/f33507157a634f1cac71e06a70fb558e/snapshots/40181172-d8b9-46a2-a9d8-c40ed9e098b5

HTTP request​

PUT https://api.vietnix.cloud:8776/v3/f33507157a634f1cac71e06a70fb558e/snapshots/40181172-d8b9-46a2-a9d8-c40ed9e098b5

với body

{
  "snapshot": {
    "name": "Snapshot-VM-west",
    "description": "Snapshot-VM-west - Ubuntu 22"
  }
}

Response​

Tham số​

snapshotobjectbắt buộc

Object snapshot.

user_idstringbắt buộc

UUID của user. Mới trong phiên bản 3.41

volume_idstringbắt buộc

Nếu snapshot được tạo từ volume, đây là ID của volume.

namestringbắt buộc

Tên snapshot.

statusstringbắt buộc

Trạng thái của snapshot.

descriptionstringbắt buộc

Mô tả snapshot.

created_atstringbắt buộc

Ngày giờ tạo tài nguyên. Định dạng dấu thời gian ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm. Ví dụ: 2015-08-27T09:49:58-05:00. Giá trị ±hh (nếu có) là múi giờ lệch so với UTC.

metadataobjectbắt buộc

Một hoặc nhiều cặp key-value metadata của snapshot, nếu có.

idstringbắt buộc

UUID của snapshot.

sizeintegerbắt buộc

Dung lượng volume, tính bằng gibibyte (GiB).

updated_atstringbắt buộc

Ngày giờ cập nhật tài nguyên. Nếu tài nguyên chưa từng được cập nhật, trường này có giá trị null. Định dạng dấu thời gian ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm. Ví dụ: 2015-08-27T09:49:58-05:00. Giá trị ±hh (nếu có) là múi giờ lệch so với UTC.

Mã trạng thái​

Thành công​

MãMô tả
200 - OKRequest thành công.

Response mẫu​

Response body
{
    "snapshot": {
        "id": "40181172-d8b9-46a2-a9d8-c40ed9e098b5",
        "created_at": "2025-10-07T07:07:26.294739",
        "updated_at": "2025-10-07T07:07:27.932048",
        "name": "Snapshot-VM-west",
        "description": "Snapshot-VM-west - Ubuntu 22",
        "volume_id": "b0738bcc-3513-4066-852d-c70b8d966ffd",
        "volume_type_id": "e9f2ecf9-697f-4af7-b084-8d4d072d7974",
        "status": "available",
        "size": 10,
        "metadata": {}
    }
}