Extraction des valeurs actuelles des paramètres de serveur avancés

Disponible à partir de la version 9.2.3. Utilisez l'opération GET sur l'élément api/sam/configs pour demander des informations sur les valeurs actuelles des paramètres du serveur BigFix Inventory. La sortie est renvoyée au format JSON.

Tableau 1. Descriptions des opérations
Détails de l'opération Description
Fonctionnement GET /api/sam/configs
Finalité Renvoie des informations sur les valeurs actuelles des paramètres du serveur BigFix Inventory.
Méthode HTTP GET
URI de resources https://server_host_name:port_number/api/sam/configs
Relation du lien de l'URL n/a
Paramètres de requête de l'URL Pour obtenir une liste des paramètres de requête, voir : Paramètres de requête.
En-têtes de demande
Fonction métier
Accept-Language (Facultatif)
Valeurs
en-US (seul l'anglais est pris en charge)

Sert à négocier la langue de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la demande Non disponible
Demande Content-Type
  • Application/json
En-têtes de réponse
En-tête
Content-Type
Valeurs
Application/json

Définit le type de contenu de la réponse.
En-tête
Content-Language
Valeurs
en-US, …

Définit la langue du contenu de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la réponse configs élément
RéponseContent-Type
  • Application/json
Codes de réponse normaux HTTP n/a
Codes de réponse HTTP d'erreur n/a

Paramètres de requête

Le tableau suivant présente les paramètres de requête que vous pouvez utiliser pour l'élément configs.

Tableau 2. Paramètres de requête pour l'extraction des valeurs actuelles des paramètres du serveur

La table se compose de quatre colonnes et de deux lignes.
Paramètre Description Requis Valeur
nom Renvoie la configuration d'un paramètre unique. Pour la liste complète des valeurs possibles et leur explication, voir : Paramètres avancés du serveur. Non Nom du paramètre
Jeton Identificateur d'authentification utilisateur unique. Oui Alphanumérique

Exemple de conversation HTTP

Vérification de la valeur actuelle de tous les paramètres.
Demande
GET https://localhost:9081/api/sam/configs?token=
7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Extrait du corps de réponse (JSON) 
[
{"valueMax":10080,
"valueMin":0,
"valueType":"minutes",
"name":"vmman_transfer_period","value":"720"},

{"valueType":"boolean",
"name":"vmman_check_uniqueness_enabled",
"value":"true"},

{"valueType":"boolean",
"name":"blockUiBundlingComputations",
"value":"false"},

{"valueMax":10080,
"valueMin":0,
"valueType":"minutes",
"name":"catalog_download_task_stagger_interval",
"value":"0"},

{"valueType":"boolean",
"name":"storeHwDataForAllVMManagerNodes",
"value":"false"},
]
Vérification de la valeur actuelle d'un seul paramètre.
Demande
GET https://localhost:9081/api/sam/configs?token=
7adc3efb175e2bc0f4484bdd2efca54a8fa04623&name=maxVMManagerInactivity
Corps de réponse (JSON)
[
{"valueMax":90,
"valueMin":1,
"valueType":"days",
"name":"maxVMManagerInactivity",
"value":"3"}
]