38、云计算 REST API 的词汇与语义分析

云计算 REST API 的词汇与语义分析

1. 云 API 词汇规则与现状

在云计算的 REST API 中，存在一些词汇使用的良好实践：
1. URI 路径中应优先使用小写字母。
2. 文档名称应使用单数名词。
3. 集合名称应使用复数名词。
4. 控制器名称应使用动词或动词短语。
5. 不应使用下划线。

研究结果表明，大多数 API 遵循了这五条良好实践。分析的云计算 REST API 的词汇主要包含名词，单数和复数数量相当，且主要为小写，符合 REST API 的最佳实践。

对于云服务提供商采用的词汇，研究对 16 个 REST 云 API 进行了统计。结果显示，尽管这些 API 描述的是同一领域，但它们共享的通用术语并不多。具体而言，90%（3,561/3,947）的术语仅被一个提供商使用，5%（198/3,947）的术语被两个提供商采用，5%（198/3,947）的术语被三个或更多提供商采用，且没有一个术语能在所有 16 个 API 中达成共识。不过，有 23 个术语被七个或更多提供商使用，如下表所示：
|术语|使用提供商数量|
| ---- | ---- |
|images|11|
|events|10|
|users|9|
|services|9|
|stop|9|
|resources|8|
|logs|8|
|roles|8|
|snapshots|8|
|restore|8|
|actions|8|
|restart|8|
|instances|7|