complete api ref for std attr revisions

This patch completes the api ref for standard attribute based revision numbers by: - Updating applicable resource JSON responses to include revision_number. - Documents the revision_number response param where missing. - Adds a section in the intro about revisions as well as conditional HTTP based operations using If-Match header. - Standardizes the revision_number response param; doesn't seem necessary for each resource to have it's own. Change-Id: Ib9a19126c35f89bc9c2ad891a7339702a406e2d5 Partial-Bug: #1703234
2017-08-30 16:05:38 -06:00
parent b749812037
commit 41212a5311
60 changed files with 129 additions and 24 deletions
--- a/api-ref/source/v2/floatingips.inc
+++ b/api-ref/source/v2/floatingips.inc
@@ -65,6 +65,7 @@ Response Parameters
   - fixed_ip_address: floatingip-fixed_ip_address
   - floating_ip_address: floating_ip_address
   - port_id: floatingip-port_id
+   - revision_number: revision_number

 Response Example
 ----------------
--- a/api-ref/source/v2/intro.inc
+++ b/api-ref/source/v2/intro.inc
@@ -443,3 +443,19 @@ following errors:

 -  403 Forbidden - If the user cannot access a specific resource or perform the
   requested operation.
+
+
+Revisions
+=========
+
+The ``Resource revision numbers`` extension (``standard-attr-revisions``) adds
+the ``revision_number`` attribute to all API resources that support standard
+attributes. This includes networks, ports, subnets, subnet pools, floating IPs,
+routers, logs, security groups/rules, network segments, QoS policies and trunks.
+As you'd expect, the ``revision_number`` indicates the number of updates a
+particular resource has undergone and is read-only.
+
+In addition, the ``If-Match constraints based on revision_number`` extension
+(``revision-if-match``) allows API consumers to leverage the ``If-Match`` HTTP
+header to conditionally update/delete a resource when the HTTP ``If-Match``
+header matches the ``revision_number`` of the said resource.
--- a/api-ref/source/v2/logging.inc
+++ b/api-ref/source/v2/logging.inc
@@ -45,6 +45,7 @@ Response Parameters
   - tenant_id: project_id
   - project_id: project_id
   - event: log_event
+   - revision_number: revision_number
   - resource_type: resource_log_type
   - resource_id: resource_log_id
   - target_id: resource_target_log_id
@@ -112,6 +113,7 @@ Response Parameters
   - tenant_id: project_id
   - project_id: project_id
   - event: log_event
+   - revision_number: revision_number
   - resource_type: resource_log_type
   - resource_id: resource_log_id
   - target_id: resource_target_log_id
@@ -153,6 +155,7 @@ Response Parameters
   - tenant_id: project_id
   - project_id: project_id
   - event: log_event
+   - revision_number: revision_number
   - resource_type: resource_log_type
   - resource_id: resource_log_id
   - target_id: resource_target_log_id
@@ -204,6 +207,7 @@ Response Parameters
   - tenant_id: project_id
   - project_id: project_id
   - event: log_event
+   - revision_number: revision_number
   - resource_type: resource_log_type
   - resource_id: resource_log_id
   - target_id: resource_target_log_id
--- a/api-ref/source/v2/networks.inc
+++ b/api-ref/source/v2/networks.inc
@@ -110,6 +110,7 @@ Response Parameters
   - provider:physical_network: provider:physical_network
   - provider:segmentation_id: provider:segmentation_id
   - qos_policy_id: qos_policy_id
+   - revision_number: revision_number
   - router:external: router:external
   - segments: segments
   - shared: network-shared
@@ -206,6 +207,7 @@ Response Parameters
   - provider:physical_network: provider:physical_network
   - provider:segmentation_id: provider:segmentation_id
   - qos_policy_id: qos_policy_id
+   - revision_number: revision_number
   - router:external: router:external
   - segments: segments
   - shared: network-shared
@@ -303,6 +305,7 @@ Response Parameters
   - provider:physical_network: provider:physical_network
   - provider:segmentation_id: provider:segmentation_id
   - qos_policy_id: qos_policy_id
+   - revision_number: revision_number
   - router:external: router:external
   - segments: segments
   - shared: network-shared
@@ -403,6 +406,7 @@ Response Parameters
   - provider:physical_network: provider:physical_network
   - provider:segmentation_id: provider:segmentation_id
   - qos_policy_id: qos_policy_id
+   - revision_number: revision_number
   - router:external: router:external
   - segments: segments
   - shared: network-shared
@@ -493,6 +497,7 @@ Response Parameters
   - provider:physical_network: provider:physical_network
   - provider:segmentation_id: provider:segmentation_id
   - qos_policy_id: qos_policy_id
+   - revision_number: revision_number
   - router:external: router:external
   - segments: segments
   - shared: network-shared
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -5500,12 +5500,6 @@ subnet-obj:
  in: body
  required: true
  type: string
-subnet-revision_number:
-  description: |
-    The revision number of the subnet.
-  in: body
-  required: true
-  type: string
 subnet-segment_id:
  description: |
    The ID of a network segment the subnet is associated with.
