探索用于 PowerVC 的 OpenStack REST API -1

look_w

BM Power Virtualization Center Express Edition (PowerVC) 是一个针对 IBM Power                平台的基于 OpenStack 的基础架构即服务云解决方案，旨在简化 Power Systems 环境中的虚拟资源的管理。PowerVC 同时包含                GUI 和 RESTful HTTP 服务（以 API 的形式），这些服务为您的 Power System 执行虚拟管理任务。本文将重点介绍针对                PowerVC Express 版的 REST API，并简要描述每个 API，这会让您对如何通过 Web 服务管理 Power 虚拟资源有所了解。 PowerVC 概述 PowerVC 是一个 IaaS 云解决方案，它构建于 OpenStack 项目技术之上，旨在简化 Power Systems                环境中的虚拟资源的管理。它使用了 OpenStack 的行业标准的、开源的社区接口。
PowerVC 位于控制台风格的接口工具与 IBM SmartCloud 基础架构即服务 (IaaS) 产品之间；工具包括：  

• IBM Hardware Management Console (HMC)，一个使用 BusyBox 的                    Linux® 内核，提供了一个标准界面来配置和操作分区系统（也称为 LPAR 或虚拟化系统）和 SMP 系统（比如                    Power）。
• IBM Integrated Virtualization Manager                    (IVM)，一个基于浏览器的工具，允许客户通过选择并单击来将多个虚拟工作负载整合到一个 Power System                    中，而无需 HMC 等设备来管理单个系统上的 LPAR。
• 基于内核的虚拟机 (KVM)，一个开源的虚拟机管理程序，为 Windows® 和 Linux                    工作负载的运行提供了企业级性能、可伸缩性和安全性。KVM 将 Linux                    内核转换为裸机虚拟机管理程序，后者可获得构建于处理器硬件中的硬件虚拟化支持。

PowerVC 向 Power 云资源管理带来了 OpenStack API 的特性。它旨在帮助用户动态地构建一个基础架构，以为软件定义的环境                (SDE) 或云基础架构提供支持。PowerVC 的接口支持管理 Power 硬件上的 RHEL、SLES 和 AIX®                操作系统，允许您注册可用来部署和捕获虚拟机的物理主机、存储提供程序和网络资源。PowerVC 可帮助执行的一些任务包括：

• 部署镜像来创建新虚拟机
• 调整卷并将它们附加到这些新镜像
• 捕获现有的虚拟机
• 导入现有的虚拟机和卷，以便它们可由 IBM PowerVC 管理
• 在创建的虚拟机或托管的虚拟机上发起启动/停止/重启/删除操作
• 监视您环境中的资源的利用率
• 支持在虚拟机正在运行时迁移它们（或 “热迁移”）

PowerVC 自动捕获以下管理信息：

• 现有的主机/虚拟机管理程序配置，包括 VIOS 分区信息
• Power 主机中的现有虚拟机定义的 CPU、内存和 I/O 设置
• 受支持的存储控制器中现有的卷定义
• 受支持的 SAN 交换机中现有的区域划分信息

PowerVC 支持捕获和管理一个 VM 镜像库，支持启动 VM                环境的已存储镜像来更轻松、快速地部署该环境，而无需手动重新创建一个特定的环境。通过保存和集中化虚拟镜像，您可以迁移镜像，并快速在它们之上部署应用程序。
还可以创建支持工作负载所需的资源组。
IBM PowerVC 包含在两个版本中：

• IBM PowerVC Express Edition：针对入门级环境，其中虚拟机主机是由 IVM 管理的                    Power 7、Power 7+ 和 Power 8 系统
• IBM PowerVC Standard Edition：针对企业级虚拟化环境，其中的虚拟机主机是由                    HMC 和 Power KVM 管理的 Power 6、Power 7、Power 7+ 和 Power 8 服务器

