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.

Tableau 1. Présentation des opérations REST
URI de l'opération REST cible Méthodes HTTP Motif de l'opération
api/get_token POST Renvoie un jeton unique requis pour authentifier les demandes de l'API REST.
api/sam/about Renvoie la version de BigFix Inventory.
api/import_status.json GET Renvoie le statut actuel de l'importation de données.
API principale
9.2.10 api/sam/v2/license_usage GET Renvoie des informations sur l'utilisation des métriques de licence en fonction des produits installés dans votre infrastructure.
PUT Configure les seuils des métriques de licence, ainsi que les valeurs de zones personnalisées ajoutées dans le rapport Toutes les métriques.
9.2.8 api/sam/v2/software_instances GET Renvoie les informations sur l'inventaire logiciel dans votre infrastructure.
9.2.8 api/sam/v2/computers GET Renvoie les informations sur l'inventaire matériel dans votre infrastructure.
9.2.12 api/sam/v2/detailed_hw_ip_addresses GET Extrait les informations relatives aux adresses IP des ordinateurs de votre infrastructure.
9.2.12 api/sam/v2/detailed_hw_lpars GET Extrait les informations relatives à la partition logique et à ses ressources UC.
9.2.12 api/sam/v2/detailed_hw_memories GET Extrait les informations relatives à la mémoire système du système analysé.
9.2.12 api/sam/v2/detailed_hw_network_adapters GET Extrait les informations relatives au type, au modèle et aux adresses MAC des adaptateurs réseau.
9.2.12 api/sam/v2/detailed_hw_operating_systems GET Extrait les informations relatives au système d'exploitation sur l'ordinateur analysé.
9.2.12 api/sam/v2/detailed_hw_partitions GET Extrait les informations relatives au système de fichiers monté sur un système analysé : Points de montage Unix et unités logiques Windows.
9.2.12 api/sam/v2/detailed_hw_physical_processors GET Extrait les informations relatives à tous les processeurs physiques actifs.
9.2.12 api/sam/v2/detailed_hw_smbios GET Extrait les informations relatives au SMBIOS du système analysé.
9.2.12 api/sam/v2/detailed_hw_storages GET Extrait les informations relatives aux périphériques de stockage sur le système analysé.
api/sam/raw_app_usage_property_values GET Extrait des données brutes de mesure.
api/sam/raw_file_facts GET Extrait des données brutes de fichiers analysés.
api/sam/raw_package_facts GET Extrait des données brutes de package.
api/sam/raw_unix_package_facts GET Extrait des données brutes de package UNIX.
10.0.5 /api/sam/unified/current/software GET Fournit une vue unifiée des instances logicielles et des données de package actuellement installées.
API de configuration
/api/sam/v2/contracts.json GET Extrait les informations du contrat.
/api/sam/v2/contracts.json PUT Ajoute et met à jour les contrats.
api/sam/vmmanagers GET Renvoie des informations sur les gestionnaires de machine virtuelle définis dans votre infrastructure.
PUT Ajoute ou met à jour des gestionnaires de machine virtuelle.
9.2.8 api/v1/servers PUT Modifie le facteur de coeur Oracle affecté à un serveur.
9.2.11 sam/component_lifecycles POST Définit la date de fin de prise en charge des composants logiciels.
9.2.11 sam/software_components/software_component_id/component_lifecycles DELETE Supprime la date de fin de prise en charge d'un composant logiciel.
9.2.11 sam/software_components/software_component_id/component_lifecycles DELETE Supprime la date de fin de prise en charge d'un composant logiciel.
api/reports/report_ID GET Exporte une vue de rapport sauvegardée.
api/reports POST Importe une vue de rapport sauvegardée.
api/sam/configs GET Renvoie des informations sur les paramètres actuels du serveur d'administration.
PUT Modifie les paramètres actuels du serveur d'administration.
10.0.4 api/sam/v2/metrics POST Crée et gère les produits et les métriques.
GET Renvoie la liste des produits et des métriques.
PUT Met à jour les métriques des produits.
DELETE Supprime les métriques des produits.
API historiques
api/sam/clusters GET Renvoie des informations sur les clusters qui regroupent vos systèmes informatiques hôtes.
api/sam/computer_systems GET Renvoie la liste des systèmes informatiques de votre infrastructure.
api/sam/license_usages GET Renvoie des informations sur l'utilisation des licences rapportée par vos systèmes informatiques.
api/sam/software_instances GET Renvoie la liste des instances logicielles installées.
Remarque : Cette API REST est désormais remplacée par l'API REST api/sam/v2/software_instances.
api/sam/swinventory/confirm POST Confirme les instances à regrouper ou affecter.
api/sam/swinventory/confirmRelease POST Confirme l'affectation des instances d'une édition.
api/sam/swinventory/exclude POST éxclut des instances des calculs de tarification.
api/sam/swinventory/include POST Inclut des instances dans les calculs de tarification.
api/sam/swinventory/instanceToShare GET Renvoie une liste d'éditions de logiciel qui peuvent partager une instance spécifique.
api/sam/swinventory/product/{product_id}/releases GET Renvoie une liste d'éditions d'un produit logiciel spécifique identifié par son identificateur.
api/sam/swinventory/products GET Renvoie une liste de produits logiciels.
api/sam/swinventory/reassign POST Réaffecte des instances à un produit.
api/sam/swinventory/reassignRelease POST Réaffecte des instances à un produit pour une liste d'éditions.
api/sam/swinventory/release/{release_id}/instances GET Renvoie une liste d'instances pour l'édition de produit logiciel demandée.
api/sam/swinventory/share POST Partage une instance avec une liste de produits logiciels.
api/sam/swinventory/targetBundlesOfInstances GET Renvoie une liste d'éditions potentielles auxquelles l'instance de logiciel demandée peut être réaffectée.
api/sam/swinventory/targetBundlesOfReleases GET Renvoie une liste d'éditions potentielles auxquelles les instances des éditions de logiciel demandées peuvent être réaffectées.
api/sam/swinventory/targetInstances GET Renvoie une liste d'instances cible qui seront réaffectées à une édition spécifique.