@@ -5584,12 +5578,6 @@ subnetpool_is_default:
  in: body
  required: true
  type: boolean
-subnetpool_revision_number:
-  description: |
-    The revision number of the subnetpool.
-  in: body
-  required: true
-  type: string
 subnetpool_updated_at:
  description: |
    Time at which subnetpool has been updated.
--- a/api-ref/source/v2/ports.inc
+++ b/api-ref/source/v2/ports.inc
@@ -101,6 +101,7 @@ Response Parameters
   - network_id: network_id
   - port_security_enabled: port_security_enabled
   - project_id: project_id
+   - revision_number: revision_number
   - security_groups: port-security_groups
   - status: port-status
   - tenant_id: project_id
@@ -216,6 +217,7 @@ Response Parameters
   - network_id: network_id
   - port_security_enabled: port_security_enabled
   - project_id: project_id
+   - revision_number: revision_number
   - security_groups: port-security_groups
   - status: port-status
   - tenant_id: project_id
@@ -316,6 +318,7 @@ Response Parameters
   - network_id: network_id
   - port_security_enabled: port_security_enabled
   - project_id: project_id
+   - revision_number: revision_number
   - security_groups: port-security_groups
   - status: port-status
   - tenant_id: project_id
@@ -414,6 +417,7 @@ Response Parameters
   - network_id: network_id
   - port_security_enabled: port_security_enabled
   - project_id: project_id
+   - revision_number: revision_number
   - security_groups: port-security_groups
   - status: port-status
   - tenant_id: project_id
@@ -505,6 +509,7 @@ Response Parameters
   - network_id: network_id
   - port_security_enabled: port_security_enabled
   - project_id: project_id
+   - revision_number: revision_number
   - security_groups: port-security_groups
   - status: port-status
   - tenant_id: project_id
--- a/api-ref/source/v2/qos.inc
+++ b/api-ref/source/v2/qos.inc
@@ -113,6 +113,7 @@ Response Parameters
   - description: description
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - shared: qos-shared
   - id: qos_policy_id
   - rules: qos-rules
@@ -173,6 +174,7 @@ Response Parameters
   - description: description
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - shared: qos-shared
   - rules: qos-rules
   - id: qos_policy_id
@@ -211,6 +213,7 @@ Response Parameters
   - description: description
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - shared: qos-shared
   - rules: qos-rules
   - id: qos_policy_id
@@ -262,6 +265,7 @@ Response Parameters
   - description: description
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - shared: qos-shared
   - id: qos_policy_id
   - rules: qos-rules
--- a/api-ref/source/v2/routers.inc
+++ b/api-ref/source/v2/routers.inc
@@ -55,6 +55,7 @@ Response Parameters
   - network_id: router-network_id
   - enable_snat: router-enable_snat
   - external_fixed_ips: router-external_fixed_ips
+   - revision_number: revision_number
   - routes: router-routes
   - destination: router-destination
   - nexthop: router-nexthop
@@ -132,6 +133,7 @@ Response Parameters
   - network_id: router-network_id
   - enable_snat: router-enable_snat
   - external_fixed_ips: router-external_fixed_ips
+   - revision_number: revision_number
   - routes: router-routes
   - destination: router-destination
   - nexthop: router-nexthop
@@ -188,6 +190,7 @@ Response Parameters
   - network_id: router-network_id
   - enable_snat: router-enable_snat
   - external_fixed_ips: router-external_fixed_ips
+   - revision_number: revision_number
   - routes: router-routes
   - destination: router-destination
   - nexthop: router-nexthop
@@ -254,6 +257,7 @@ Response Parameters
   - network_id: router-network_id
   - enable_snat: router-enable_snat
   - external_fixed_ips: router-external_fixed_ips
+   - revision_number: revision_number
   - routes: router-routes
   - destination: router-destination
   - nexthop: router-nexthop
--- a/api-ref/source/v2/samples/floatingips/floating-ips-list-response.json
+++ b/api-ref/source/v2/samples/floatingips/floating-ips-list-response.json
@@ -15,6 +15,7 @@
            "floating_ip_address": "172.24.4.228",
            "port_id": "ce705c24-c1ef-408a-bda3-7bbd946164ab",
            "id": "2f245a7b-796b-4f26-9cf9-9e82d248fda7",
+            "revision_number": 1,
            "status": "ACTIVE"
        },
        {
@@ -32,6 +33,7 @@
            "floating_ip_address": "172.24.4.227",
            "port_id": null,
            "id": "61cea855-49cb-4846-997d-801b70c71bdd",
+            "revision_number": 1,
            "status": "DOWN"
        }
    ]
--- a/api-ref/source/v2/samples/logs/log-create-response.json
+++ b/api-ref/source/v2/samples/logs/log-create-response.json
@@ -8,6 +8,7 @@
        "enabled": true,
        "resource_type": "security_group",
        "resource_id": null,
+        "revision_number": 1,
        "target_id": null,
        "event": "ALL"
    }
