[Engine-devel] Fwd: Problem in REST API handling/displaying of logical networks

[Itamar Heim]

On 07/03/2012 09:51 AM, Avi Tal wrote:
...
>
> Why do we keep holding this Top level collection instead of having each network related under his datacenter (/api/datacenter/id/networks)???

why do we keep VMs as top level? they only exist in data center...
why do we keep Clusters as top level? they only exist in data center...
why do we keep Templates as top level? they only exist in data center...

all entities are available today as top level as well, so networks are 
there for consistency

>
> https://bugzilla.redhat.com/show_bug.cgi?id=741111
>
> One solution which is must is to move the top level network (/api/networks) under each Datacenter!
>
> 1. having top level networks path isn't symmetric to our entire REST API implementation!
>     all other network collections (cluster, hosts, VMs, Templates) placed under their related component.
> 2. as a REST API user, having sub collection networks under each datacenter is better to handle than parsing a top level collection
>     and comparing DC id in order to get all DC related networks.
> 3. as for breaking api/ backward compatibility, we can still hold the top level network collection ad deprecated and start exposing the sub collections
>     under each datacenter.