使用 VMControl REST API 进行远程虚拟服务器生命周期管理（2）创建虚拟服务器

look_w

创建虚拟服务器下一步是发出 HTTP 请求，创建一个新的虚拟服务器。首先是为您的请求填充 JSON。使用上面列出的自定义参数创建一个 JSON 字符串，其中包含虚拟服务器的自定义属性的名称/值对。
使用该 JSON 字符串为下面的 URL 创建一个 HTTP POST 请求。创建虚拟服务器是一个异步操作，意味着您会收到一个响应，表示操作已经开始并需要监视操作的完成。响应将包含两个 URL。位置头文件 (header) 中的 URL 指向虚拟服务器的临时保存位置。由于虚拟服务器尚未创建，请求中选择的名称被用作 ID 的占位符。消息中的 URL 指向创建虚拟服务器 任务的作业激活记录。作业激活记录包含创建虚拟服务器 请求的状态，包括完成百分比和任何状态或错误消息。

• URL
  • https://myserver:port/ibm/director/rest/VMControl/hosts/{hostOID}/virtualServers
• HTTP 方法
  • POST
• 样例请求在惟一 ID 为 6649 的主机上创建新的虚拟服务器：
  POST https://myserver:port/ibm/director/rest/VMControl/hosts/6649/virtualServers
  清单 2. 样例响应表示

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

  {     "virtualServer":{         "properties":[{                 "name":"name",                 "value":"NEW_VS1"             },             {                 "name":"gos",                 "value":"IBM Power - AIXLINUX"             },             {                 "name":"cpumode",                 "value":"SHARED"             },             {                 "name":"cpushared",                 "value":1             },             {                 "name":"memsize",                 "value":128             },             {                 "name":"networks",                 "value":"Discovered-1014-0"             }         ]     } }

  
  
  
  清单 3. HTTP 响应：

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

  HTTP/1.1 201 OK Cache-Control: no-store Set-Cookie: JSESSIONID_ibm_console_80=00007ID-HpF24AAYtRxUDiikVk4ath=/; Secure;                                     HTTPOnly Expires: Thu, 01 Dec 1994 16:00:00 GMT Content-Type: application/octet-stream; charset=UTF-8 Content-Length: 190 Date: Mon, 14 May 2012 02:34:13 GMT Location: https://9.9.9.9:8422/ibm/director/rest/VMControl/hosts/6649                             /virtualServers/NEW_VS1 Accept-Ranges: bytes Server: Noelios-Restlet-Engine/1.1.4 Content-Language: en-US {   "MessageText": "DNZEMW066I New "Create Virtual Server" job [1] started.\nRefer     to the following URI for status: /ibm/director/rest/jobs/153/activations/1 ",   "MessageID": "DNZEMW066I" } }

  
  
  
  

监视 create virtual server 作业创建虚拟服务器的第一步是监视它的完成过程。推荐方法是通过作业激活记录来监视虚拟服务器的创建。如上所述，该 URL 以消息文本的形式返回，包含在对 POST 请求的响应中。通过对该 URL 进行轮询可监视作业激活记录，但是建议使用 Java Message Service (JMS) 提供者的方式来实现。
IBM Systems Director 服务器包含一个 JMS 提供者，用于与相关的客户机应用程序交换事件和其他重要消息。它支持在两个或更多应用程序之间进行异步通信。作业激活记录可以通过 Director.jobs.activation JMS 主题进行异步监视。
有关 JMS 的更多信息，请参见 IBM Systems Director 6.3.x SDK 信息中心的  页面。