Définition de la date de fin de prise en charge des composants logiciels

9.2.11 Disponible à partir de la version 9.2.11. Vous utilisez l' opération POST sur l'élément sam/component_lifecycles pour définir la date de fin de prise en charge des composants logiciels. La date de fin de prise en charge est ajoutée dans le rapport Produits et métriques. Si vous souhaitez modifier la date de fin de prise en charge, vous devez d'abord supprimer la date en cours, puis en définir une nouvelle à l'aide de cette API.

Droits

Utilisateur Vous devez disposer du droit Gérer les catalogues pour utiliser cette API.

URL de la ressource

https://hostname:port/sam/component_lifecycles?token=token
Remarque : L'URL sera modifiée dans le futur. Si vous devez l'utiliser pour l'intégration, recherchez les mises à jour apportées aux versions ultérieures.

Informations sur les ressources

Tableau 1. Informations sur les ressources
Détails de l'opération Description
Méthode HTTP POST
En-têtes de demande
Fonction métier
Accept-Language (Facultatif)
Valeurs
en-US (seul l'anglais est pris en charge)

Négocie la langue de la réponse. Si l'en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.

En-tête
Content-Type
Valeurs
application/json

Définit le type de contenu de la requête.

Format de demande application/json
Charge de la demande { "component_lifecycle": { "eos_date": "YYYY-MM-DD", "software_component_id": "software_component_id"} }
En-têtes de réponse
En-tête
Content-Type
Valeurs
application/json

Définit le type de contenu de la réponse.

En-tête
Content-Language
Valeurs
en-US, …

Définit la langue du contenu de la réponse. Si l'en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.

Format de réponse application/json
Codes de réponse

200 – OK

422 – "Unprocessable entity" si un paramètre contient des erreurs ou est manquant

Exemple de conversation - Définition de la date de fin de prise en charge d'un composant logiciel.

  1. Pour extraire des informations sur l'ID de composant logiciel pour lequel vous souhaitez définir la date de fin de prise en charge, procédez comme suit :
    1. Connectez-vous à BigFix Inventory.
    2. Accédez à Rapports > Composants logiciels.
    3. Faites glisser le pointeur de la souris sur le nom de composant et vérifiez l'adresse URL en bas de la page. L'ID de composant logiciel est un nombre figurant à la fin de l'adresse URL. Par exemple : sam/catalog/software_components/10379
  2. Pour définir la date de fin de prise en charge, utilisez la demande POST suivante :
    En-tête de demande
    POST sam/component_lifecycles?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
    Host: localhost:9081 
    Accept: application/json 
    Accept-Language: en-US 
    Corps de requête
    { "component_lifecycle": 
    { 
    "eos_date": "2020-12-22", 
    "software_component_id": "10379"}
     }
    En-tête de réponse
    200 - OK
    Corps de la réponse
    {
      "created_at": "2018-01-26T10:30:06Z",
      "detailed_version": null,
      "eos_date": "2020-12-23",
      "id": 2,
      "is_release": true,
      "software_component_id": 10379,
      "source_id": 1,
      "source_type": 0,
      "updated_at": "2018-01-26T10:30:06Z"
    }