From: Michael Friedrich <michael.friedrich@netways.de>
Date: Thu, 17 Sep 2015 13:52:54 +0000 (+0200)
Subject: Docs: Add a chapter on cluster config sync for the API
X-Git-Tag: v2.4.0~312
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7dc3d28eafde26f3dd0464e10ea5d51605129c8f;p=icinga2

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 5de413b11..ed6136f61 100644
--- 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