Cấu hình lại một ResourcePool

Mô tả Thay đổi thông tin cấu hình của một Resource Pool đã được tạo với các dữ liệu đầu vào là tên Resource Pool và các giá trị của tài nguyên được gán.

URI http://servername/provisioning/dcs/{dcname}/cluster/{cna

me}/rp/{rpname}

Phương thức PUT

Kiểu dữ liệu đầu vào Các tham số đường dẫn (path params)

Xâu dữ liệu đầu vào định dạng application/xml. Dữ liệu đầu vào Các tham số đường dẫn:

 dcname: tên của datacenter cần lấy dữ liệu.

 cname: tên của cụm dữ liệu chứa các vùng dữ liệu cần lấy ra.

 Rpname: tên của Resource Pool cần thay đổi cấu hình.

Xâu dữ liệu đầu vào định dạng XML:

PUT http://localhost:8080/provisioning/dc/VM- DC01/cluster/Cluster01/rp/RP001 HTTP/1.1 Accept: application/xml Accept-Language: en-us <resourcePool> <name>RP001_renamed</name> <cpuResource> <expandableReservation>false</expandableReservation> <limit>7523</limit> <reservation>2385</reservation> <shareLevel>Normal</shareLevel> </cpuResource> <memoryResource> <expandableReservation>true</expandableReservation> <limit>2453</limit> <reservation>777</reservation> <shareLevel>Custom</shareLevel> <shareValue>21920</shareValue> </memoryResource> </resourcePool> Kiểu dữ liệu đầu ra Application/xml

Dữ liệu đầu ra Danh sách tên các datacenter: HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT Location: http://localhost:8080/provisioning/dc/VM- DC01/cluster/Cluster01/rps

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên datacenter và/hoặc tên cụm dữ liệu không đúng.

 500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 10: Chức năng cấu hình lại một Resource Pool

4.4.7. Xóa một Resource Pool

Mô tả Xóa một Resource Pool theo tên datacenter, tên cụm dữ liệu và tên của Resource Pool cần xóa.

URI http://servername/provisioning/dcs/{dcname}/cluster/{cna

me}/rp{rpname}

Kiểu dữ liệu đầu vào Các tham số đường dẫn (path params)

Dữ liệu đầu vào  dcname: tên của datacenter cần lấy dữ liệu.

 cname: tên của cụm dữ liệu chứa các vùng dữ liệu cần lấy ra.

 rpname: tên của Resource Pool cần xóa. Kiểu dữ liệu đầu ra Không có

Dữ liệu đầu ra Không có

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên datacenter và/hoặc tên cụm dữ liệu không đúng.

 500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 11: Chức năng xóa một Resource Pool

4.4.8. Truy vấn danh sách các mẫu máy ảo

Mô tả Liệt kê danh sách tên mẫu máy ảo (templates) để sử dụng cho việc nhân bản máy.

URI http://servername/provisioning/templates

Kiểu dữ liệu đầu vào Không có Dữ liệu đầu vào Không có

Kiểu dữ liệu đầu ra Application/xml Dữ liệu đầu ra HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT

Location: http://localhost:8080/provisioning/templates

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

<virtualMachines> <virtualMachine> <name>Ubuntu_template</name> <numCpu>1</numCpu> <memorySize>2048</memorySize> <diskSize>2048</diskSize> <guest>

<guestOsId>ubuntuGuest</guestOsId> <guestOsFullName> Ubuntu Linux (32- bit)</guestOsFullName>

<guestFamily>linuxGuest</guestFamily> </guest>

</virtualMachine>

<name>WinXP_template</name> <memory>1024</memory> <numCPU>1</numCPU>

<guest>

<guestOsId>winXPProGuest</guestOsId> <guestOsFullName>Microsoft Windows XP Professional (32-bit)</guestOsFullName>

<guestFamily>windowsGuest</guestFamily> </guest>

</virtualMachine> </virtualMachines> Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 12: Chức năng truy vấn danh sách các mẫu máy ảo

4.4.9. Truy vấn danh sách các máy ảo

Mô tả Liệt kê danh sách máy ảo và trạng thái của chúng có trong một Resource Pool căn cứ vào tên datacenter, tên cụm dữ liệu và tên Resource Pool.

URI http://servername/provisioning/dc/{dcname}/cluster/{cnam

Phương thức GET

Kiểu dữ liệu đầu vào Các tham số đường dẫn (path params).