--- a/api-ref/source/v2/samples/logs/log-list-response.json
+++ b/api-ref/source/v2/samples/logs/log-list-response.json
@@ -7,6 +7,7 @@
            "project_id": "92a5a4f4245a4abbafacb7ca73b027b0",
            "tenant_id": "92a5a4f4245a4abbafacb7ca73b027b0",
            "enabled": true,
+            "revision_number": 1,
            "resource_type": "security_group",
            "resource_id": null,
            "target_id": null,
--- a/api-ref/source/v2/samples/logs/log-show-response.json
+++ b/api-ref/source/v2/samples/logs/log-show-response.json
@@ -6,6 +6,7 @@
        "project_id": "8d4c70a21fed4aeba121a1a429ba0d04",
        "tenant_id": "8d4c70a21fed4aeba121a1a429ba0d04",
        "enabled": true,
+        "revision_number": 1,
        "resource_type": "security_group",
        "resource_id": null,
        "target_id": null,
--- a/api-ref/source/v2/samples/logs/log-update-response.json
+++ b/api-ref/source/v2/samples/logs/log-update-response.json
@@ -6,6 +6,7 @@
        "project_id": "8d4c70a21fed4aeba121a1a429ba0d04",
        "tenant_id": "8d4c70a21fed4aeba121a1a429ba0d04",
        "enabled": false,
+        "revision_number": 3,
        "resource_type": "security_group",
        "resource_id": null,
        "target_id": null,
--- a/api-ref/source/v2/samples/networks/network-create-response.json
+++ b/api-ref/source/v2/samples/networks/network-create-response.json
@@ -13,6 +13,7 @@
        "port_security_enabled": true,
        "project_id": "9bacb3c5d39d41a79512987f338cf177",
        "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+        "revision_number": 1,
        "router:external": false,
        "shared": false,
        "status": "ACTIVE",
