Xem chi tiết VM

GET/v2.1/servers/{server_id}

Để xem thông tin chi tiết của một máy ảo (VM) cụ thể, bạn gửi request GET tới endpoint /v2.1/servers/{server_id} của compute service, thay {server_id} bằng ID thực tế của VM cần lấy. Request này cần token xác thực, bạn đưa token vào header của request.

info

Nguồn: show-server-details

Request

Tham số path

server_idstringbắt buộc

UUID của server.

Request mẫu

cURL
HTTP

curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://api.vietnix.cloud:8774/v2.1/servers/{server_id}

GET https://api.vietnix.cloud:8774/v2.1/servers/{server_id}

Response

Tham số

serverobjectbắt buộc

Object server.

idstringbắt buộc

UUID của server.

linksarraybắt buộc

Link tới các tài nguyên liên quan. Xem API Guide / Links and References để biết thêm.

namestringbắt buộc

Tên server.

accessIPv4stringbắt buộc

Địa chỉ IPv4 dùng để truy cập server này. Có thể được nhà cung cấp tự động gán.

accessIPv6stringbắt buộc

Địa chỉ IPv6 dùng để truy cập server này. Có thể được nhà cung cấp tự động gán.

addressesobjectbắt buộc

Địa chỉ của server. Server ở trạng thái BUILD sẽ ẩn thông tin địa chỉ.

security_groupsarray

Một hoặc nhiều object security group.

1 trường

namestringbắt buộcbody

Tên security group.

config_drivestringbắt buộc

Cho biết server này có dùng config drive hay không. True hoặc chuỗi rỗng (rỗng nghĩa là False).

createdstringbắt buộc

Thời điểm tài nguyên được tạo (ISO 8601, CCYY-MM-DDThh:mm:ss±hh:mm).

flavorobjectbắt buộc

Trước microversion 2.47: ID và link của flavor (có thể rỗng). Từ 2.47: một phần thông tin flavor dưới dạng dictionary lồng nhau.

9 trường

idstringbắt buộcbody

ID của flavor. Chỉ có đến phiên bản 2.46.

linksarraybắt buộcbody

Link tới tài nguyên flavor. Chỉ có đến phiên bản 2.46.

vcpusintegerbắt buộcbody

Số vCPU cấp cho server. Mới trong 2.47.

ramintegerbắt buộcbody

RAM tính bằng MiB. Mới trong 2.47.

diskintegerbắt buộcbody

Kích thước disk gốc tính bằng GiB. Mới trong 2.47.

ephemeralintegerbắt buộcbody

Kích thước ephemeral disk tính bằng GiB. Mới trong 2.47.

swapintegerbắt buộcbody

Kích thước swap disk tính bằng MiB. Mới trong 2.47.

original_namestringbắt buộcbody

Tên hiển thị của flavor. Mới trong 2.47.

extra_specsobjectbody

Cặp key/value extra-spec của flavor; chỉ có khi policy cho phép. Mới trong 2.47.

2 trường

keystringbắt buộcbody

Key của extra spec. Mới trong 2.47.

valuestringbắt buộcbody

Giá trị của extra spec. Mới trong 2.47.

guest_agentobjectbắt buộc

Trạng thái kết nối và phiên bản của guest tools.

hci_infoobjectbắt buộc

Thông tin về network, disk, trait và bản phân phối OS của VM.

hostIdstringbắt buộc

Định danh host đã băm, duy nhất theo project; hữu ích để kiểm tra colocation trong cùng project.

host_statusstring

Trạng thái host: UP, UNKNOWN, DOWN, MAINTENANCE hoặc rỗng (không có host). Chỉ xuất hiện nếu policy cho phép. Mới trong 2.16.

imageobjectbắt buộc

UUID và link của image. Chuỗi rỗng khi boot từ volume.

image_metadataobject

Cặp key/value metadata của image (tối đa 255 byte cho mỗi key và mỗi value).

key_namestringbắt buộc

Tên key pair liên kết, nếu có.

lockedbooleanbắt buộc

True nếu instance đang bị khoá; ngược lại là False. Mới trong 2.9.

locked_reasonstringbắt buộc

Lý do khoá server. Mới trong 2.73.

memory_mbintegerbắt buộc

Bộ nhớ của hypervisor này (MiB). Có đến phiên bản 2.87.

metadataobjectbắt buộc

Cặp key/value metadata (giữ lại để tương thích ngược).

OS-DCF:diskConfigstringbắt buộc

Cấu hình disk: AUTO hoặc MANUAL.

OS-EXT-AZ:availability_zonestringbắt buộc

Tên availability zone (VHI trả về default hoặc null).

OS-EXT-SRV-ATTR:hoststringbắt buộc

Compute host đang chạy instance này (chỉ admin).

OS-EXT-SRV-ATTR:hostnamestring

