Détermination de l'utilisation des licences pour tous les systèmes informatiques

Vous pouvez extraire vos données en bloc pour déterminer l'utilisation totale des licences sur tous vos systèmes informatiques. Au lieu d'utiliser des rapports dans l'interface utilisateur de l'application, vous pouvez effectuer des demandes d'API pour extraire rapidement de grandes quantités de données.

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.

Considérations relatives aux performances

L'extraction de grandes quantités de données peut avoir un impact sur les performances de votre environnement. L'API ne doit donc pas être utilisée en même temps que d'autres tâches intensives en termes de performances, par exemple des importations de données. Pour plus d'informations, voir Considérations à prendre en compte sur l'API REST.
éxtrayez vos données dans des pages plutôt que de faire une requête distincte pour chaque ID d'ordinateur. Vous pouvez faire plusieurs requêtes d'API et utiliser les paramètres limit et offset pour mettre en page vos résultats.
Remarque :
- Pour les environnements qui présentent environ 200 000 nœuds finaux, il est conseillé d'extraire vos données dans des pages de 100 000 lignes pour les systèmes informatiques, de 200 000 lignes pour les instances logicielles et de 300 000 lignes pour l'utilisation des licences. Si vous limitez la première demande à 100 000 résultats, ajoutez la demande suivante au paramètre offset=100000 pour omettre les enregistrements déjà extraits. Ajustez les valeurs en fonction de la taille de votre déploiement.
- Si vous avez un nombre réduit de nœuds finaux, vous pouvez omettre les paramètres limit et offset, et extraire vos données en utilisant une seule demande API.

Procédure

éxtrayez la liste de vos systèmes informatiques :

https://hostname:port/api/sam/computer_systems?
token=token&limit=100000&offset=100000

Résultat : Chaque système informatique a un id différent. Vous pourrez utiliser cet id ultérieurement pour créer une correspondance entre vos instances logicielles et les systèmes informatiques.

{
    "id": 182,
    "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 la lite de vos instances logicielles. La colonne software_title_name qui vous permet de reconnaître le nom de votre logiciel est masquée par défaut, ce qui signifie que vous devez ajouter l'URL avec le paramètre columns[] suivi du nom d'une colonne masquée.
L'exemple suivant extrait les colonnes computer_system_id et software_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&limit=100000&offset=100000&
columns[]=computer_system_id&columns[]=catalog_dimension.software_title_name
```
Résultat : Chaque instance logicielle contient une colonne computer_system_id qui 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 colonne computer_system_id=182, c'est que toutes ces instances logicielles sont installées sur un système informatique dont l'ID est 182.
```
{
    "computer_system_id": 182,
    "catalog_dimension": {
        "software_title_name": "BigFix Inventory"
    }
```
éxtrayez les informations d'utilisation des licences. Ajoutez l'URL dont la colonne est software_title_dimension.name pour 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_value et software_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&limit=100000&offset=100000&
columns[]=computer_system_id&columns[]=metric_name&columns[]=peak_value&
columns[]=software_title_dimension.name
```
Résultat : Chaque enregistrement contient une colonne computer_system_id qui 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 colonne computer_system_id=182, c'est que tous ces enregistrements d'utilisation de licences sont présentés pour un système informatique dont l'ID est 182. La colonne peak_value représente l'utilisation maximale des licences (au cours des 90 derniers jours) pour un titre de logiciel particulier (qui est décrit par software_title_dimension.name). La colonne metric_name vous permet de déterminer si le type de licence est PVU ou RVU, complet ou en capacité partielle.
```
{
    "computer_system_id": 182,
    "metric_name": "RVU_FULL_CAP",
    "peak_value": 2,
    "software_title_dimension": {
        "name": "BigFix Inventory"
}},

{
    "computer_system_id": 182,
    "metric_name": "RVU_SUB_CAP",
    "peak_value": 2,
    "software_title_dimension": {
        "name": "BigFix Inventory"
}}
```
Déterminez l'utilisation totale des licences pour un logiciel en faisant la somme des valeurs de toutes les colonnes peak_value extraites pour ce logiciel à partir de tous vos systèmes informatiques. Par exemple, additionnez toutes les peak_values pour BigFix Inventory sur tous les systèmes informatiques qui contiennent des entrées pour ce logiciel spécifique. N'associez pas les types métriques, mais calculez les valeurs PVU_FULL_CAP, RVU_FULL_CAP, PVU_SUB_CAP et RVU_SUB_CAP séparément.