pckg_pass_codes
`pckg_pass_codes` 指令为 Kaltura 媒体处理 APIs 配置特定的响应代码。
Kaltura Media Framework Common NGINX Module
·
httpserverlocation
语法pckg_pass_codes code1 [code2 ...];
默认值none
上下文http, server, location
参数1+
说明
Kaltura Media Framework Common NGINX Module 中的 pckg_pass_codes 指令用于指定一组 HTTP 响应代码，当 NGINX 服务器处理与 Kaltura 媒体相关的 API 请求时应将这些代码传递给客户端。这在指示各种媒体处理任务的状态并向客户端提供有意义的反馈时特别有用，尤其在多个媒体组件可能相互交互的分布式框架中。该指令接受一个或多个对应于 HTTP 状态码的整数值，从而在返回给客户端的响应中提供灵活性。
该指令可以放在 NGINX 配置的 http、server 或 location 上下文中，这意味着可以根据服务器的媒体处理配置在全局范围内对所有请求进行设置，或针对特定上下文进行本地调整。定义后，NGINX 将监视到达 Kaltura APIs 的指定路由的传入请求，并在响应机制中使用所指定的响应代码，这对依赖准确指示媒体处理结果的应用程序至关重要。
使用 pckg_pass_codes 时，需确保按照 HTTP 规范使用有效的 HTTP 状态码。不当使用或未定义的代码可能导致意外行为，例如返回无法识别的响应类型或在客户端出现错误。
配置示例
http {
server {
location /api {
pckg_pass_codes 200 404 500;
}
}
}⚠
确保指定的代码是有效的 HTTP 状态码，以避免客户端错误。
⚠
不合适的状态码可能会导致期望特定响应的客户端应用产生混淆。
⚠
代码配置应进行彻底测试，尤其是在高负载环境中，以确保响应性。