Hostname đặt trên instance (chỉ admin). Mới trong 2.3.

OS-EXT-SRV-ATTR:hypervisor_hostnamestringbắt buộc

Tên host hypervisor (với Ironic: UUID node) (chỉ admin).

OS-EXT-SRV-ATTR:instance_namestringbắt buộc

Tên instance do template sinh ra (chỉ admin).

OS-EXT-SRV-ATTR:kernel_idstring

UUID kernel image khi dùng AMI; null nếu không (chỉ admin). Mới trong 2.3.

OS-EXT-SRV-ATTR:launch_indexinteger

Chỉ số thứ tự khởi tạo khi tạo nhiều server (chỉ admin). Mới trong 2.3.

OS-EXT-SRV-ATTR:reservation_idstring

ID reservation của server (chỉ admin). Mới trong 2.3.

OS-EXT-SRV-ATTR:ramdisk_idstring

UUID ramdisk image khi dùng AMI; null nếu không (chỉ admin). Mới trong 2.3.

OS-EXT-SRV-ATTR:root_device_namestring

Tên thiết bị gốc (chỉ admin). Mới trong 2.3.

OS-EXT-SRV-ATTR:user_datastring

user_data được cung cấp khi tạo (chỉ admin). Mới trong 2.3.

OS-EXT-STS:power_stateintegerbắt buộc

Trạng thái nguồn: 0 NOSTATE, 1 RUNNING, 3 PAUSED, 4 SHUTDOWN, 6 CRASHED, 7 SUSPENDED, 8 SHUTDOWN_ACTIVE.

OS-EXT-STS:task_statestringbắt buộc

Trạng thái tác vụ của instance.

OS-EXT-STS:vm_statestringbắt buộc

Trạng thái VM.

os-extended-volumes:volumes_attachedarraybắt buộc

Các volume đã gắn, nếu có.

2 trường

idstringbắt buộcbody

ID volume đã gắn.

delete_on_terminationbooleanbắt buộcbody

Volume có bị xoá cùng server hay không (mặc định False). Mới trong 2.3.

OS-SRV-USG:launched_atstringbắt buộc

Thời điểm server được khởi tạo (ISO 8601); null nếu chưa đặt.

OS-SRV-USG:terminated_atstringbắt buộc

Thời điểm server bị xoá (ISO 8601); null nếu chưa đặt.

descriptionstringbắt buộc

Mô tả server. Mới trong 2.19.

server_groupsarraybắt buộc

UUID của các server group mà server này thuộc về (tối đa 1). Mới trong 2.71.

tagsarraybắt buộc

Danh sách tag (tối đa 50). Mới trong 2.26.

trusted_image_certificatesarraybắt buộc

ID chứng chỉ tin cậy dùng để xác minh chữ ký image (tối đa 50); null nếu chưa đặt. Mới trong 2.63.

progressinteger

Phần trăm tiến trình khi status là ACTIVE, BUILD, REBUILD, RESIZE, VERIFY_RESIZE hoặc MIGRATING.

statusstringbắt buộc

Trạng thái server.

tenant_idstringbắt buộc

UUID của tenant (project).

updatedstringbắt buộc

Thời điểm tài nguyên được cập nhật (ISO 8601, CCYY-MM-DDThh:mm:ss±hh:mm).

user_idstringbắt buộc

ID của user sở hữu server.

faultobject

Object fault; hiển thị khi status là ERROR hoặc DELETED và có lỗi xảy ra.

4 trường

codeintegerbắt buộcbody

Mã response lỗi.

createdstringbắt buộcbody

Thời điểm exception được ném ra (ISO 8601).

messagestringbắt buộcbody

Thông báo lỗi.

detailsstringbody

Stack trace (có nếu mã response không phải 500 hoặc bạn có quyền admin).

vcpu_modelobjectbắt buộc

Mô tả model CPU ảo đang dùng.

vcpusintegerbắt buộc

Số CPU ảo server sử dụng.

Mã trạng thái

Thành công

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

Lỗi

Mã	Mô tả
401 - Unauthorized	User phải 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	Không tìm thấy tài nguyên được yêu cầu.

Response mẫu

Response body

