消耗服务类型权威机构¶
OpenStack 服务类型权威机构 (https://opendev.org/openstack/service-types-authority/) 包含官方服务类型名称以及之前在没有官方列表的情况下常用的历史服务类型名称。它被提供给库和其他客户端 API 消费者,以便他们能够基于官方列表提供一致的接口,同时仍然支持现有的名称。强烈建议提供此支持,但最终是可选的。匹配过程的第一步始终是返回目录和用户请求之间的直接匹配,因此在权威机构存在之前现有的消耗模型应始终有效。
为了消耗 OpenStack 服务类型权威机构 中的信息,了解以下几点很重要
数据以 YAML 格式保存在 git 中。这是列表的最终权威源代码。
数据以 JSON 格式发布在 https://service-types.openstack.org/service-types.json,并具有 JSONSchema 在 https://service-types.openstack.org/published-schema.json。
发布的数据包含一个基于 ISO 日期时间格式 的日期版本,一个包含构建发布数据所用 git 提交的 sha,以及官方类型和别名之间的预构建正向和反向映射。
JSON 文件使用 ETag 支持提供,应被认为具有高度可缓存性。
JSON 文件的当前版本应始终是首选使用的文件。
JSON 文件类似于时区数据。不应将其视为版本化,因此发行版的稳定版本不应提供其冻结版本。发行版软件包应在发布文件的最新版本时,为所有活动版本进行更新。