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

Xem chi tiết volume

GET/v3/{project_id}/volumes/{volume_id}

Để xem chi tiết một volume trong project, gửi request GET tới endpoint /v3/{project_id}/volumes/{volume_id} của volume service, thay {project_id} bằng project ID và {volume_id} bằng ID của volume cần xem. Request cần token xác thực, gửi kèm trong header.

info

Nguồn: get-volume

Request​

Tham số​

project_idstringbắt buộc

UUID của project trong cloud multi-tenancy.

volume_idstringbắt buộc

UUID của volume.

Request mẫu​

Dùng curl​

curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://api.vietnix.cloud:8776/v3/{PROJECT_ID}/volumes/{VOLUME_ID}

HTTP request​

GET https://api.vietnix.cloud:8776/v3/{PROJECT_ID}/volumes/{VOLUME_ID}

Response​

Tham số​

volumeobjectbắt buộc

Object volume.

migration_statusstring

Trạng thái migration của volume. Chỉ admin.

attachmentsarraybắt buộc

Thông tin gắn instance khi volume được gắn vào server; ngược lại là rỗng.

idstringbắt buộc

UUID của volume.

linksarraybắt buộc

Liên kết của volume.

namestringbắt buộc

Tên volume.

sizeintegerbắt buộc

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

bootablestringbắt buộc

Bật hoặc tắt thuộc tính bootable.

statusstringbắt buộc

Trạng thái volume.

created_atstringbắt buộc

Ngày giờ tạo tài nguyên (ISO 8601).

availability_zonestringbắt buộc

Tên availability zone.

descriptionstringbắt buộc

Mô tả volume.

multiattachbooleanbắt buộc

Nếu true, volume có thể gắn vào nhiều instance.

source_volidstring

UUID của volume nguồn; volume mới có dung lượng ít nhất bằng volume này.

volume_typestringbắt buộc

Tên volume type liên kết.

service_uuidstringbắt buộc

Định danh node đang phục vụ volume. Mới trong phiên bản 3.48.

shared_targetsbooleanbắt buộc

Backend có dùng shared_targets hay không. Mặc định true. Mới trong phiên bản 3.48.

os-vol-host-attrstring

Backend hiện tại. Định dạng: host@backend#pool.

encryptedbooleanbắt buộc

Nếu true, volume được mã hoá.

updated_atstringbắt buộc

Ngày giờ cập nhật tài nguyên (ISO 8601) hoặc null.

replication_statusstringbắt buộc

Trạng thái replication của volume.

snapshot_idstring

UUID của snapshot mà volume được tạo từ đó.

user_idstringbắt buộc

UUID của user.

os-vol-tenant-attrstringbắt buộc

ID project mà volume thuộc về.

os-vol-mig-status-attrstring

Trạng thái migration của volume (None nghĩa là không đang diễn ra).

os-vol-mig-status-attrstring

ID volume mà tên volume trên backend dựa vào.

metadataobjectbắt buộc

Metadata key/value gắn với volume.

volume_image_metadataobject

Các mục metadata image; có khi volume được tạo từ image hoặc snapshot của image.

consistencygroup_idstringbắt buộc

UUID của consistency group.

Mã trạng thái​

Thành công​

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

Lỗi​

MãMô tả
401 - UnauthorizedCần xác thực trước khi gửi request.
403 - ForbiddenPolicy không cho phép user hiện tại thực hiện thao tác này.

Response mẫu​

Response body
{
    "volume": {
        "id": "30deaa51-7690-48e4-9a04-131e74db74c3",
        "status": "in-use",
        "size": 20,
        "availability_zone": "nova",
        "created_at": "2025-09-22T10:08:20.303259",
        "updated_at": "2025-09-22T10:08:25.471813",
        "name": "kub01-diqorkiwjmux-kube_minions-iulg6ecboyfz-0-exmhruv4vsey-kube_node_volume-gbieb2z4bdlf",
        "description": null,
        "volume_type": "nvmer3",
        "snapshot_id": null,
        "source_volid": null,
        "metadata": {
            "vzhardware": "2.0.1"
        },
        "links": [
            {
                "rel": "self",
                "href": "https://api.vietnix.cloud:8776/v3/f33507157a634f1cac71e06a70fb558e/volumes/30deaa51-7690-48e4-9a04-131e74db74c3"
            },
            {
                "rel": "bookmark",
                "href": "https://api.vietnix.cloud:8776/f33507157a634f1cac71e06a70fb558e/volumes/30deaa51-7690-48e4-9a04-131e74db74c3"
            }
        ],
        "user_id": "304e91ae6f114b46914834ae58469754",
        "bootable": "true",
        "encrypted": false,
        "replication_status": null,
        "consistencygroup_id": null,
        "multiattach": false,
        "attachments": [
            {
                "id": "30deaa51-7690-48e4-9a04-131e74db74c3",
                "attachment_id": "1db813b3-5673-4eab-a86d-89972cfc8174",
                "volume_id": "30deaa51-7690-48e4-9a04-131e74db74c3",
                "server_id": "6cc8656c-f8aa-4c2d-9436-0da855bcd4d6",
                "host_name": null,
                "device": "/dev/vda",
                "attached_at": "2025-09-22T10:08:25.414019"
            }
        ],
        "os-vol-tenant-attr:tenant_id": "f33507157a634f1cac71e06a70fb558e",
        "volume_image_metadata": {
            "os_distro": "fedora-coreos",
            "version": "41.20250117.3.0-7.2.0_4.vl9",
            "owner_specified.openstack.md5": "",
            "owner_specified.openstack.sha256": "",
            "owner_specified.openstack.object": "images/fedora-coreos-x64-k8saas-secondary",
            "image_validated": "yes",
            "image_id": "d275727a-a1c9-4d71-8180-adadc7fc266b",
            "image_name": "fedora-coreos-x64-k8saas-secondary",
            "checksum": "7db807921dcb73698f7c724bcdf111a7",
            "container_format": "bare",
            "disk_format": "qcow2",
            "min_disk": "10",
            "min_ram": "0",
            "size": "3302162432"
        }
    }
}