store_s3_put_add_header
在将媒体存储到 S3 兼容对象存储时，'store_s3_put_add_header' 指令会向 PUT 请求的响应添加自定义响应头。
Kaltura Media Framework Common NGINX Module
语法store_s3_put_add_header header_name header_value;
默认值none
上下文
参数2
说明
'store_s3_put_add_header' 指令是 Kaltura Media Framework Common NGINX Module 的一部分，旨在增强对存储在 S3 兼容对象存储中的媒体文件的处理。当配置此指令时，它会指定在 PUT 请求的响应头中包含的自定义头字段。这对需要在上传完成后向客户端传达额外元数据或处理信息的应用尤为有用。\n\n该指令需要两个参数：第一个是要添加的头名称，第二个是应赋予该头的值。它为开发人员提供了定义特定应用级头的灵活性，这些头可能对 PUT 操作后的客户端处理至关重要。例如，头部可用于指示成功存储的条件、响应缓存策略或面向 API 使用者的任何相关状态消息。\n\n该指令的行为受到底层存储 API 配置的影响，尤其是请求处理是否包含对要设置的头进行验证或转换。在媒体流等高性能 Web 应用的上下文中，这些自定义头在 API 交互中起着重要作用，能确保客户端从服务器获得即时且有用的反馈。
配置示例
# Example configuration in nginx.conf
location /upload {
store_s3_put_add_header X-File-Id my_custom_id;
store_s3_put_add_header X-Processing-Time 5s;
}⚠
确保头部名称有效并符合 HTTP 头部标准。
⚠
未配置为检索自定义头部的客户端可能会忽略这些头部，导致对响应的潜在误解。
⚠
在将敏感信息添加到头部时，请注意安全方面的影响。