Welcome
Intégration à l'API REST
L'intégration des systèmes externes est une fonction clé de BigFix Inventory. Une logique métier est activée pour l'intégration et les interfaces sont fournies pour les points d'intégration communs.
API REST
Gérer de grandes quantités d'informations à l'aide de l'interface utilisateur de l'application peut s'avérer chronophage. Vous pouvez utiliser les API REST comme alternative à l'interface graphique utilisateur pour réduire le temps requis pour gérer votre inventaire système et le contenu de votre catalogue des logiciels.
API de configuration
Les API de configuration incluent toutes les API dont vous avez besoin pour configurer l'application.
API REST pour le changement des paramètres avancés du serveur
Disponible à partir de la version 9.2.3. Vous pouvez modifier les paramètres du serveur BigFix Inventory à l'aide de l'API REST.
Configuration des paramètres avancés du serveur
Disponible à partir de la version 9.2.3. Utilisez l'opération PUT sur l'élément api/sam/configs pour modifier les valeurs des paramètres du serveur BigFix Inventory.

Page d'accueil de la documentation BigFix
Documentation de BigFix Inventory 10
Présentation
Familiarisez-vous avec les principaux concepts nécessaires pour comprendre le fonctionnement de BigFix Inventory et découvrez les fonctionnalités et fonctions introduites dans chacune des versions de l'application.
Installation
Découvrez les conditions requises et les scénarios d'installation disponibles pour vous assurer que le déploiement de BigFix Inventory s'effectue correctement dans votre environnement.
Configuration
Après avoir installé BigFix Inventory, configurez l'application. Créez des comptes pour les utilisateurs qui ont besoin d'accéder à l'application et configurez des analyses pour collecter des données d'inventaire de logiciels et de matériel depuis votre environnement.
Mise à niveau
Une nouvelle version de est publiée régulièrement, généralement à la fin de chaque trimestre calendaire. Procédez à une mise à niveau régulière vers la nouvelle version pour tirer pleinement parti des nouvelles fonctions et des correctifs d'application.
Gestion de l'infrastructure
Une fois que vous avez terminé la configuration initiale de , apprenez à gérer les composants de son infrastructure : gestionnaires de machine virtuelle, serveur, base de données et sources de données.
Inventaire de logiciels et utilisation des licences
Vous pouvez classer les logiciels reconnus de sorte que les rapports de BigFix Inventory reflètent vos autorisations et montrent correctement l'utilisation des métriques de licence en fonction de produits particuliers.
Gestion des menaces de sécurité
Apprenez à utiliser pour gérer les menaces de sécurité dans votre environnement. Vous pouvez voir si l'un des composants installés est sujet à une CVE (Common Vulnerability and Exposure).
Tutoriels
Les tutoriels permettent de comprendre la manière d'utiliser . Ils sont constitués de modules qui ciblent des objectifs vastes. Les modules comprennent des tâches qui montrent comment configurer des paramètres spécifiques, étape par étape.
Sécurité
Configurez diverses fonctions de sécurité pour protéger de manière adéquate les actifs et ressources de l'entreprise dans le modèle de données lorsque vous utilisez BigFix Inventory.
Traitement des incidents et support
Découvrez les solutions aux problèmes courants qui peuvent survenir lorsque vous utilisez BigFix Inventory et comment trouver des journaux et des fichiers de trace qui vous aident à les résoudre.
Optimisation des performances
Cette section explique comment planifier l'infrastructure de BigFix Inventory et comment configurer le serveur d'applications pour obtenir des performances optimales. Les instructions ci-dessous s'appliquent à des environnements big data, ainsi qu'à des environnements plus petits dotés de configurations matérielles moins performantes.
Intégration à l'API REST
L'intégration des systèmes externes est une fonction clé de BigFix Inventory. Une logique métier est activée pour l'intégration et les interfaces sont fournies pour les points d'intégration communs.
- API REST
  Gérer de grandes quantités d'informations à l'aide de l'interface utilisateur de l'application peut s'avérer chronophage. Vous pouvez utiliser les API REST comme alternative à l'interface graphique utilisateur pour réduire le temps requis pour gérer votre inventaire système et le contenu de votre catalogue des logiciels.
  - Produits et composants logiciels
    BigFix Inventory détecte les composants logiciels qui sont fournis avec le produit.
  - Ressources de l'API REST et méthodes HTTP
    Les opérations du protocole de l'API REST de BigFix Inventory sont définies en tant que méthodes HTTP sur certaines ressources REST.
  - éléments courants des API REST
    Vous utilisez des connecteurs et opérateurs pour générer des segments de requêtes qui filtrent les conditions et valeurs correspondantes.
  - Mappage des versions d'API REST
    Disponible à partir de la version 9.2.8. Pour certains API REST, la version 2 a été créée pour améliorer des fonctions ou l'expérience. Dans de tels cas, l'API d'origine devient obsolète avec le temps et seule la version 2 continue d'être développée. Si certains de vos outils personnalisés ou processus internes reposent sur de telles API REST, il est recommandé de les ajuster de sorte qu'ils utilisent la nouvelle version des API.
  - API REST pour l'extraction du jeton d'authentification
    Utilisez l'opération POST sur l'élément api/get_token pour demander votre jeton unique requis pour authentifier les demandes API REST.
  - API REST pour l'extraction de la version BigFix Inventory
    Utilisez l'opération GET sur l'élément api/sam/about pour demander des informations sur la version de BigFix Inventory.
  - API principales
    Les API de cœur incluent tous les ensembles principaux d'API intégrées à BigFix Inventory.
  - API de configuration
    Les API de configuration incluent toutes les API dont vous avez besoin pour configurer l'application.
    - API REST pour gérer les gestionnaires de machine virtuelle
      Vous pouvez utiliser les demandes d'API REST pour ajouter et modifier les gestionnaires de machine virtuelle dans l'infrastructure.
    - API REST pour le changement des paramètres avancés du serveur
      Disponible à partir de la version 9.2.3. Vous pouvez modifier les paramètres du serveur BigFix Inventory à l'aide de l'API REST.
      - 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.
      - Configuration des paramètres avancés du serveur
        Disponible à partir de la version 9.2.3. Utilisez l'opération PUT sur l'élément api/sam/configs pour modifier les valeurs des paramètres du serveur BigFix Inventory.
    - API REST pour la définition et la suppression de la date de fin de prise en charge
      Disponible à partir de la version 9.2.11. Vous pouvez définir et supprimer la date de fin de prise en charge de n'importe quel composant logiciel à l'aide de l'API REST.
    - API REST pour ajouter et retirer des balises
      Disponible à partir de la version 9.2.14. Vous pouvez ajouter et retirer des balises pour n'importe quel composant logiciel à l'aide de l'API REST.
    - API REST pour l'exportation et l'importation de vues de rapport sauvegardé
      Vous pouvez utiliser des demandes API REST pour exporter une vue de rapport sauvegardé depuis une instance de BigFix Inventory et l'importer dans une autre instance de l'application.
    - API REST pour la mise à jour du facteur de coeur Oracle
      Disponible à partir de la version 9.2.8. Utilisez l'opération PUT sur l'élément api/v1/servers pour modifier le facteur de cœur de processeur appliqué à un groupe de serveurs afin de calculer l'utilisation de la métrique cœur de processeur Oracle.
    - API REST pour la gestion des métriques de licence
      Utilisez les requêtes d'API REST pour extraire, créer, modifier et supprimer des métriques de licence. A partir de la version 10.0.5, vous pouvez également gérer les métriques via l'interface utilisateur. Voir aussi Gestion des métriques de licence via l'interface utilisateur.
    - API REST pour la gestion des contrats
      Avec l'API /api/sam/v2/contracts.json, vous pouvez importer et exporter des données de contrat avec des informations d'achat. Cette opération est utilisée pour automatiser l'intégration à des systèmes d'achat externes. Vous pouvez également gérer les contrats à l'aide des éléments suivants : importation de CSV de contrats, interface utilisateur - Panneau Tous les contrats et migration des contrats obsolètes.
  - API historiques
    Pour certains API REST, la version 2 a été créée pour améliorer des fonctions ou l'expérience. Dans ce cas, l'API d'origine est dépréciée et la version 2 est prise en charge. Vous devez ajuster vos outils personnalisés ou processus internes à la nouvelle version de ces API.
