neutron-lib/api-ref/source/v2
Bence Romsics 5dcccd2c66 New agent attribute: resources_synced
Agents supporting the guaranteed minimum bandwidth feature need to share
their resource view with neutron-server and in turn with Placement too.
The resource information is synchronized to neutron-server via the
periodic agent heartbeat therefore transient synchronization errors are
fixed by the next heartbeat. But synchronization to Placement is not
done periodically, but on a (mostly) on demand basis. Therefore to fix
transient errors of the synchronization to Placement we must remember
the success/failure of the last synchronization attempt.

This change introduces a new boolean agent attribute: resources_synced

This attribute is:
* admin-only (just like the whole agent extension)
* read-only (it is only updated by the internal synchronization process)

If this attribute is not set then no synchronization to Placement ever
happened (which is the natural state of agents not tracking their
resources via Placement).

If it is False, then another successful synchronization is needed before
the contents of Placement can be considered up to date.

If it is True, then this agent's resources are up to date in Placement.

Change-Id: Ia3dea82fabe5e068192fbe931db8d341d3d37149
Needed-By: https://review.openstack.org/630999
Partial-Bug: #1578989
See-Also: https://review.openstack.org/502306 (nova spec)
See-Also: https://review.openstack.org/508149 (neutron spec)
2019-01-23 16:27:47 +01:00
..
samples New agent attribute: resources_synced 2019-01-23 16:27:47 +01:00
address-scopes.inc api-ref: document sorting parameters for address scope 2018-05-08 19:08:14 +00:00
agents.inc New agent attribute: resources_synced 2019-01-23 16:27:47 +01:00
auto-topology.inc add api ref for auto allocated topology 2017-12-11 15:49:56 -07:00
availability_zones.inc api-ref: add availability_zone extension 2018-05-29 22:20:57 +00:00
bgpvpn-bgpvpns.inc [Api-ref] Cleanup parameters.yaml 2018-01-28 16:19:19 +01:00
bgpvpn-network_associations.inc bgpvpn-routes-control extension 2017-06-14 16:19:34 +00:00
bgpvpn-overview.inc api-ref, bgpvpn API extension: update status 2018-03-01 09:48:55 +00:00
bgpvpn-port_associations.inc api-ref, bgpvpn API extension: update status 2018-03-01 09:48:55 +00:00
bgpvpn-router_associations.inc Revert "Withdraw doc for bgpvpn-routes-control API extension" 2017-09-19 17:32:57 +02:00
dhcp-agent-scheduler.inc Documenting DHCP agent scheduler 2018-06-04 13:46:27 +03:00
extensions.inc api-ref: Correcting Network v2.0 API extensions 2016-11-11 10:07:07 +07:00
fip-port-forwarding.inc api-ref for floating IPs port forwardings 2018-08-06 21:52:36 -05:00
fip64.inc Add FIP64 extension from networking-midonet 2017-02-06 09:09:38 +09:00
firewall_log.inc Add a space after comma 2017-02-06 09:09:38 +09:00
flavors.inc api-ref: add filter parameters to resource management 2018-05-03 15:59:16 +00:00
floatingippools.inc api-ref: document floating ip pools endpoint 2018-08-16 15:03:34 +00:00
floatingips.inc Extend port_forwardings field in Floatingip response 2018-07-09 09:47:24 +08:00
fwaas-v2.inc api-ref, fwaas-v2: Remove 'status' from request. 2018-08-10 17:26:28 +02:00
fwaas.inc Add a note about the current status of FWaaS v1 2017-02-23 13:53:19 -05:00
index.rst api-ref: document network-segment-range extension 2019-01-09 06:33:37 +08:00
intro.inc Merge "Add shim extension filter-validation" 2018-07-15 00:26:30 +00:00
l3-agent-scheduler.inc Documenting L3 agent scheduler 2018-05-06 10:22:58 +03:00
lbaas-v2.inc Fix the mistake of lbaas api-ref 2018-08-30 07:25:51 +00:00
logging.inc Add timestamp attributes to standard resources 2018-04-27 21:23:46 +00:00
logging_resource.inc Add a space after comma 2017-02-06 09:09:38 +09:00
metering.inc api-ref: add filter parameters to resource management 2018-05-03 15:59:16 +00:00
network-ip-availability.inc Add is_filter to network_ip_availability 2018-08-27 21:42:50 +00:00
network_segment_ranges.inc api-ref: document network-segment-range extension 2019-01-09 06:33:37 +08:00
networks.inc Adding tags to responses for relevant resources 2018-05-06 10:27:40 +03:00
parameters.yaml New agent attribute: resources_synced 2019-01-23 16:27:47 +01:00
ports.inc api-ref: document uplink status propagation 2018-12-10 23:47:58 +00:00
qos.inc Fix QoS alias api definition 2018-11-28 21:47:01 -06:00
quota_details.inc api ref for quota details extension 2017-09-18 05:11:37 -06:00
quotas.inc api-ref: some quota APIs don't return 404 2017-03-09 22:28:16 +09:00
rbac-policy.inc api-ref: add filter parameters to rbac 2018-04-27 21:19:56 +00:00
router-interface-fip.inc Add router-interface-fip extension from networking-midonet 2017-02-06 09:09:38 +09:00
routers.inc Fix the misspelling of "interface" 2019-01-07 11:06:41 +08:00
security-group-rules.inc api-ref: several fixes on security group rules 2018-05-03 15:58:40 +00:00
security-groups.inc Adding tags to responses for relevant resources 2018-05-06 10:27:40 +03:00
segments.inc Add timestamp attributes to standard resources 2018-04-27 21:23:46 +00:00
service-providers.inc api-ref: Fix api-ref for service-providers 2016-10-20 16:24:16 +00:00
subnetpools.inc Show is_default as a valid parameter for subnet pool creation 2018-08-30 15:25:06 -05:00
subnets.inc Merge "Shim extension - segments peer subnet host routes, and api-ref" 2018-06-29 13:57:46 +00:00
tags.inc Adding tags to responses for relevant resources 2018-05-06 10:27:40 +03:00
trunk-details.inc api-ref: Fix api-ref for ports 2017-02-03 11:22:02 +09:00
trunk.inc Adding tags to responses for relevant resources 2018-05-06 10:27:40 +03:00
versions.inc api-ref: Add Networking v2.0 API versions response parameters 2016-09-20 09:48:02 +07:00
vpnaas.inc [Api-ref] Cleanup parameters.yaml 2018-01-28 16:19:19 +01:00