--- a/api-ref/source/v2/samples/networks/network-multi-create-response.json
+++ b/api-ref/source/v2/samples/networks/network-multi-create-response.json
@@ -8,6 +8,7 @@
        "project_id": "9bacb3c5d39d41a79512987f338cf177",
        "tenant_id": "9bacb3c5d39d41a79512987f338cf177",
        "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+        "revision_number": 1,
        "segments": [
            {
                "provider:segmentation_id": 2,
--- a/api-ref/source/v2/samples/networks/network-multi-show-response.json
+++ b/api-ref/source/v2/samples/networks/network-multi-show-response.json
@@ -13,6 +13,7 @@
        "port_security_enabled": true,
        "project_id": "9bacb3c5d39d41a79512987f338cf177",
        "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+        "revision_number": 1,
        "router:external": false,
        "segments": [
            {
--- a/api-ref/source/v2/samples/networks/network-provider-create-response.json
+++ b/api-ref/source/v2/samples/networks/network-provider-create-response.json
@@ -10,6 +10,7 @@
        "project_id": "9bacb3c5d39d41a79512987f338cf177",
        "tenant_id": "9bacb3c5d39d41a79512987f338cf177",
        "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+        "revision_number": 1,
        "router:external": false,
        "provider:network_type": "vlan",
        "mtu": 1500,
--- a/api-ref/source/v2/samples/networks/network-provider-show-response.json
+++ b/api-ref/source/v2/samples/networks/network-provider-show-response.json
@@ -16,6 +16,7 @@
        "provider:physical_network": null,
        "provider:segmentation_id": null,
        "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+        "revision_number": 1,
        "router:external": false,
        "shared": true,
        "status": "ACTIVE",
--- a/api-ref/source/v2/samples/networks/network-show-response.json
+++ b/api-ref/source/v2/samples/networks/network-show-response.json
@@ -13,6 +13,7 @@
        "port_security_enabled": true,
        "project_id": "4fd44f30292945e481c7b8a0c8908869",
        "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+        "revision_number": 1,
        "router:external": false,
        "shared": true,
        "status": "ACTIVE",
--- a/api-ref/source/v2/samples/networks/network-update-response.json
+++ b/api-ref/source/v2/samples/networks/network-update-response.json
@@ -13,6 +13,7 @@
        "port_security_enabled": true,
        "project_id": "4fd44f30292945e481c7b8a0c8908869",
        "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+        "revision_number": 2,
        "router:external": false,
        "shared": false,
        "status": "ACTIVE",
--- a/api-ref/source/v2/samples/networks/networks-bulk-create-response.json
+++ b/api-ref/source/v2/samples/networks/networks-bulk-create-response.json
@@ -13,6 +13,7 @@
            "name": "sample_network3",
            "project_id": "4fd44f30292945e481c7b8a0c8908869",
            "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+            "revision_number": 1,
            "router:external": false,
            "shared": false,
            "status": "ACTIVE",
@@ -35,6 +36,7 @@
            "name": "sample_network4",
            "project_id": "4fd44f30292945e481c7b8a0c8908869",
            "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+            "revision_number": 1,
            "router:external": false,
            "shared": false,
            "status": "ACTIVE",
--- a/api-ref/source/v2/samples/networks/networks-list-response.json
+++ b/api-ref/source/v2/samples/networks/networks-list-response.json
@@ -14,6 +14,7 @@
            "port_security_enabled": true,
            "project_id": "4fd44f30292945e481c7b8a0c8908869",
            "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
+            "revision_number": 1,
            "router:external": false,
            "shared": false,
            "status": "ACTIVE",
@@ -38,6 +39,7 @@
            "port_security_enabled": true,
            "project_id": "26a7980765d0414dbc1fc1f88cdb7e6e",
            "qos_policy_id": "bfdb6c39f71e4d44b1dfbda245c50819",
+            "revision_number": 3,
            "router:external": false,
            "shared": false,
            "status": "ACTIVE",
--- a/api-ref/source/v2/samples/networks/networks-provider-list-response.json
+++ b/api-ref/source/v2/samples/networks/networks-provider-list-response.json
@@ -16,6 +16,7 @@
            "provider:network_type": "vlan",
            "provider:physical_network": "public",
            "provider:segmentation_id": 3,
+            "revision_number": 1,
            "router:external": false,
            "shared": false,
            "status": "ACTIVE",
@@ -43,6 +44,7 @@
            "provider:physical_network": null,
            "provider:segmentation_id": null,
            "qos_policy_id": "bfdb6c39f71e4d44b1dfbda245c50819",
+            "revision_number": 2,
            "router:external": false,
            "segments": [
                {
--- a/api-ref/source/v2/samples/ports/port-bind-create-response.json
+++ b/api-ref/source/v2/samples/ports/port-bind-create-response.json
@@ -37,6 +37,7 @@
        "name": "private-port",
        "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
        "project_id": "d6700c0c9ffa4f1cb322cd4a1f3906fa",
+        "revision_number": 1,
        "security_groups": [
            "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
        ],
--- a/api-ref/source/v2/samples/ports/port-bind-show-response.json
+++ b/api-ref/source/v2/samples/ports/port-bind-show-response.json
@@ -35,6 +35,7 @@
        "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
        "port_security_enabled": false,
        "project_id": "7e02058126cc4950b75f9970368ba177",
+        "revision_number": 1,
        "security_groups": [],
        "status": "ACTIVE",
        "tenant_id": "7e02058126cc4950b75f9970368ba177",
--- a/api-ref/source/v2/samples/ports/port-bind-update-response.json
+++ b/api-ref/source/v2/samples/ports/port-bind-update-response.json
@@ -30,6 +30,7 @@
        "name": "test-for-port-update",
        "network_id": "883fc383-5ea1-4c8b-8916-e1ddb0a9f365",
        "project_id": "522eda8d23124b25bf03fe44f1986b74",
+        "revision_number": 2,
        "security_groups": [
            "ce0179d6-8a94-4f7c-91c2-f3038e2acbd0"
        ],
--- a/api-ref/source/v2/samples/ports/port-create-response.json
+++ b/api-ref/source/v2/samples/ports/port-create-response.json
@@ -27,6 +27,7 @@
        "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
        "port_security_enabled": true,
        "project_id": "d6700c0c9ffa4f1cb322cd4a1f3906fa",
+        "revision_number": 1,
        "security_groups": [
            "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
        ],
--- a/api-ref/source/v2/samples/ports/port-show-response.json
+++ b/api-ref/source/v2/samples/ports/port-show-response.json
@@ -27,6 +27,7 @@
        "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
        "port_security_enabled": false,
        "project_id": "7e02058126cc4950b75f9970368ba177",
+        "revision_number": 1,
        "security_groups": [],
        "status": "ACTIVE",
        "tenant_id": "7e02058126cc4950b75f9970368ba177",
--- a/api-ref/source/v2/samples/ports/port-update-response.json
+++ b/api-ref/source/v2/samples/ports/port-update-response.json
@@ -30,6 +30,7 @@
        "name": "test-for-port-update",
        "network_id": "883fc383-5ea1-4c8b-8916-e1ddb0a9f365",
        "project_id": "522eda8d23124b25bf03fe44f1986b74",
+        "revision_number": 1,
        "security_groups": [
            "ce0179d6-8a94-4f7c-91c2-f3038e2acbd0"
        ],
--- a/api-ref/source/v2/samples/ports/ports-bind-list-response.json
+++ b/api-ref/source/v2/samples/ports/ports-bind-list-response.json
@@ -35,6 +35,7 @@
            "network_id": "70c1db1f-b701-45bd-96e0-a313ee3430b3",
            "port_security_enabled": true,
            "project_id": "",
+            "revision_number": 1,
            "security_groups": [],
            "status": "ACTIVE",
            "tenant_id": ""
@@ -74,6 +75,7 @@
            "network_id": "f27aa545-cbdd-4907-b0c6-c9e8b039dcc2",
            "port_security_enabled": true,
            "project_id": "d397de8a63f341818f198abb0966f6f3",
+            "revision_number": 2,
            "security_groups": [],
            "status": "ACTIVE",
            "tenant_id": "d397de8a63f341818f198abb0966f6f3"
--- a/api-ref/source/v2/samples/ports/ports-bulk-create-response.json
+++ b/api-ref/source/v2/samples/ports/ports-bulk-create-response.json
@@ -20,6 +20,7 @@
            "name": "sample_port_1",
            "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
            "project_id": "d6700c0c9ffa4f1cb322cd4a1f3906fa",
+            "revision_number": 1,
            "security_groups": [
                "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
            ],
@@ -47,6 +48,7 @@
            "name": "sample_port_2",
            "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
            "project_id": "d6700c0c9ffa4f1cb322cd4a1f3906fa",
+            "revision_number": 1,
            "security_groups": [
                "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
            ],
--- a/api-ref/source/v2/samples/ports/ports-list-response.json
+++ b/api-ref/source/v2/samples/ports/ports-list-response.json
@@ -26,6 +26,7 @@
            "name": "",
            "network_id": "70c1db1f-b701-45bd-96e0-a313ee3430b3",
            "project_id": "",
+            "revision_number": 1,
            "security_groups": [],
            "status": "ACTIVE",
            "tenant_id": ""
@@ -56,6 +57,7 @@
            "name": "",
            "network_id": "f27aa545-cbdd-4907-b0c6-c9e8b039dcc2",
            "project_id": "d397de8a63f341818f198abb0966f6f3",
+            "revision_number": 1,
            "security_groups": [],
            "status": "ACTIVE",
            "tenant_id": "d397de8a63f341818f198abb0966f6f3"
--- a/api-ref/source/v2/samples/qos/policies-list-response.json
+++ b/api-ref/source/v2/samples/qos/policies-list-response.json
@@ -6,6 +6,7 @@
            "id": "46ebaec0-0570-43ac-82f6-60d2b03168c4",
            "name": "10Mbit",
            "description": "This policy limits the ports to 10Mbit max.",
+            "revision_number": 3,
            "shared": false,
            "rules": [
                {
--- a/api-ref/source/v2/samples/qos/policy-create-response.json
+++ b/api-ref/source/v2/samples/qos/policy-create-response.json
@@ -5,6 +5,7 @@
        "rules": [],
        "id": "46ebaec0-0570-43ac-82f6-60d2b03168c4",
        "project_id": "8d4c70a21fed4aeba121a1a429ba0d04",
+        "revision_number": 1,
        "tenant_id": "8d4c70a21fed4aeba121a1a429ba0d04",
        "shared": false
    }
--- a/api-ref/source/v2/samples/qos/policy-show-response.json
+++ b/api-ref/source/v2/samples/qos/policy-show-response.json
@@ -5,6 +5,7 @@
        "id": "46ebaec0-0570-43ac-82f6-60d2b03168c4",
        "name": "10Mbit",
        "description": "This policy limits the ports to 10Mbit max.",
+        "revision_number": 3,
        "shared": false,
        "rules": [
            {
--- a/api-ref/source/v2/samples/qos/policy-update-response.json
+++ b/api-ref/source/v2/samples/qos/policy-update-response.json
@@ -4,6 +4,7 @@
        "description": "This policy limits the ports to 10Mbit max.",
        "id": "46ebaec0-0570-43ac-82f6-60d2b03168c4",
        "project_id": "8d4c70a21fed4aeba121a1a429ba0d04",
+        "revision_number": 3,
        "tenant_id": "8d4c70a21fed4aeba121a1a429ba0d04",
        "shared": false
    }
--- a/api-ref/source/v2/samples/routers/router-create-response.json
+++ b/api-ref/source/v2/samples/routers/router-create-response.json
@@ -21,6 +21,7 @@
        "id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
        "name": "router1",
        "routes": [],
+        "revision_number": 1,
        "status": "ACTIVE",
        "project_id": "0bd18306d801447bb457a46252d82d13",
        "tenant_id": "0bd18306d801447bb457a46252d82d13"
--- a/api-ref/source/v2/samples/routers/router-show-response.json
+++ b/api-ref/source/v2/samples/routers/router-show-response.json
@@ -24,6 +24,7 @@
        "ha": false,
        "id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
        "name": "router1",
+        "revision_number": 1,
        "routes": [],
        "status": "ACTIVE",
        "project_id": "0bd18306d801447bb457a46252d82d13",
--- a/api-ref/source/v2/samples/routers/router-update-response.json
+++ b/api-ref/source/v2/samples/routers/router-update-response.json
@@ -20,6 +20,7 @@
        "ha": false,
        "id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
        "name": "router1",
+        "revision_number": 3,
        "routes": [],
        "status": "ACTIVE",
        "project_id": "0bd18306d801447bb457a46252d82d13",
--- a/api-ref/source/v2/samples/routers/routers-list-response.json
+++ b/api-ref/source/v2/samples/routers/routers-list-response.json
@@ -25,6 +25,7 @@
            "ha": false,
            "id": "915a14a6-867b-4af7-83d1-70efceb146f9",
            "name": "router2",
+            "revision_number": 1,
            "routes": [],
            "status": "ACTIVE",
            "project_id": "0bd18306d801447bb457a46252d82d13",
@@ -55,6 +56,7 @@
            "ha": false,
            "id": "f8a44de0-fc8e-45df-93c7-f79bf3b01c95",
            "name": "router1",
+            "revision_number": 1,
            "routes": [],
            "status": "ACTIVE",
            "project_id": "0bd18306d801447bb457a46252d82d13",
--- a/api-ref/source/v2/samples/security-groups/security-group-create-response.json
+++ b/api-ref/source/v2/samples/security-groups/security-group-create-response.json
@@ -15,6 +15,7 @@
                "remote_ip_prefix": null,
                "security_group_id": "2076db17-a522-4506-91de-c6dd8e837028",
                "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                "revision_number": 1,
                "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                "description": ""
            },
@@ -29,11 +30,13 @@
                "remote_ip_prefix": null,
                "security_group_id": "2076db17-a522-4506-91de-c6dd8e837028",
                "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                "revision_number": 1,
                "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                "description": ""
            }
        ],
        "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+        "revision_number": 1,
        "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
    }
 }
--- a/api-ref/source/v2/samples/security-groups/security-group-rule-create-response.json
+++ b/api-ref/source/v2/samples/security-groups/security-group-rule-create-response.json
@@ -10,6 +10,7 @@
        "remote_ip_prefix": null,
        "security_group_id": "a7734e61-b545-452d-a3cd-0189cbd9747a",
        "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+        "revision_number": 1,
        "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
        "description": ""
    }
--- a/api-ref/source/v2/samples/security-groups/security-group-rule-show-response.json
+++ b/api-ref/source/v2/samples/security-groups/security-group-rule-show-response.json
@@ -8,6 +8,7 @@
        "protocol": null,
        "remote_group_id": null,
        "remote_ip_prefix": null,
+        "revision_number": 1,
        "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
        "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
        "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
--- a/api-ref/source/v2/samples/security-groups/security-group-rules-list-response.json
+++ b/api-ref/source/v2/samples/security-groups/security-group-rules-list-response.json
@@ -11,6 +11,7 @@
            "remote_ip_prefix": null,
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
            "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+            "revision_number": 1,
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "description": ""
        },
@@ -25,6 +26,7 @@
            "remote_ip_prefix": null,
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
            "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+            "revision_number": 1,
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "description": ""
        },
