Current Networking API 2.0 documentation bugs against folsom-rc1

[Itsuro Oda]

The followings is aganinst commit 32a9c66 of netconn-api documantaion and folsom-rc1.

* Table 2.2. Subnet Attributes
 - since ip_version is 'required' default value should be N/A.
 - gateway_ip is allowed to specify null.
 - dns_nameservers' default value is empty list actually.
 - name attribute missing
 - enable_dhcp attribute missing

* Table 2.3. Port Attributes
 - name attribute missing

* 4.1.5 Delete Network
 - 400 is not returned since there is no request body
 - 403 is not returned actually. (please let me know how to generate if it is returned.)

* 4.2.3 Create Subnet
 - 409 may be returned. in the case of the specified gateway_id is included in the specified allocation_pools.

* 4.2.5 Delete Subnet
 - 400 is not returned since there is no request body
 - 403 is not returned actually. (please let me know how to generate if it is returned.)

* 4.3.3 Create Port
 - 503 may be returned. in the case of mac address generation fail.

* 4.3.5 Delete Port
 - 403 is not returned actually. (please let me know how to generate if it is returned.)

[dan wendlandt (danwent)]

Thanks for the comments! Salvatore owns this doc and can probably best respond.

[Itsuro Oda (oda-g)]

If it is not too late I'd like to add the followings:
* tenant_id attribute of the Table 2.1 Network Attributes
* tenant_id attribute of the Table 2.2. Subnet Attributes
* tenant_id attribute of the Table 2.3 Port Attributes
  They are not UUID_PATTERN. validation check is not done actually.

[Salvatore Orlando (salvatore-orlando)]

Its not too late. I will add them to the patch under review: https://review.openstack.org/#/c/13299/

[Salvatore Orlando (salvatore-orlando)]

The patch on gerrit has been update with Itsuro's comment.