Glossaire
Guide au format PDF

Configuration des paramètres avancés du serveur

Disponible à partir de la version 9.2.3. Utilisez l'opération PUT sur l'élément api/sam/configs pour modifier les valeurs des paramètres du serveur BigFix Inventory.

Icône représentant un utilisateur.

Vous devez être administrateur pour effectuer cette tâche.

Tableau 1. Descriptions des opérations
Détails de l'opération	Description
Fonctionnement	`PUT /api/sam/configs`
Finalité	Modifie la valeur d'un paramètre du serveur.
Méthode HTTP	`PUT`
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/x-www-form-urlencoded`
En-têtes de 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	n/a
Réponse`Content-Type`	n/a
Codes de réponse normaux HTTP	`204`
Codes de réponse HTTP d'erreur	`400 - "Bad Request"` si la valeur fournie n'est pas valide. Par exemple, elle ne se trouve pas dans la plage spécifiée ou son type est incorrect. `404 - "Not Found"`

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 le changement des valeurs actuelles des paramètres du serveur
Paramètre	Description	Requis	Valeur
nom	Indique le paramètre dont la valeur doit être modifiée. Pour la liste complète des valeurs possibles et leur explication, voir : Paramètres avancés du serveur.	Oui	Nom du paramètre
Jeton	Identificateur d'authentification utilisateur unique.	Oui	Alphanumérique
valeur	Indique la nouvelle valeur du paramètre.	Oui	Valeur comprise dans la plage spécifique du paramètre.

Exemple de conversation HTTP

Demande

PUT http://localhost:9981/api/sam/configs
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&name=
maxVMManagerInactivity&value=30