Dữ liệu đầu vào  dcname: tên của datacenter cần lấy dữ liệu.

 cname: tên của cụm dữ liệu chứa các vùng dữ liệu cần lấy ra.

 rpname: tên của Resource Pool cần lấy thông tin. Kiểu dữ liệu đầu ra Application/xml

Dữ liệu đầu ra HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT Location:

http://localhost:8080/provisioning/dc/{dcname}/cluster/{c name}/rp/{rpname}/vms

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

<virtualMachines> <virtualMachine> <name>Ubuntu_template</name> <numCpu>1</numCpu> <memorySize>2048</memorySize> <diskSize>2048</diskSize> <state>powerOn</state> <guest>

<guestOsId>ubuntuGuest</guestOsId> <guestOsFullName> Ubuntu Linux (32- bit)</guestOsFullName>

<guestFamily>linuxGuest</guestFamily> <nicSetting>

</guest>

</virtualMachine>

<name>WinXP_template</name> <memory>1024</memory> <numCPU>1</numCPU>

<state>powerOff</state>

<guest>

<guestOsId>winXPProGuest</guestOsId> <guestOsFullName>Microsoft Windows XP Professional (32-bit)</guestOsFullName>

<guestFamily>windowsGuest</guestFamily> <nicSetting>

</guest> </virtualMachine> </virtualMachines>

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên datacenter, tên cụm dữ liệu và/hoặc tên Resource Pool không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 13: Chức năng truy vấn danh sách các máy ảo

4.4.10. Truy vấn thông tin của một máy ảo

Mô tả Truy vấn thông tin của một máy ảo với các thông tin về bộ nhớ, dung lượng ổ đĩa cứng, số lượng CPU và thông tin về hệ điều hành căn cứ vào tên của máy ảo.

URI http://servername/provisioning/vm/{vmname}

Phương thức GET

Kiểu dữ liệu đầu vào Tham số đường dẫn (path param).

Dữ liệu đầu vào vmname: tên của máy ảo cần lấy dữ liệu. Kiểu dữ liệu đầu ra Application/xml

Dữ liệu đầu ra HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT

Location: http://localhost:8080/provisioning/vm/VM_001

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

<virtualMachine> <name>VM_001</name> <numCpu>2</numCpu> <memorySize>2048</memorySize> <diskSize>4096</diskSize> <state>powerOn</state> <guest>

<guestOsId>ubuntuGuest</guestOsId> <guestOsFullName> Ubuntu Linux (32- bit)</guestOsFullName>

<guestFamily>linuxGuest</guestFamily> <nicSetting>

</guest> </virtualMachine>

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 14: Chức năng truy vấn thông tin của một máy ảo

4.4.11. Tạo mới máy ảo

Mô tả Tạo mới một máy ảo với các thông tin về bộ nhớ, kích thước ổ cứng, số lượng CPU và tên của hệ điều hành chạy trên máy ảo.

URI http://servername/provisioning/vm

Phương thức POST

Kiểu dữ liệu đầu vào Xâu dữ liệu đầu vào dưới định dạng application/xml. Dữ liệu đầu vào POST http://localhost:8080/provisioning/vm HTTP/1.1

Accept: application/xml Accept-Language: en-us <virtualMachine> <name>VM_001</name> <numCpu>1</numCpu> <memorySize>2048</memorySize> <diskSize>2048</diskSize> <guest>

<guestOsId>ubuntuGuest</guestOsId> </guest>

</virtualMachine> Kiểu dữ liệu đầu ra Application/xml Dữ liệu đầu ra HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT Location: http://localhost:8080/provisioning/vm

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

<guestOsId>ubuntuGuest</guestOsId> </guest>

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 405 Method Not Allowed: nếu tên máy ảo mới đã tồn tại.

 500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 15: Chức năng tạo mới máy ảo

4.4.12. Cấu hình lại máy ảo

Mô tả Cấu hình lại máy ảo với các thông tin về bộ nhớ, thêm ổ đĩa cứng, số lượng CPU.

URI http://servername/provisioning/vm/{vmname}

Phương thức PUT

Kiểu dữ liệu đầu vào Xâu dữ liệu đầu vào dưới định dạng application/xml.

Dữ liệu đầu vào PUT http://localhost:8080/provisioning/vm/VM_001 HTTP/1.1 Accept: application/xml Accept-Language: en-us <virtualMachine> <numCpu>2</numCpu> <memorySize>2048</memorySize> <diskSize>2048</diskSize> </virtualMachine>

Kiểu dữ liệu đầu ra Application/xml Dữ liệu đầu ra HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT

Location: http://localhost:8080/provisioning/vm/VM_001

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

<guestOsId>ubuntuGuest</guestOsId> <guestOsFullName> Ubuntu Linux (32- bit)</guestOsFullName>

<guestFamily>linuxGuest</guestFamily> </guest>

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  405 Method Not Allowed: nếu việc cấu hình lại

không được cho phép trên máy ảo.

 500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 16: Chức năng cấu hình lại máy ảo

4.4.13. Xóa máy ảo

Mô tả Xóa một máy ảo đã có theo tên.

URI http://servername/provisioning/vm/{vmname}

Phương thức DELETE

Kiểu dữ liệu đầu vào Tham số đường dẫn (path param)

Dữ liệu đầu vào  vmname: tên của máy ảo cần xóa. Kiểu dữ liệu đầu ra Không có

Dữ liệu đầu ra Không có

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 17: Chức năng xóa máy ảo

4.4.14. Đánh dấu một máy ảo nhƣ một máy ảo mẫu

Mô tả Chuyển đổi một máy ảo sẵn có thành một mẫu (không cho phép sửa đổi nữa) để sử dụng cho các lần sau.

URI http://servername/provisioning/vm/{vmname}/markAsTem

Phương thức PUT

Kiểu dữ liệu đầu vào Tham số đường dẫn (path param)

Dữ liệu đầu vào vmname: tên của máy ảo chuyển đổi thành mẫu. Kiểu dữ liệu đầu ra Không có

Dữ liệu đầu ra Không có

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 18: Chức năng đánh dấu một máy ảo nhƣ một máy ảo mẫu

4.4.15. Nhân bản máy ảo từ một mẫu

Mô tả Nhân bản một máy ảo mới từ một mẫu có sẵn. Đây là một chức năng quan trọng của hệ thống. Bởi vì, thông thường khi cần thiết lập cơ sở hạ tầng công nghệ thông tin cho một doanh nghiệp hay bán cơ sở hạ tầng, các kỹ thuật viên sẽ thường tạo ra các mẫu máy ảo có sẵn để sử dụng theo yêu cầu. Bởi vì việc cài đặt một hệ điều hành mới và cấu hình sẽ mất rất nhiều thời gian, trong khi sử dụng hàm sao chép máy ảo sẽ chỉ tiêu tốn một vài phút.

Chức năng nhân bản máy ảo, đồng thời sẽ cho phép cấu hình lại một số thông tin cho phù hợp như thông tin bộ nhớ, số lượng CPU, thêm dung lượng ổ đĩa cứng (thường tạo mẫu máy ảo ở mức cấu hình yêu cầu tối thiểu) hay cấu hình lại các thông tin mạng như địa chỉ IP, DNS, Getway…

URI http://servername/provisioning/vm/{vmname}/clone

Kiểu dữ liệu đầu vào Tham số đường dẫn.

Xâu dữ liệu đầu vào dưới định dạng application/xml. Dữ liệu đầu vào Tham số đường dẫn:

 vmname: tên của mẫu máy ảo sẽ dùng để nhân bản.

Xâu dữ liệu đầu vào dưới định dạng application/xml:  Đối với hệ điều hành linux:

POST http://localhost:8080/provisioning/vm/VM_001/clone HTTP/1.1 Accept: application/xml Accept-Language: en-us <virtualMachine> <name>UbuntuCloned</name> <datacenter><name>VM-DC01</name></datacenter> <cluster><name>Cluster01</name></cluster> <resourcePool> <name>PEN03.078.P5HAN01</name> </resourcePool> <datastore><name>datastore2</name></datastore> <diskSize>1024</diskSize><guest> <memorySize>256</memorySize> <numCpu>1</numCpu> <guest> <domainName>han.pentalog.fr</domainName <nicSetting> <dnsServerList>1.1.1.1</dnsServerList> <dnsServerList>8.8.8.8</dnsServerList> <gateway>1.1.1.1</gateway> <gateway>8.8.8.8</gateway> <ip>192.168.11.90</ip> <subnetMask>255.255.255.0</subnetMask> <ipV6Spec>false</ipV6Spec> </nicSetting> </guest> </virtualMachine>

 Đối với hệ điều hành windows:

<productId>XXXX-XXXX-XXXX-XXXX-XXXX</productId> <orgName>HAN</orgName <passwordAdmin>Pentalog123</passwordAdmin <nicSetting> <dnsServerList>1.1.1.1</dnsServerList> <dnsServerList>8.8.8.8</dnsServerList> <gateway>1.1.1.1</gateway> <gateway>8.8.8.8</gateway> <ip>192.168.11.90</ip> <subnetMask>255.255.255.0</subnetMask> <ipV6Spec>false</ipV6Spec> </nicSetting> </guest> </virtualMachine> Kiểu dữ liệu đầu ra Application/xml

