hostha API使用手册：配置节点信息与查询疏散记录完整教程-平芜编程栈

hostha API使用手册：配置节点信息与查询疏散记录完整教程

【免费下载链接】hosthaCompute High Availability for OpenStack项目地址: https://gitcode.com/openeuler/hostha

前往项目官网免费下载：https://ar.openeuler.org/ar/

hostha是openEuler社区提供的OpenStack主机高可用解决方案，通过监控存储网、数据网和管理网的异常状态，实现节点故障时的自动隔离与虚拟机疏散。本文将详细介绍如何通过hostha API完成节点信息配置与疏散记录查询，帮助管理员快速掌握系统运维的核心操作。

系统架构概览

hostha采用分布式架构设计，通过consul实现集群节点监控，结合决策矩阵分析异常并执行故障处理。核心组件包括：

监控层：通过consul集群收集节点状态数据
决策层：基于异常数据执行故障判断与处理决策
执行层：调用OpenStack API完成虚拟机疏散操作
API服务：提供配置管理与状态查询接口

图：hostha系统架构示意图，展示了监控数据流向与故障处理流程

快速开始：API调用准备

环境要求

OpenStack环境（Mitaka及以上版本）
hostha服务已部署（参考INSTALL.md）
管理员权限的OpenStack认证令牌（Token）

基础调用格式

所有API请求需包含认证头信息：

-H "Content-Type: application/json" -H "X-Auth-Token: $TOKEN"

其中$TOKEN需替换为实际的OpenStack认证令牌。

核心API详解

1. 配置节点信息

查询当前配置

请求方式：

GET /v1.0/configuration

示例请求：

curl -g -i -X GET http://controller:12306/v1.0/configuration \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "X-Auth-Token: $TOKEN"

成功响应（状态码200）：

{ "configurations": [ {"group": "host_ha", "name": "check_interval", "value": "5", "id": 1}, {"group": "host_ha", "name": "check_retry", "value": "3", "id": 4} ] }

配置项说明：

id	group	name	说明
1	host_ha	check_interval	物理机HA检查间隔(秒)
2	host_ha	check_retry	检查重试次数

更新配置参数

请求方式：

PATCH /v1.0/configuration

示例请求：

curl -g -i -X PATCH http://controller:12306/v1.0/configuration \ -H "Content-Type: application/json" \ -H "X-Auth-Token: $TOKEN" \ -d '{"group": "host_ha","name": "check_interval","value": "10"}'

成功响应：状态码202（无返回数据）

注意事项：

仅支持更新已有配置项
修改后需重启hostha服务使配置生效
配置参数详细说明可参考docs/api/configuration/action/configuration_update.md

2. 查询疏散记录

获取主机疏散历史

请求方式：

GET /v1.0/host_evacuation

示例请求：

curl -g -i -X GET http://node01:12307/v1.0/host_evacuation \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "X-Auth-Token: $TOKEN"

成功响应（状态码200）：

{ "records": [ { "started_at": "2021-12-29T02:39:31", "finished_at": "2021-12-29T02:39:51", "hostname": "node03", "id": 1 } ] }

返回字段说明：

started_at：疏散开始时间
finished_at：疏散完成时间
hostname：故障节点名称
id：疏散记录ID

3. 常见错误处理

状态码	错误类型	可能原因	解决方法
401	权限不足	Token无效或过期	重新获取认证令牌
404	资源未找到	API路径错误或服务未启动	检查服务状态和请求URL
503	服务不可用	hostha服务未运行	重启hostha-api服务

实用操作示例

场景1：调整节点检查频率

当集群规模较大时，可适当增加检查间隔减少网络负载：

# 将检查间隔调整为15秒 curl -g -i -X PATCH http://controller:12306/v1.0/configuration \ -H "Content-Type: application/json" \ -H "X-Auth-Token: $TOKEN" \ -d '{"group": "host_ha","name": "check_interval","value": "15"}'

场景2：查询最近疏散记录

# 获取最近的主机疏散记录 curl -g -i -X GET http://node01:12307/v1.0/host_evacuation \ -H "Content-Type: application/json" \ -H "X-Auth-Token: $TOKEN" | jq '.records[0]'