Leçon 1 : Extraction des informations sur les affectations de logiciels pour un ordinateur donné

Disponible à partir de la version 9.2.14 Cette leçon explique comment utiliser la requête d'API REST pour extraire des affectations de logiciels d'un ordinateur déplacé sur le nouveau serveur BigFix.

Avant de commencer

Vous devez disposer des droits Afficher les nœuds finaux et Afficher l'inventaire matériel pour exécuter cette tâche.

Pourquoi et quand exécuter cette tâche

Ce tutoriel est basé sur l'ancien et le nouvel ID ordinateur de la source de données de l'ordinateur qui est migré sur le nouveau serveur BigFix. Ces informations sont indispensables pour les demandes API REST. Pour migrer des affectations de logiciels pour plusieurs ordinateurs, commencez par préparer une liste d'anciens et de nouveaux ID ordinateur de la source de données pour tous les ordinateurs concernés. Pour obtenir des résultats optimaux, migrez ensuite vos affectations de logiciels pour chaque ordinateur de votre environnement séparément. Le nombre d'instances logicielles par demande d'API ne doit pas dépasser 150.

Procédure

Déplacez l'ordinateur vers le nouveau serveur BigFix.
Ajoutez une nouvelle source de données à BigFix Inventory.
Téléchargez les résultats de l'analyse de logiciels à partir de l'ordinateur connecté au nouveau serveur BigFix.
Collectez une paire composée de l'ancien et du nouvel ID ordinateur de la source de données de chaque ordinateur.
1. Connectez-vous à BigFix Inventory.
2. Accédez à Rapports > Ordinateurs.
3. Survolez Configurer et cliquez sur Configurer la vue. Sélectionnez Nom de la source de données et ID ordinateur de la source de données dans la liste de colonnes et cliquez sur Soumettre.
4. Triez les données du rapport par Nom de l'ordinateur en cliquant sur l'en-tête de la colonne. En examinant le nom de l'ordinateur et le nom de la source de données, préparez une paire composée de l'ancien et du nouvel ID ordinateur de la source de données de l'ordinateur. L'exemple suivant est utilisé dans ce tutoriel :
  - ID ordinateur de la source de données affecté à l'ancienne source de données dans le rapport : 9596634
  - ID ordinateur de la source de données affecté à la nouvelle source de données dans le rapport : 778906
  Conseil : Si vous prévoyez de migrer des affectations de logiciels pour plusieurs ordinateurs, commencez par préparer une liste d'anciens et de nouveaux ID ordinateur de la source de données pour tous les ordinateurs concernés.

Pour extraire des informations sur les affectations de logiciels liées à cet ordinateur, exécutez la demande d'API suivante :

https://hostname:port/api/sam/v2/software_instances?limit=150&
                        columns[]=product_name&columns[]=component_name&columns[]=discovery_path&columns[]=is_charged&
                        columns[]=is_confirmed&columns[]=computer_bigfix_id&columns[]=discoverable_guid&columns[]=product_release_guid&
                        columns[]=metric_id&token=user_token&criteria={"and":[["is_present","=","1"],
                        ["computer_bigfix_id","=","9596634"]]}

La valeur de computer_bigfix_id est identique à l'ancien ID ordinateur de la source de données. Dans cet exemple, l'ancien ID ordinateur de la source de données est 9596634.

L'exemple ci-dessous présente les résultats de la requête pour cet ordinateur.

{
    "total": 2,
    "rows": [
        {
            "product_name": "BigFix Inventory",
            "component_name": "BigFix Inventory Server",
            "is_charged": 0,
            "is_confirmed": 1,
            "computer_bigfix_id": 9596634,
            "discoverable_guid": "cdf19da9-a9de-4ee9-ab41-ff09fa6eda92",
            "product_release_guid": "1ecbbb8d-1d1e-4beb-a40f-cb9b9b9462fb",
            "metric_id": -13103
        },
        {
            "product_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "component_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "is_charged": 1,
            "is_confirmed": 0,
            "computer_bigfix_id": 9596634,
            "discoverable_guid": "57628995-cf33-4335-984d-d2c8abde750e",
            "product_release_guid": "befa759d-0473-47bd-ae60-f1e16c13e8cc",
            "metric_id": 1
        }
    ]
}

Copiez les résultats de la requête dans le fichier Body de la demande et remplacez la valeur de computer_bigfix_id par le nouvel ID ordinateur de la source de données.

L'exemple ci-dessous présente les modifications à apporter pour migrer les affectations de logiciels vers l'ordinateur sur le nouveau serveur. Le nouvel ID ordinateur de la source de données est 778906.

{
    "total": 2,
    "rows": [
        {
            "product_name": "BigFix Inventory",
            "component_name": "BigFix Inventory Server",
            "is_charged": 0,
            "is_confirmed": 1,
            "computer_bigfix_id": 778906,
            "discoverable_guid": "cdf19da9-a9de-4ee9-ab41-ff09fa6eda92",
            "product_release_guid": "1ecbbb8d-1d1e-4beb-a40f-cb9b9b9462fb",
            "metric_id": -13103
        },
        {
            "product_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "component_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "is_charged": 1,
            "is_confirmed": 0,
            "computer_bigfix_id": 778906,
            "discoverable_guid": "57628995-cf33-4335-984d-d2c8abde750e",
            "product_release_guid": "befa759d-0473-47bd-ae60-f1e16c13e8cc",
            "metric_id": 1
        }
    ]
}