知识卡片

普通读书笔记卡 · 2464.a

微版本API

理解等级:未标注

Nova v2.1用Microversion演进API:版本号X.Y单调递增,除Bug修复外,请求、返回或语义的任何变化都要递增Y。客户端在请求头声明版本,不带则按最小版本处理,超出支持范围返回406。latest只适合测试,生产要固定已验证的版本,否则升级后可能不兼容。外部契约不能频繁破坏时,微版本比另起大版本更适合持续交付。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《OpenStack设计与实现(第3版)》第5章《计算》(源文件:_epub-src/OEBPS/Text/1-011.xhtml) - 结论依据:原文说明微版本单调递增、缺省请求最小版本、越界返回406,并明确latest仅便于测试、生产应指定版本;Nova官方文档亦警告客户端不要依赖latest。 - 原始内容:Microversion是单调递增的,表现为X.Y的形式。……如果没有发送此HTTP头,则代表请求的是最小版本。如果请求的版本号未在最小版本号到最大版本号范围内,则系统会返回“HTTP Not Acceptable 406”。……这个关键字代表请求最新的版本,这是一个用来方便测试的关键字,在实际生产中,需要指定请求所对应的版本号,否则在系统升级后,最新的API很可能已经不兼容。