Détermination de l'utilisation des licences pour certains systèmes informatiques
Vous pouvez limiter les résultats de vos demandes d'API pour extraire les données de certains systèmes informatiques. Cette approche est conseillée si vous voulez rapidement cibler des informations spécifiques.
Avant de commencer
- Chaque demande d'API doit être authentifiée avec le paramètre token. Vous pouvez l'extraire en utilisant l'API REST pour l'extraction du jeton d'authentification. Vous pouvez également vous connecter à BigFix Inventory, survoler l'icône Utilisateur
et cliquer sur Profil. Cliquez ensuite sur Afficher le jeton. - Pour obtenir la liste des paramètres de requête afin de limiter vos résultats et la liste des colonnes disponibles, voir les informations relatives à un type d'API particulier.
Procédure
- éxtrayez les systèmes informatiques sélectionnés par l'interrogation de leur ID :
https://hostname:port/api/sam/computer_systems? token=token&criteria={"or":[["id","=","1"],["id","=","2"]]}Résultat : Chaque système informatique a un
iddifférent. Vous pourrez utiliser cetidultérieurement pour créer une correspondance entre vos instances logicielles et les systèmes informatiques. Dans l'API pour les instances logicielles et l'utilisation des licences, cetidest représenté par la colonnecomputer_system_id.{ "id": 2, "parent_id": 175, "type": "virtual", "os": "Win2008R2 6.1.7601", "host_name": "NC9128109187", "dns_name": "NC9128109187", "ip_address": [ "9.128.109.187"], "last_seen": "2014-06-06T03:56:39Z", "hardware_manufacturer": "-", "hardware_model": "-", "hardware_serial_number": "TLM_VM_4236ac43", "processor_type": "Multi-core", "processor_brand": "Xeon(R), 3 or 4 Socket", "processor_vendor": "Intel(R)", "processor_model": "E3-12xx, E7-28xx, E7-48xx", "partition_cores": "1.0", "server_processors": 1, "server_cores": 1 } - éxtrayez les instances logicielles de certains systèmes informatiques en demandant leur ID :
L'exemple suivant extrait les colonnes
computer_system_idetsoftware_title_name, ce qui vous permet de déterminer quel logiciel est installé sur quel système informatique. Si vous voulez extraire des informations complètes, ajoutez l'URL avec les noms de toutes les colonnes. Vous trouverez les noms de colonnes dans le corps de la réponse :https://hostname:port/api/sam/software_instances? token=token& criteria={"or":[["computer_system_id","=","1"],["computer_system_id","=","2"]]} &columns[]=computer_system_id&columns[]=catalog_dimension.software_title_nameRésultat : Chaque instance logicielle contient une colonne
computer_system_idqui représente un ID d'un ordinateur sur lequel une instance particulière est installée. Utilisez cette colonne pour faire correspondre vos instances logicielles avec les systèmes informatiques. Par exemple, si les lignes 152-155 contiennent une colonnecomputer_system_id=2, c'est que toutes ces instances logicielles sont installées sur un système informatique dont l'ID est 2.{ "computer_system_id": 2, "catalog_dimension": { "software_title_name": "BigFix Inventory" } - éxtrayez les licences logicielles de certains systèmes informatiques en demandant leur ID. Ajoutez l'URL dont la colonne est
software_title_dimension.namepour pouvoir reconnaître le nom du logiciel pour lequel l'utilisation des licences est présentée.L'exemple suivant extrait les colonnes
computer_system_id,metric_name,peak_valueetsoftware_title_dimension.name. Si vous voulez extraire des informations complètes, ajoutez l'URL avec les noms de toutes les colonnes. Vous trouverez les noms de colonnes dans le corps de la réponse :https://hostname:port/api/sam/license_usages? token=token& criteria={"or":[["computer_system_id","=","1"],["computer_system_id","=","2"]]} &columns[]=computer_system_id&columns[]=metric_name&columns[]=peak_value& columns[]=software_title_dimension.nameRésultat : Chaque enregistrement contient une colonne
computer_system_idqui représente l'ID d'un ordinateur pour lequel l'utilisation des licences est calculée. Utilisez cette colonne pour faire correspondre l'utilisation des licences avec les systèmes informatiques. Par exemple, si les lignes 152-155 contiennent une colonnecomputer_system_id=2, c'est que tous les enregistrements d'utilisation des licences sont présentés pour un système informatique dont l'ID est 2. La colonnepeak_valuereprésente l'utilisation maximale des licences (au cours des 90 derniers jours) pour un titre de logiciel particulier (décrit parsoftware_title_dimension.name). La colonnemetric_namevous permet de déterminer si le type de licence est PVU ou RVU, complet ou en capacité partielle.{ "computer_system_id": 2, "metric_name": "RVU_SUB_CAP", "peak_value": 2, "software_title_dimension": { "name": "BigFix Inventory" }}