@@ -39,6 +41,7 @@
            "remote_ip_prefix": null,
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
            "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+            "revision_number": 2,
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "description": ""
        },
@@ -53,6 +56,7 @@
            "remote_ip_prefix": null,
            "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
            "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+            "revision_number": 1,
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
            "description": ""
        }
--- a/api-ref/source/v2/samples/security-groups/security-group-show-response.json
+++ b/api-ref/source/v2/samples/security-groups/security-group-show-response.json
@@ -15,6 +15,7 @@
                "remote_ip_prefix": null,
                "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                "revision_number": 1,
                "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                "description": ""
            },
@@ -29,6 +30,7 @@
                "remote_ip_prefix": null,
                "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                "revision_number": 2,
                "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                "description": ""
            },
@@ -43,6 +45,7 @@
                "remote_ip_prefix": null,
                "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                "revision_number": 1,
                "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                "description": ""
            },
@@ -57,11 +60,13 @@
                "remote_ip_prefix": null,
                "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                "revision_number": 1,
                "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                "description": ""
            }
        ],
        "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+        "revision_number": 4,
        "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
    }
 }
--- a/api-ref/source/v2/samples/security-groups/security-group-update-response.json
+++ b/api-ref/source/v2/samples/security-groups/security-group-update-response.json
@@ -2,6 +2,7 @@
    "security_group": {
        "security_group_rules": [],
        "project_id": "a52cdb9cc7854a39a23d3af73a40899e",
+        "revision_number": 4,
        "tenant_id": "a52cdb9cc7854a39a23d3af73a40899e",
        "id": "01fbade5-b664-42f6-83ae-4e214f4263fa",
        "name": "mysecgroup",
--- a/api-ref/source/v2/samples/security-groups/security-groups-list-response.json
+++ b/api-ref/source/v2/samples/security-groups/security-groups-list-response.json
@@ -16,6 +16,7 @@
                    "remote_ip_prefix": null,
                    "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                    "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                    "revision_number": 1,
                    "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                    "description": ""
                },
