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

Xem chi tiết snapshot

GET/v3/{project_id}/snapshots/{snapshot_id}

Xem chi tiết snapshot theo ID được chỉ định. Request cần token xác thực, gửi kèm trong header.

info

Nguồn: show-a-snapshot-s-details

Request​

Tham số​

project_idstringbắt buộc

UUID của project trong cloud multi-tenancy.

snapshot_idstringbắt buộc

UUID của snapshot.

Request mẫu​

Dùng curl​

curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://api.vietnix.cloud:8776/v3/f33507157a634f1cac71e06a70fb558e/snapshots/40181172-d8b9-46a2-a9d8-c40ed9e098b5

HTTP request​

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

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.

os-extended-snapshot-attributesstringbắt buộc

Giá trị phần trăm tiến độ tạo.

os-extended-snapshot-attributesstringbắt buộc

UUID của project sở hữu.

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/Ubuntu-22.04-LTS-x64/Boot volume/2025-10-07 02:07:25",
        "description": null,
        "volume_id": "b0738bcc-3513-4066-852d-c70b8d966ffd",
        "volume_type_id": "e9f2ecf9-697f-4af7-b084-8d4d072d7974",
        "status": "available",
        "size": 10,
        "metadata": {},
        "os-extended-snapshot-attributes:project_id": "f33507157a634f1cac71e06a70fb558e",
        "os-extended-snapshot-attributes:progress": "100%"
    }
}