Cập nhật cấu hình VM

PUT/v2.1/servers/{server_id}

Cập nhật các thuộc tính có thể sửa của VM. Các thay đổi về capacity như vCPU và RAM không thực hiện ở đây; hãy dùng action resize.

info

Nguồn: update-server

Request

Tham số

server_idstringbắt buộcpath

UUID của VM.

serverobjectbắt buộcbody

Object bọc server.

5 trường

namestringbody

Tên mới của VM.

descriptionstringbody

Description dạng tự do, tối đa 255 ký tự.

accessIPv4stringbody

Địa chỉ IPv4 dùng để truy cập VM này.

accessIPv6stringbody

Địa chỉ IPv6 dùng để truy cập VM này.

OS-DCF:diskConfigstringbody

AUTO hoặc MANUAL. Áp dụng khi disk được phân vùng lúc create, rebuild hoặc resize.

Request mẫu

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

Response

Response mẫu

Response body

{
  "server": {
    "id": "642b7726-bc3b-4824-872b-124097d2d20c",
    "name": "vm1-renamed",
    "links": [
      {
        "rel": "self",
        "href": "https://api.vietnix.cloud:8774/v2.1/servers/642b7726-bc3b-4824-872b-124097d2d20c"
      },
      {
        "rel": "bookmark",
        "href": "https://api.vietnix.cloud:8774/servers/642b7726-bc3b-4824-872b-124097d2d20c"
      }
    ]
  }
}

Mã trạng thái

Thành công

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

Lỗi

Mã	Mô tả
400 - Bad Request	Nội dung trong request không hợp lệ, ví dụ description dài quá 255 ký 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	VM không tồn tại, hoặc không hiển thị với project của bạn.
409 - Conflict	VM đang ở trạng thái không cho phép thay đổi này.

note

Khi script hoá lệnh gọi này, hãy đổi từng thuộc tính một. Đổi tên VM không thay đổi hostname bên trong guest, và không ảnh hưởng đến các ID mà endpoint khác dùng.