@@ -30,6 +31,7 @@
                    "remote_ip_prefix": null,
                    "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                    "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                    "revision_number": 2,
                    "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                    "description": ""
                },
@@ -44,6 +46,7 @@
                    "remote_ip_prefix": null,
                    "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                    "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                    "revision_number": 1,
                    "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                    "description": ""
                },
@@ -58,11 +61,13 @@
                    "remote_ip_prefix": null,
                    "security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
                    "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+                    "revision_number": 1,
                    "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
                    "description": ""
                }
            ],
            "project_id": "e4f50856753b4dc6afee5fa6b9b6c550",
+            "revision_number": 8,
            "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
        }
    ]
--- a/api-ref/source/v2/samples/segments/segment-create-response.json
+++ b/api-ref/source/v2/samples/segments/segment-create-response.json
@@ -5,6 +5,7 @@
    "segmentation_id": 2000,
    "network_type": "vlan",
    "physical_network": "segment-1",
+    "revision_number": 1,
    "id": "57fe85e4-ca2f-4192-b3cd-d5c249d7a21f",
    "description": null
  }
--- a/api-ref/source/v2/samples/segments/segment-show-response.json
+++ b/api-ref/source/v2/samples/segments/segment-show-response.json
@@ -5,6 +5,7 @@
    "segmentation_id": 2000,
    "network_type": "vlan",
    "physical_network": "segment-1",