下一节将介绍 Express Edition 的 OpenStack API 和一个特定于 PowerVC 的验证器                API，以及它们的用途。尽管还有其他一些特定于由 HMC 和 KVM 工具管理的 Power Systems 的 REST                API，但本教程不会介绍它们。
OpenStack REST 和 PowerVC 验证器                API可使用下面这些 OpenStack 组件 API 和 PowerVC 验证器 API，通过 Power System 中的 PowerVC（在本例中为                PowerVC Express Edition）来进行虚拟资源管理。每个 API 按 OpenStack 组件进行分类，并包含该 API                解决的组件和子组件的定义，该 API 的用途，您用来启用该 API 的操作命令，以及每个 API 的请求和响应正文。
组件：KeystoneKeystone 是一个 OpenStack 项目，提供了 Identity、Token、Catalog 和 Policy 服务来专门供                OpenStack 家族中的项目使用。它实现了 OpenStack 的 Identity API。
。
Keystone v3：令牌 令牌是一段用于访问资源的任意文本。每个令牌有一个范围，描述了可使用它访问哪些资源。令牌可随时撤回，而且仅在有限的期限内有效。

• https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens
  用途：在提供了凭据时返回身份验证令牌和服务目录，身份验证令牌通过                    X-Subject-Token 返回标头进行返回。
  操作：POST                        
  正常响应代码：201, 200(OK)                        
  错误响应代码： identityFault (400, 500,                    …)、401、404、409、badRequest (400)、unauthorized (401)、forbidden                    (403)、badMethod (405)、overLimit (413)、serviceUnavailable                    (503)、itemNotFound (404)
• https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens                        
  用途：验证 X-Subject-Token                    标头所指定的身份验证令牌，还返回服务目录。当前的身份验证令牌必须通过 X-Auth-Token                        请求标头进行指定。
  操作：GET                    
  正常响应代码：200(OK), 203                    
  错误响应代码：identityFault (400, 500, …)、badRequest                    (400)、unauthorized (401)、forbidden (403)、badMethod (405)、overLimit                    (413)、serviceUnavailable (503)、itemNotFound (404)
• https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens
  用途：快速验证身份验证令牌。没有服务目录。返回                    204 表示令牌有效。
  操作：HEAD                        
  正常响应代码：204
  错误响应代码：identityFault                    (400, 500, …)、badRequest (400)、unauthorized (401)、forbidden                    (403)、badMethod (405)、overLimit (413)、serviceUnavailable                    (503)、itemNotFound (404)
  示例响应正文：此操作不返回响应正文。
• https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens
  用途：立即让访问令牌失效。
  操作：DELETE                        
  正常响应代码：204
  错误响应代码：identityFault                    (400, 500, …)、badRequest (400)、unauthorized (401)、forbidden                    (403)、badMethod (405)、overLimit (413)、serviceUnavailable                    (503)、itemNotFound (404)
  示例响应正文：此操作不返回响应正文。

Keystone v3：用户 您可以使用这些 API 获取 keystone 用户列表和关联的组：

• https://<powervc-ip>/powervc/openstack/identity/v3/users
  用途：获取用户列表。
  操作：GET                        
  正常响应代码：200
  错误响应代码：identityFault                    (400, 500, …)、badRequest (400)、unauthorized (401)、forbidden                    (403)、badMethod (405)、overLimit (413)、serviceUnavailable                    (503)、itemNotFound (404)
• https://<powervc-ip>/powervc/openstack/identity/v3/users/user_id
  用途：获取一个特定的用户。
  操作：GET                        
  正常响应代码：200
  错误响应代码：identityFault                    (400, 500, …)、badRequest (400)、unauthorized (401)、forbidden                    (403)、badMethod (405)、overLimit (413)、serviceUnavailable                    (503)、itemNotFound (404)
• https://<powervc-ip>/powervc/openstack/identity/v3/users/user_id/groups
  用途：列出该用户所属的组。
  操作：GET
  正常响应代码：200
  错误响应代码：identityFault                    (400, 500, …)、badRequest (400)、unauthorized (401)、forbidden                    (403)、badMethod (405)、overLimit (413)、serviceUnavailable                    (503)、itemNotFound (404)