表示结构约定

单数资源

TODO

集合资源

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

例如，使用GET /networksAPI 时，

• JSON 响应表示的结构如下

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

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

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

• 批量创建网络，它使用顶级networks属性在 JSON 请求和响应表示中。
• 列出堆栈，它使用顶级stacks属性在 JSON 响应表示中。
• 列出数据库实例，它使用顶级instances属性在 JSON 响应表示中。
• 列出服务器，它使用顶级servers属性在 JSON 响应表示中。