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

look_w

开始之前了解可以从本教程中学到哪些知识，以及如何从中获得最大的益处。
关于本系列  IBM Systems Director VMControl 高级管理器简化了跨多种虚拟化技术和硬件平台来管理虚拟环境的工作。VMControl 是一种领先的多平台虚拟管理解决方案，他附带于 IBM Systems Director Editions 中。VMControl 支持三种类型的接口（GUI、CLI 和 REST API）。本系列文章将讨论通过 REST 实现的资源生命周期管理。
本系列涉及以下生命周期：

• 基于 VMControl REST API 的虚拟服务器生命周期管理：涵盖虚拟服务器的生命周期管理（创建、查看、编辑和删除）。重点介绍 VMControl 的免费版 VMControl Express Edition 的功能。
• 基于 VMControl REST API 的虚拟设备生命周期管理：涵盖虚拟设备的生命周期管理。虚拟设备是指操作系统镜像和元数据，可以通过远程方式安装（部署）到一个新的或现有的虚拟服务器上。
• 基于 VMControl REST API 实现镜像部署：将介绍一个典型的部署流程，以及通过该流程创建的工作负载的生命周期管理。
• 通过 VMControl REST API 实现的服务器系统池生命周期管理：介绍了服务器系统池的生命周期管理及其虚拟服务器重定位功能。服务器系统池就是指将类似的物理服务器/主机（VMControl 形式的云）进行分组。VMControl 选择将要部署的主机并允许在服务器系统池内重新定位虚拟服务器。

该系列将通过 REST 帮助所有 VMControl 用户理解 VMControl 功能。它还有助于理解资源生命周期的详细流程。
关于本教程本教程通过 VMControl REST API 介绍了虚拟服务器的生命周期。虚拟服务器的生命周期具有以下主要功能：

• 创建虚拟服务器
• 修改虚拟服务器（修改参数和电源管理）
• 删除虚拟服务器

在图 1 中，通过一连串不同的 REST 请求演示了虚拟服务器生命周期。
图 1. 虚拟服务器生命周期目标该教程的主要目标是使用 VMControl REST API 帮助用户理解虚拟服务器资源生命周期。本教程将结合使用 IBM System Director VMControl 介绍完整的生命周期。对虚拟服务器和 IBM Systems Director VMControl 有基本了解的用户可以轻松完成本教程学习。  
先决条件在继续本教程之前，您应当将 IBM Systems Director V6.x.x 安装到系统中。本教程假设您熟悉如何使用 IBM Systems Director，并且了解 JavaScript Object Notation (JSON) 以及如何使用偏爱的 HTTP 客户端发出 HTTP GET、POST、PUT 和 DELETE 调用。
系统需求您应当在系统中准备好以下组件。

• 已安装并配置好的 IBM Systems Director
• 已激活的 IBM Systems Director VMControl 高级管理器
• 用于运行远程请求的 HTTP 客户端

创建虚拟服务器列出可用主机，创建虚拟服务器创建虚拟服务器的第一步是检索可以在创建虚拟服务器时用到的主机的列表。主机就是指能够支持虚拟计算机的物理服务器，可能由管理程序管理。从列表中选择合适的主机，并保存对象标识符 (OID) 属性的值。接下来的请求中会使用该值。
注意：这些示例中的 URL 全部以 https://myserver:port 开头。您应当用 VMControl 所在的系统的主机名或 IP 地址替换 myserver，并用安装 IBM Systems Director 时使用的安全端口替换端口号。安全端口的默认值是 8422。

• URL
  • https://myserver:port/ibm/director/rest/VMControl/hosts
• HTTP 方法
  • GET
• 样例请求获得所有主机的列表：
  GET https://myserver:port/ibm/director/rest/VMControl/hosts
  清单 1. 样例响应表示

  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

  {     "hosts": [         {             "name": "Server-7998-61X-SN0689CEA",             "customization": {                 "uri": "/ibm/director/rest/VMControl/hosts/6649/customization"             },             "properties": {},             "uri": "/ibm/director/rest/VMControl/hosts/6649",             "oid": 6649,             "virtualServers": {                 "uri": "/ibm/director/rest/VMControl/hosts/6649/virtualServers"             }         },         {             "name": "Server-7998-61X-SN0689D0A",             "customization": {                 "uri": "/ibm/director/rest/VMControl/hosts/6838/customization"             },             "properties": {},             "uri": "/ibm/director/rest/VMControl/hosts/6838",             "oid": 6838,             "virtualServers": {                 "uri": "/ibm/director/rest/VMControl/hosts/6838/virtualServers"             }         }     ],     "uri": "/ibm/director/rest/VMControl/hosts" }

  
  
  
  

为了创建虚拟服务器而列出自定义参数自定义参数是特定于平台的独特属性，允许用户对所执行的操作进行自定义。自定义参数可以有许多类型，但是指定方式是类似的。使用从前面步骤收集的 OID 向下面指定的 URL 发出一个 GET 请求。请求结果是一个自定义参数列表，这些参数可用于创建虚拟服务器。
下面的示例显示了一个典型 Power 环境中的自定义参数。其他平台（KVM，IBM z/VM® 等）的自定义参数会有所不同。  
注意：有关自定义参数的更多信息，请参考 IBM Systems Director 6.3.x SDK Information Center 的 VMControl 编程主题。

• URL
  • https://myserver:port/ibm/director/rest/VMControl/hosts/{hostOID}/virtualServers/customization
• HTTP 方法
  • GET
• 样例请求在惟一 ID 为 6649 的主机上创建新虚拟服务器时获取虚拟化参数：
  GET https://myserver:port/ibm/director/rest/VMControl/hosts/6649/virtualServers/customization
  样例响应表示