Dữ liệu đầu ra  Đối với hệ điều hành linux: HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT Location:

http://localhost:8080/provisioning/vm/VM_001/clone

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

<virtualMachine> <name>UbuntuCloned</name> <datacenter><name>VM-DC01</name></datacenter> <cluster><name>Cluster01</name></cluster> <resourcePool> <name>PEN03.078.P5HAN01</name> </resourcePool> <datastore><name>datastore2</name></datastore> <diskSize>1024</diskSize><guest> <memorySize>256</memorySize> <numCpu>1</numCpu> <guest> <domainName>han.pentalog.fr</domainName <nicSetting> <dnsServerList>1.1.1.1</dnsServerList> <dnsServerList>8.8.8.8</dnsServerList> <gateway>1.1.1.1</gateway> <gateway>8.8.8.8</gateway> <ip>192.168.11.90</ip> <subnetMask>255.255.255.0</subnetMask> <ipV6Spec>false</ipV6Spec> </nicSetting> </guest> </virtualMachine>

 Đối với hệ điều hành windows: HTTP/1.1 200 Ok

Server: Apache-Tomcat/6.0

Last-Modified: Thu, 11 Oct 2011 14:45:35 GMT Location:

http://localhost:8080/provisioning/vm/VM_001/clone

Date: Fri, 12 Oct 2011 12:00:28 GMT

Content-Type: application/xml; charset=UTF-8

<name>UbuntuCloned</name>

<datacenter><name>VM-DC01</name></datacenter> <cluster><name>Cluster01</name></cluster>

<resourcePool> <name>PEN03.078.P5HAN01</name> </resourcePool> <datastore><name>datastore2</name></datastore> <diskSize>1024</diskSize><guest> <memorySize>256</memorySize> <numCpu>1</numCpu> <guest> <computerName>ttranthingoc</computerName <ownerName>Tran Thi Ngoc Tram</ownerName>

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên mẫu máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 19: Chức năng nhân bản máy ảo từ một mẫu

4.4.16. Bật máy ảo

Mô tả Bật máy ảo.

URI http://servername/provisioning/vm/{vmname}/powerOn

Kiểu dữ liệu đầu vào Tham số đường dẫn (path param) Dữ liệu đầu vào vmname: tên của máy ảo cần bật. Kiểu dữ liệu đầu ra Không có

Dữ liệu đầu ra Không có

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 20: Chức năng bật máy ảo

4.4.17. Tắt máy ảo

Mô tả Tắt máy ảo.

URI http://servername/provisioning/vm/{vmname}/powerOff

Phương thức PUT

Kiểu dữ liệu đầu vào Tham số đường dẫn (path param) Dữ liệu đầu vào vmname: tên của máy ảo cần tắt. Kiểu dữ liệu đầu ra Không có

Dữ liệu đầu ra Không có

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 21: Chức năng tắt máy ảo

4.4.18. Khởi động lại máy ảo

URI http://servername/provisioning/vm/{vmname}/reset

Phương thức PUT

Kiểu dữ liệu đầu vào Tham số đường dẫn (path param)

Dữ liệu đầu vào vmname: tên của máy ảo cần khởi động lại. Kiểu dữ liệu đầu ra Không có

Dữ liệu đầu ra Không có

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

Bảng 22: Chức năng khởi động lại máy ảo

4.4.19. Khóa một máy ảo

Mô tả Tạm khóa một máy ảo.

URI http://servername/provisioning/vm/{vmname}/suspend

Phương thức PUT

Kiểu dữ liệu đầu vào Tham số đường dẫn (path param) Dữ liệu đầu vào vmname: tên của máy ảo cần khóa. Kiểu dữ liệu đầu ra Không có

Dữ liệu đầu ra Không có

Trạng thái dữ liệu đầu ra Mã dữ liệu trả về:

 200 Ok: nếu giao dịch thành công.

 404 Not found: nếu tên máy ảo không đúng.  500 Server error: nếu có lỗi xảy ra ở máy chủ.

4.4.20. Tắt hệ điều hành chạy trên máy ảo

Mô tả Tắt hệ điều hành chạy trên máy ảo (Guest Operating

Truy vấn danh sách các cụm

Truy vấn danh sách các máy ảo