+    "revision_number": 1,
    "id": "57fe85e4-ca2f-4192-b3cd-d5c249d7a21f",
    "description": null
  }
--- a/api-ref/source/v2/samples/segments/segment-update-response.json
+++ b/api-ref/source/v2/samples/segments/segment-update-response.json
@@ -5,6 +5,7 @@
    "segmentation_id": 2000,
    "network_type": "vlan",
    "physical_network": "segment-1",
+    "revision_number": 4,
    "id": "57fe85e4-ca2f-4192-b3cd-d5c249d7a21f",
    "description": "Segment One"
  }
--- a/api-ref/source/v2/samples/segments/segments-list-response.json
+++ b/api-ref/source/v2/samples/segments/segments-list-response.json
@@ -6,6 +6,7 @@
      "segmentation_id": 2000,
      "network_type": "vlan",
      "physical_network": "segment-1",
+      "revision_number": 1,
      "id": "57fe85e4-ca2f-4192-b3cd-d5c249d7a21f",
      "description": null
    },
@@ -15,6 +16,7 @@
      "segmentation_id": 2000,
      "network_type": "vlan",
      "physical_network": "segment-2",
+      "revision_number": 3,
      "id": "f1364c3a-4fc1-4206-b2dc-3254bc25cbfc",
      "description": null
    }
--- a/api-ref/source/v2/samples/subnets/subnet-create-response.json
+++ b/api-ref/source/v2/samples/subnets/subnet-create-response.json
@@ -22,7 +22,7 @@
        "description": "",
        "ipv6_address_mode": null,
        "ipv6_ra_mode": null,
-        "revision_number": 2,
+        "revision_number": 1,
        "service_types": [],
        "subnetpool_id": null,
        "updated_at": "2016-10-10T14:35:47Z"
--- a/api-ref/source/v2/samples/subnets/subnet-update-response.json
+++ b/api-ref/source/v2/samples/subnets/subnet-update-response.json
@@ -3,6 +3,7 @@
        "name": "my_subnet",
        "enable_dhcp": true,
        "network_id": "db193ab3-96e3-4cb3-8fc5-05f4296d0324",
+        "revision_number": 1,
        "segment_id": null,
        "project_id": "26a7980765d0414dbc1fc1f88cdb7e6e",
        "tenant_id": "26a7980765d0414dbc1fc1f88cdb7e6e",
--- a/api-ref/source/v2/samples/subnets/subnetpool-create-response.json
+++ b/api-ref/source/v2/samples/subnets/subnetpool-create-response.json
@@ -15,6 +15,7 @@
            "192.168.0.0/16"
        ],
        "project_id": "9fadcee8aa7c40cdb2114fff7d569c08",
+        "revision_number": 1,
        "shared": false,
        "tenant_id": "9fadcee8aa7c40cdb2114fff7d569c08"
    }
--- a/api-ref/source/v2/samples/subnets/subnets-create-bulk-response.json
+++ b/api-ref/source/v2/samples/subnets/subnets-create-bulk-response.json
@@ -23,7 +23,7 @@
            "description": "",
            "ipv6_address_mode": null,
            "ipv6_ra_mode": null,
-            "revision_number": 2,
+            "revision_number": 1,
            "service_types": [],
            "subnetpool_id": null,
            "updated_at": "2016-10-10T14:35:47Z"
@@ -51,7 +51,7 @@
            "description": "",
            "ipv6_address_mode": null,
            "ipv6_ra_mode": null,
-            "revision_number": 2,
+            "revision_number": 1,
            "service_types": [],
            "subnetpool_id": null,
            "updated_at": "2016-10-10T14:35:34Z"
--- a/api-ref/source/v2/security-group-rules.inc
+++ b/api-ref/source/v2/security-group-rules.inc
@@ -51,6 +51,7 @@ Response Parameters
   - project_id: project_id
   - port_range_min: port_range_min
   - remote_ip_prefix: remote_ip_prefix
+   - revision_number: revision_number
   - id: security_group_rule-id
   - description: description

@@ -109,6 +110,7 @@ Response Parameters
   - project_id: project_id
   - port_range_min: port_range_min
   - remote_ip_prefix: remote_ip_prefix
+   - revision_number: revision_number
   - id: security_group_rule-id
   - description: description

@@ -157,6 +159,7 @@ Response Parameters
   - project_id: project_id
   - port_range_min: port_range_min
   - remote_ip_prefix: remote_ip_prefix
+   - revision_number: revision_number
   - id: security_group_rule-id
   - description: description

--- a/api-ref/source/v2/security-groups.inc
+++ b/api-ref/source/v2/security-groups.inc
@@ -43,6 +43,7 @@ Response Parameters
   - id: security_group-id
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - name: name
   - description: description
   - security_group_rules: security_group_rules
