表示结构约定¶

单数资源¶

TODO

集合资源的 JSON 请求和响应表示应该是一个对象，包含一个顶级属性来封装资源集合。该属性的值应该是一个 JSON 数组，其元素是集合中资源的 JSON 表示。

例如，在使用 GET /networks API 列出网络时，

JSON 响应表示的结构如下

{
  "networks": [
    {
      // Properties of network #1
    },
    {
      // Properties of network #2
    }
  ]
}

理由：将 JSON 集合资源表示定义为对象（而不是数组）允许表示可扩展。例如，可以在以后添加表示集合级别元数据的属性。

以下是一些使用此结构的其他 OpenStack API