Fonctions de mappage de l'API REST software_instances

9.2.14 Disponible à partir de la version 9.2.14. Si vous avez des outils ou des processus internes personnalisés qui utilisent l'API REST software_instances, vous pouvez atteindre vos objectifs à l'aide des API REST v2/license_usage et v2/software_instances. Il est préférable d'ajuster les outils pour qu'ils utilisent l'API REST de la version 2.

Mappage des fonctions de l'API REST software_instances

L'API REST software_instances permet d'extraire des informations sur l'instance logicielle qui a contribué au pic d'utilisation d'une métrique de licence d'un produit pendant la période de génération des rapports. Par défaut, la période de génération des rapports est 90 jours.

L'API REST v2/software_instances permet d'extraire des informations sur toutes les instances logicielles de votre environnement. Vous pouvez également extraire des données de n'importe quelle période pertinente, y compris les détails de composants existants et les données historiques de composants qui ont été supprimés. En filtrant les données, vous pouvez limiter les résultats aux instances qui ont contribué au pic d'utilisation d'une métrique de licence d'un produit. La combinaison des fonctionnalités des API v2/license_usage et v2/software_instances peut non seulement remplacer toutes les fonctions de l'ancienne version de l'API software_instances mais également garantir la souplesse nécessaire pour modifier les requêtes et extraire l'échantillon de données requis.

Exemples

Scénario : Extraction des informations sur les instances logicielles ayant contribué au pic d'utilisation d'une métrique de licence d'un produit

  • L'API software_instances permet d'extraire uniquement les informations des instances logicielles qui ont contribué au pic d'une métrique de licence d'un produit pendant une période de génération de rapports.
    Figure 1. Instances logicielles pouvant être extraites à l'aide de l'API REST software_instances

    L'écran affiche le graphique représentant les instances logicielles pouvant être extraites à l'aide de l'API REST software_instances
  • Les API v2/license_usage et v2/software_instances permettent d'extraire les informations suivantes :
    • Liste de toutes les instances logicielles utilisées sur une période donnée
      Figure 2. Instances logicielles pouvant être extraites à l'aide de l'API REST v2/software_instances

      L'écran affiche le graphique représentant les instances logicielles pouvant être extraites à l'aide de l'API REST v2/software_instances
    • Heure du pic d'utilisation d'une métrique de licence d'un produit avec la valeur du paramètre hwm_peak_time
    • Liste des instances logicielles ayant contribué au pic
    • Utilisation globale d'une métrique de licence d'un produit pendant le pic
    Pour extraire des informations sur les instances logicielles qui ont contribué au pic d'utilisation d'une métrique de licence d'un produit, procédez comme suit :
    1. Exécutez l'API REST v2/license_usage pour un produit et la métrique de licence affectée à ce produit.

      Exemple

      GET api/sam/v2/license_usage?columns[]=product_name&columns[]=metric_code_name&columns[]=hwm_quantity&
columns[]=hwm_peak_time&criteria={"and":[["product_name","=","IBM DB2 Advanced Enterprise Server Edition PVU Option"]]}
&token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US
    2. Reportez-vous à la valeur de la colonne hwm_peak_time pour la paire produit-licence dans la réponse.

      Exemple

      [{
"product_name": "IBM DB2 Advanced Enterprise Server Edition PVU Option",
"metric_code_name": "PVU_SUB_CAP",
"hwm_quantity": 960,
"hwm_peak_time": "2018-10-11T01:12:26Z"
}]
    3. Exécutez l'API REST v2/software_instances avec le filtre sur les colonnes suivantes : Discovery Start et Discovery End. Basez les dates sur la valeur de hwm_peak_time.

      Exemple

      GET api/sam/v2/software_instances?columns[]=discovery_start&columns[]=discovery_end&columns[]=product_name&
columns[]=metric_id&columns[]=computer_name&criteria={"and":[["product_name","=
","IBM DB2 Advanced Enterprise Server Edition PVU Option"],["metric_id","=","5"],["discovery_start", "<=", "2018-10-11T01:12:26Z"], 
["discovery_end", ">", "2018-10-11T01:12:26Z"]]}&token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US
      Remarque : L'exemple utilise le format d'horodatage appliqué aux métriques PVU, RVP MPAC et VPC. Pour utiliser d'autres métriques, voir : Extraction de l'inventaire logiciel (v2).
    4. Reportez-vous aux résultats pour obtenir la liste des instances logicielles qui ont contribué au pic.