@@ -93,6 +94,7 @@ Response Parameters
   - id: security_group-id
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - name: name
   - description: description
   - security_group_rules: security_group_rules
@@ -140,6 +142,7 @@ Response Parameters
   - id: security_group-id
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - name: name
   - description: description
   - security_group_rules: security_group_rules
@@ -186,6 +189,7 @@ Response Parameters
   - id: security_group-id
   - tenant_id: project_id
   - project_id: project_id
+   - revision_number: revision_number
   - name: name
   - description: description
   - security_group_rules: security_group_rules
--- a/api-ref/source/v2/segments.inc
+++ b/api-ref/source/v2/segments.inc
@@ -40,6 +40,7 @@ Response Parameters
   - network_id: network_id
   - physical_network: provider:physical_network
   - network_type: network_type
+   - revision_number: revision_number
   - segmentation_id: provider:segmentation_id
   - name: name
   - description: description
@@ -85,6 +86,7 @@ Response Parameters
   - network_id: network_id
   - physical_network: provider:physical_network
   - network_type: network_type
+   - revision_number: revision_number
   - segmentation_id: provider:segmentation_id
   - name: name
   - description: description
@@ -150,6 +152,7 @@ Response Parameters
   - network_id: network_id
   - physical_network: provider:physical_network
   - network_type: network_type
+   - revision_number: revision_number
   - segmentation_id: provider:segmentation_id
   - name: name
   - description: description
@@ -198,6 +201,7 @@ Response Parameters
   - network_id: network_id
   - physical_network: provider:physical_network
   - network_type: network_type
+   - revision_number: revision_number
   - segmentation_id: provider:segmentation_id
   - name: name
   - description: description
--- a/api-ref/source/v2/subnetpools.inc
+++ b/api-ref/source/v2/subnetpools.inc
@@ -53,7 +53,7 @@ Response Parameters
   - max_prefixlen: max_prefixlen
   - description: description
   - is_default: subnetpool_is_default
-   - revision_number: subnetpool_revision_number
+   - revision_number: revision_number

 Response Example
 ----------------
@@ -118,7 +118,7 @@ Response Parameters
   - max_prefixlen: max_prefixlen
   - description: description
   - is_default: subnetpool_is_default
-   - revision_number: subnetpool_revision_number
+   - revision_number: revision_number

 Response Example
 ----------------
@@ -201,7 +201,7 @@ Response Parameters
   - max_prefixlen: max_prefixlen
   - description: description
   - is_default: subnetpool_is_default
-   - revision_number: subnetpool_revision_number
+   - revision_number: revision_number

 Response Example
 ----------------
@@ -266,7 +266,7 @@ Response Parameters
   - max_prefixlen: max_prefixlen
   - description: description
   - is_default: subnetpool_is_default
-   - revision_number: subnetpool_revision_number
+   - revision_number: revision_number

 Response Example
 ----------------
--- a/api-ref/source/v2/subnets.inc
+++ b/api-ref/source/v2/subnets.inc
@@ -59,7 +59,7 @@ Response Parameters
   - description: description
   - ipv6_address_mode: subnet-ipv6_address_mode
   - ipv6_ra_mode: subnet-ipv6_ra_mode
-   - revision_number: subnet-revision_number
+   - revision_number: revision_number
   - segment_id: subnet-segment_id
   - service_types: subnet-service_types
   - subnetpool_id: subnet-subnetpool_id
@@ -169,7 +169,7 @@ Response Parameters
   - description: description
   - ipv6_address_mode: subnet-ipv6_address_mode
   - ipv6_ra_mode: subnet-ipv6_ra_mode
-   - revision_number: subnet-revision_number
+   - revision_number: revision_number
   - service_types: subnet-service_types
   - subnetpool_id: subnet-subnetpool_id
   - segment_id: subnet-segment_id
@@ -246,7 +246,7 @@ Response Parameters
   - description: description
   - ipv6_address_mode: subnet-ipv6_address_mode
   - ipv6_ra_mode: subnet-ipv6_ra_mode
-   - revision_number: subnet-revision_number
+   - revision_number: revision_number
   - segment_id: subnet-segment_id
   - service_types: subnet-service_types
   - subnetpool_id: subnet-subnetpool_id
@@ -301,7 +301,7 @@ Response Parameters
   - description: description
   - ipv6_address_mode: subnet-ipv6_address_mode
   - ipv6_ra_mode: subnet-ipv6_ra_mode
-   - revision_number: subnet-revision_number
+   - revision_number: revision_number
   - segment_id: subnet-segment_id
   - service_types: subnet-service_types
   - subnetpool_id: subnet-subnetpool_id
@@ -369,7 +369,7 @@ Response Parameters
   - description: description
   - ipv6_address_mode: subnet-ipv6_address_mode
   - ipv6_ra_mode: subnet-ipv6_ra_mode
-   - revision_number: subnet-revision_number
+   - revision_number: revision_number
   - segment_id: subnet-segment_id
   - service_types: subnet-service_types
   - subnetpool_id: subnet-subnetpool_id