Page History

Description

Les sources n'offrent pas de solution Une source ne peut pas être utilisée pour supprimer des éléments . Cela peut être utile dans un ( environnement cloud, lorsque certains équipements sont utilisés un certain laps de temps puis sont supprimés ).

• Pour pallier

• ce problème, une API est accessible par une URL

• .
• Elle permet de supprimer tous les types d'éléments de la configuration du Synchronizer.

Pré-requis

Afin de supprimer un élément de la configuration du synchronizer, il faut :

• Avoir un compte avec les droits Shinken Administrateur.
• Connaitre l'UUID de l'élément en question.
• Connaître son item_type.

Paramétrage du synchronizer

Par défaut, l'URL est désactivée sur le synchronizer.

• Pour l'activer il faut ajouter un paramètre dans le fichier de configuration du synchronizer. Il est conseillé de modifier le fichier suivant :

api_item_enabled=1

• Mettre ce paramètre à 0 désactivera l'URL.
• Après modification de ce paramètre, il convient de redémarrer le Synchronizer pour que le changement soit pris en compte.

Supprimer des éléments en staging et en zone de travail

URL

L'URL est la suivante :

http://localhost:7765/item-api/v1/delete-items-in-staging-and-working-area

Paramètres

Cette URL a besoin des paramètres suivants :

Format de retour

L'appel retourne un code 200  200 ( retour OK en HTML ) et un json avec les données suivantes :

• "msg" : un message de retour qui indique si tout tous les éléments ont été supprimés
• "deleted_items" qui contient
  • "list" : la liste des éléments qui ont été supprimés
  • "nb" : le nombre d'éléments supprimés
• "not_deleted_items" qui contient
  • "list" : la liste des éléments qui n'ont pas été supprimés
  • "nb" : le nombre d'élément éléments qui n'ont pas été supprimés

Voici un exemple de retour :

{
    "msg": "OK all items were deleted",
    "not_deleted_items": {
        "nb": 0,
        "list": []
    },
    "deleted_items": {
        "nb": 3,
        "list": ["c74d4b594249473997530fec6c1989fa", "1e093816492c4575b19df1cf34e53fd6", "a9a5223471e1406ab117af91502c24cf"]
    }
}

Si plusieurs éléments doivent être supprimés et que l'un d'eux cause une erreur, les autres suppressions ne seront pas impactées par cette erreur.

Les logs d'erreur seront présents dans le fichier de log du synchronizer : /var/log/shinken/synchronizerd.log

Voici les erreurs qui peuvent être rencontrées à la suppression d'éléments :

Exemples

Voici un exemple de réponse pour la suppression de deux hôtes

root@shinken: ~/ 15:59 : $ curl "http://localhost:7765/item-api/v1/delete-items-in-staging-and-working-area?password=YWRtaW4=&login=admin&item_type=hosts&uuids=50589d91a4ff11e7b9eff8bc12640001,50589d91a4ff11e7b9eff8bc12640002"
{"msg": "OK all items were deleted","not_deleted_items": {"nb": 0,"list": []},"deleted_items": {"nb": 2,"list": ["50589d91a4ff11e7b9eff8bc12640001", "50589d91a4ff11e7b9eff8bc12640002"]}}
root@shinken: ~/ 15:59 : $

Supprimer des éléments en production

URL

L'URL est la suivante :

http://localhost:7765/item-api/v1/delete-items-in-production

Paramètres

Cette URL a besoin des paramètres suivants :

Format de retour

L'appel retourne un code 200  et un json avec les données suivantes:

• "msg" : un message de retour qui indique si tout les éléments ont été supprimés
• "deleted_items" qui contient
  • "list" : la liste des éléments qui ont été supprimés
  • "nb" : le nombre d'éléments supprimés
• "not_deleted_items" qui contient
  • "list" : la liste des éléments qui n'ont pas été supprimés
  • "nb" : le nombre d'élément qui n'ont pas été supprimés

Voici un exemple de retour :

{
    "msg": "arbiter reload OK",
    "not_deleted_items": {
        "nb": 0,
        "list": []
    },
    "deleted_items": {
        "nb": 3,
        "list": ["c74d4b594249473997530fec6c1989fa", "1e093816492c4575b19df1cf34e53fd6", "a9a5223471e1406ab117af91502c24cf"]
    }
}

Si plusieurs éléments doivent être supprimés et que l'un d'eux cause une erreur, les autres suppressions ne seront pas impactées par cette erreur.

Les logs d'erreur seront présents dans le fichier de log du synchronizer : /var/log/shinken/synchronizerd.log

Voici les erreurs qui peuvent être rencontrées à la suppression d'éléments :

Exemples

Voici un exemple pour la suppression de deux hôtes

root@shinken: ~/ 15:59 : $ curl "http://localhost:7765/item-api/v1/delete-items-in-production?password=YWRtaW4=&login=admin&item_type=hosts&uuids=50589d91a4ff11e7b9eff8bc12640001,50589d91a4ff11e7b9eff8bc12640002"
{"msg": "arbiter reload OK","not_deleted_items": {"nb": 0,"list": []},"deleted_items": {"nb": 2,"list": ["50589d91a4ff11e7b9eff8bc12640001", "50589d91a4ff11e7b9eff8bc12640002"]}}
root@shinken: ~/ 15:59 : $