Docs: Add a chapter on cluster config sync for the API

refs #9927
refs #9100

diff --git a/doc/9-icinga2-api.md b/doc/9-icinga2-api.md
index 5de413b11d150996667c14c52892b2e6969f14c4..ed6136f619be5003c39ccbfcdf1e509cdc3379fc 100644 (file)
--- a/doc/9-icinga2-api.md
+++ b/doc/9-icinga2-api.md
@@ -302,6 +302,18 @@ Reschedule a service check for all services in NOT-OK state:
 Provides functionality for all configuration object url endpoints listed
 [here](9-icinga2-api.md#icinga2-api-url-overview).
 
+### <a id="icinga2-api-objects"></a> API Objects and Cluster Config Sync
+
+Newly created or updated objects can be synced throughout your
+Icinga 2 cluster. Set the `zone` attribute to the zone this object
+belongs to and let the API and cluster handle the rest.
+
+If you add a new cluster instance, or boot an instance beeing offline
+for a while, Icinga 2 takes care of the initial object sync for all
+objects created by the API.
+
+More information about distributed monitoring, cluster and its
+configuration can be found [here](13-distributed-monitoring-ha.md#distributed-monitoring-high-availability).
 
 ### <a id="icinga2-api-hosts"></a> Hosts