Versions Compared

Old Version 1

changes.mady.by.user benjamin martin

Saved on

compared with

New Version 2

changes.mady.by.user Jroy

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue


Panel
titleSommaire

Table of Contents
stylenone



Objectifs

Méthode POST de type READ qui permet de récupérer des données de supervision d'un cluster et les informations de ses checks, comme sur l'Interface de Visualisation.

Paramètres
Anchor
nameuuid
nameuuid

Le paramètre ID reçu dans l'URL identifie l'élément à rechercher.

Sa nature (nom ou UUID) est définie à l'aide du paramètre is_name  (paramètre POST, détaillé ci-dessous). 

Warning

Certains caractères sont interdits dans les URL, ils doivent être échappés (URL encodées) pour pouvoir être utilisés

caractère interdit:/?#[]@!$&'()*+,;=%(espace)
remplacement%3A%2F%3F%23%5B%5D%40%21%24%26%27%28%29%2A%2B%2C%3B%3D%25%20  ou  +

Pour plus d'information, vous pouvez consulter : https://developer.mozilla.org/fr/docs/Glossary/percent-encoding et rfc3986

Exemple: pour utiliser le nom ch@nged_name  il faudra utiliser l'url  http://broker-module-livedata:50100/api/v2/cluster/ch%40nged_name


Les 2 paramètres suivants sont également disponibles :

Anchor
is_name
is_name

NomTypeDéfautCommentaire

is_name 

Booléen true
  • true, ID est considéré comme un nom d'hôte pour la récupération de l'hôte
  • false, ID est considéré comme un UUID pour la récupération de l'hôte


Réponse

Codes de retour


Codes de retourExplications
200

OK

400

Paramètre invalide

401

Accès nécessite une authentification ou un Token valide.

403

Authentification de l'utilisateur OK , mais droits non suffisants.

404

L'hôte demandé n'existe pas

405

L’élément correspondant à l'ID n'est pas un hôte

500

L'appel est valide, mais un problème d'exécution est survenu.


Retour du code 200

Les propriétés retournées doivent être choisies avec l'option output_field

Mais les propriétés suivantes seront au minimum automatiquement retournées :

  • nb_element
  • type
  • father_uuid
  • father_name
  • par checks :
    • check_uuid
    • check_name


Voir la page V2 - Les API du broker-module-livedata - les propriétés présentes dans le retour 200, pour la description complète de toutes les propriétés pouvant être renvoyée.


Code Block
languagebash
themeEmacs
curl -s -S -H 'x-api-token: XYZ' \
http://broker-module-livedata:50100/api/v2/cluster/datacenter%20bdx



Code Block
titlehttp://localhost:50100//api/v2/host/095ac6b028d811ebb7a9080027774a8d
{
  "request_statistics": {
    "nb_elements_total": 9,
    "nb_clusters_total": 1,
    "nb_checks_total": 4,
    "nb_elements_filtered": 2,
    "nb_clusters_filtered": 1,
    "nb_checks_filtered": 1
  },
  "elements_found": [
    {
      "father_uuid": "d6921ee8ba1511eba36c0800277faebe",
      "father_name": "datacenter bdx",
      "type": "cluster"
    },
    {
      "check_name": "System Uptime",
      "check_uuid": "d6921ee8ba1511eba36c0800277faebe-e6daad4cba1511eb95980800277faebe",
      "father_uuid": "d6921ee8ba1511eba36c0800277faebe",
      "father_name": "datacenter bdx",
      "type": "check_cluster"
    }
  ]
}


Retour du code 400

Paramètre GET absent ( ID )

Le paramètre attendu est un nom


Code Block
languagebash
themeEmacs
curl -s -S -H "x-api-token: XYZ" \
http://broker-module-livedata:50100/api/v2/cluster



Panel
borderColor#dfe1e5
borderWidth1
borderStylesolid

ERROR 400: mandatory parameter [ name ] is missing


Le paramètre attendu est un UUID


Code Block
languagebash
themeEmacs
curl -s -S -H "x-api-token: XYZ" \
-d "is_name=false" \
http://broker-module-livedata:50100/api/v2/cluster



Panel
borderColor#dfe1e5
borderWidth1
borderStylesolid

ERROR 400: mandatory parameter [ uuid ] is missing


Paramètres POST incorrects

Paramètre inconnu


Code Block
languagebash
themeEmacs
curl -s -S -H "x-api-token: XYZ" \
-d "parametre_inconnu=is_status_:true" \
http://broker-module-livedata:50100/api/v2/cluster/ID



Panel
borderColor#dfe1e5
borderWidth1
borderStylesolid

ERROR 400: POST parameter [ parametre_inconnu ] is unknown


Paramètre désactivé sur cette route


Code Block
languagebash
themeEmacs
curl -s -S -H "x-api-token: XYZ" \
-d "output_format=checks_attached_to_father" \
http://broker-module-livedata:50100/api/v2/cluster/ID



Panel
borderColor#dfe1e5
borderWidth1
borderStylesolid

ERROR 400: POST parameter [ output_format ] is not available for this route


Messages d'erreurs lors du paramétrage des propriétés présentes dans la sortie ( output_field )

Propriété de sortie inexistante


Code Block
languagebash
themeEmacs
curl -s -S -H "x-api-token: XYZ" \
-d "output_field=is_status_" \
http://broker-module-livedata:50100/api/v2/cluster/ID



Panel
borderColor#dfe1e5
borderWidth1
borderStylesolid

ERROR 400: output_field: invalid field name [ is_status_ ]


Messages d'erreurs liés au paramètre

HIDDEN - V02.08.02 - V2 - ( READ ) /api/v2/cluster/{ID}

is_name

Valeur incorrecte


Code Block
languagebash
themeEmacs
curl -s -S -H "x-api-token: XYZ" \
-d "is_name=cluster" \
http://broker-module-livedata:50100/api/v2/cluster/ID



Panel
borderColor#dfe1e5
borderWidth1
borderStylesolid

ERROR 400: is_name: invalid value [cluster]