{
    "server": {
        "id": "393210ad-152b-4ac3-a0f0-798ee4e93620",
        "name": "Ubuntu22",
        "status": "ACTIVE",
        "tenant_id": "f33507157a634f1cac71e06a70fb558e",
        "user_id": "64166c7effeb4a89b59c073588099640",
        "metadata": {
            "ha_enabled": "True"
        },
        "hostId": "8832df28df03a13573bd7478e79d31483ce42e75c8d1a291f2d9637a",
        "image": "",
        "flavor": {
            "id": "dee219cf-cd93-41c1-bae7-0c9874a0cc31",
            "links": [
                {
                    "rel": "bookmark",
                    "href": "https://api.vietnix.cloud:8774/flavors/dee219cf-cd93-41c1-bae7-0c9874a0cc31"
                }
            ]
        },
        "created": "2025-09-22T02:43:51Z",
        "updated": "2025-09-22T02:44:00Z",
        "addresses": {
            "test01": [
                {
                    "version": 4,
                    "addr": "192.168.0.75",
                    "OS-EXT-IPS:type": "fixed",
                    "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:26:de:79"
                }
            ]
        },
        "accessIPv4": "",
        "accessIPv6": "",
        "links": [
            {
                "rel": "self",
                "href": "https://api.vietnix.cloud:8774/v2.1/servers/393210ad-152b-4ac3-a0f0-798ee4e93620"
            },
            {
                "rel": "bookmark",
                "href": "https://api.vietnix.cloud:8774/servers/393210ad-152b-4ac3-a0f0-798ee4e93620"
            }
        ],
        "OS-DCF:diskConfig": "MANUAL",
        "progress": 0,
        "OS-EXT-AZ:availability_zone": "nova",
        "config_drive": "",
        "key_name": "Docs Writter",
        "OS-SRV-USG:launched_at": "2025-09-22T02:43:59.000000",
        "OS-SRV-USG:terminated_at": null,
        "security_groups": [
            {
                "name": "default"
            }
        ],
        "OS-EXT-STS:task_state": null,
        "OS-EXT-STS:vm_state": "active",
        "OS-EXT-STS:power_state": 1,
        "OS-EXT-STS:power_state_reason": "unpaused",
        "os-extended-volumes:volumes_attached": [
            {
                "id": "75a55d31-a6dc-48a2-82e2-3d6ac0f8a2bc",
                "size": 10
            }
        ],
        "vcpu_model": {
            "arch": null,
            "vendor": null,
            "topology": {
                "nova_object.name": "VirtCPUTopology",
                "nova_object.namespace": "nova",
                "nova_object.version": "1.0",
                "nova_object.data": {
                    "sockets": 1,
                    "cores": 2,
                    "threads": 1
                },
                "nova_object.changes": [
                    "threads",
                    "sockets",
                    "cores"
                ]
            },
            "features": [],
            "mode": "host-model",
            "model": null,
            "match": "exact"
        },
        "image_metadata": {
            "image_validated": "yes",
            "os_distro": "ubuntu22.04",
            "hci_allow_set_password": "True",
            "os_admin_user": "root",
            "min_ram": "0",
            "min_disk": "10",
            "disk_format": "qcow2",
            "container_format": "bare",
            "base_image_ref": "41ecdf81-c112-4231-9fea-049e70f3b564",
            "hw_machine_type": "pc-q35-vz9.0.0",
            "hw_vif_multiqueue_enabled": "True"
        },
        "required_traits": [],
        "hci_info": {
            "network": [
                {
                    "mac": "fa:16:3e:26:de:79",
                    "emulation_type": "virtio",
                    "ips": [
                        "192.168.0.75"
                    ],
                    "network": {
                        "id": "8ae2b710-ad3d-469e-a75a-c3e203887d2e",
                        "bridge": "br-int",
                        "label": "test01",
                        "subnets": [
                            {
                                "cidr": "192.168.0.0/24",
                                "dns": [
                                    {
                                        "address": "8.8.8.8",
                                        "type": "dns",
                                        "version": 4,
                                        "meta": {}
                                    }
                                ],
                                "gateway": {
                                    "address": "192.168.0.1",
                                    "type": "gateway",
                                    "version": 4,
                                    "meta": {}
                                },
                                "ips": [
                                    {
                                        "address": "192.168.0.75",
                                        "type": "fixed",
                                        "version": 4,
                                        "meta": {},
                                        "floating_ips": []
                                    }
                                ],
                                "routes": [],
                                "version": 4,
                                "meta": {
                                    "dhcp_server": "192.168.0.2"
                                }
                            }
                        ],
                        "meta": {
                            "injected": true,
                            "tenant_id": "f33507157a634f1cac71e06a70fb558e",
                            "mtu": 8913,
                            "physical_network": null,
                            "tunneled": true
                        }
                    },
                    "port_security_enabled": true
                }
            ],
            "boot_order": [
                "hd"
            ],
            "vzhardware": "2.0.1",
            "max_mem": null,
            "max_vcpu": null,
            "has_pci_devices": false
        },
        "memory_mb": 2048,
        "vcpus": 2,
        "root_gb": 0,
        "guest_agent": {
            "status": "connected",
            "version": "7.22-1.vz7"
        },
        "username": "root",
        "allow_set_password": true
    }
}

Request​

Tham số path​

Request mẫu​

Response​

Tham số​

Mã trạng thái​

Thành công​

Lỗi​

Response mẫu​