Status API
在 Apache APISIX 中,Status API 用于:
- 检查 APISIX 是否已成功启动并正确运行
- 检查所有 workers 是否已收到配置并加载
要更改 Status API 服务器的默认端点(127.0.0.1:7085
),请更改配置文件(conf/config.yaml
)中 status
部分中的 ip
和 port
:
apisix:
status:
ip: "127.0.0.1"
port: 7085
此 API 可用于在 APISIX 开始接收用户请求之前对 APISIX 执行就绪探测。
#
GET /status返回报告 APISIX 工作人员状态的 JSON。如果 APISIX 未运行,建立 TCP 连接时请求将报错。否则,如果请求到达正在运行的 worker,此端点将始终返回 ok。
{
"status": "ok"
}
#
GET /status/ready当所有 worker 都已加载配置时,返回 ok
;否则,返回特定错误,错误代码为 503
。以下是具体示例。
当所有 worker 都已加载配置时:
{
"status": "ok"
}
当 1 个 workers 尚未初始化时:
{
"status": "error",
"error": "worker count: 16 but status report count: 15"
}
当特定 worker 尚未加载配置时:
{
"error": "worker id: 9 has not received configuration",
"status": "error"
}