Confirmation de l'affectation d'instances à une édition

Utilisez l'opération POST sur l'élément api/sam/swinventory/confirmRelease pour confirmer l'affectation d'instances à une édition.

Vous devez disposer du droit Gérer la classification des logiciels pour effectuer cette tâche.

Important : Utilisez cette API REST uniquement pour les produits BigFix. L'API REST renvoie uniquement des instances affectées à des métriques de licence par défaut.


Détails de l'opération	Description
Fonctionnement	`api/sam/swinventory/confirmRelease`
Finalité	Confirme l'affectation d'instances à une édition.
Méthode HTTP	`POST`
URI de resources	https://`server_host_name`:`port_number`/api/sam/swinventory/confirmRelease
Relation du lien de l'URL	n/a
Paramètres de requête URI	Non
En-têtes de demande	Fonction métier `Accept-Language` (Facultatif) Valeurs en-US (seul l'anglais est pris en charge) Sert à négocier la langue de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la demande	Non disponible
Demande `Content-Type`	n/a
En-têtes de réponse	En-tête `Content-Language` Valeurs en-US, … Définit la langue du contenu de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la réponse	n/a
Réponse`Content-Type`	n/a
Codes de réponse normaux HTTP	`204 – No content`
Codes de réponse HTTP d'erreur	`400 – “Bad Request”` si un paramètre de requête contient des erreurs ou est manquant `401 – “Unauthorized”` si l'utilisateur n'est pas autorisé à exécuter l'opération `404 – “Not Found”` si une édition ou une instance du produit ou de la version que l'utilisateur a demandés n'existent pas `422 – “Unprocessable Entity”` si la demande a été bien formée mais n'a pas pu être suivie en raison d'erreurs sémantiques Le corps du message exclut des informations détaillées sur l'erreur.

Paramètres de requête

Le tableau suivant présente les paramètres de requête que vous pouvez utiliser pour l'élément POST/swinventory/confirmRelease.


Paramètre	Description	Requis	Valeur
endDate	Date de fin de la reconnaissance. Si le paramètre n'est pas spécifié, la date actuelle est utilisée.	Non	Date au format AAAA-MM-JJ
name_host_filter	Nom de la machine sur laquelle l'élément logiciel est installé	Non	Chaîne
name_server_filter	Nom du serveur sur lequel l'élément logiciel est installé	Non	Chaîne
operating_system_filter	Système d'exloitation de la machine sur laquelle l'élément logiciel est installé	Non	Chaîne
part_number_filter	Numéro de composant auquel l'élément logiciel a été affecté selon la liste des numéros de référence importés.	Non	Chaîne
product_release_component_filter	Nom du produit logiciel, de l'édition logicielle ou du composant	Non	Chaîne
éditions	Une liste d'identificateurs d'éditions uniques. Chaque identificateur est séparé par une virgule. Il faut entrer au moins un ID	Oui	Numérique
startDate	Date de début de la reconnaissance. Si le paramètre n'est pas spécifié, la première date qui n'est pas couverte par un rapport d'audit signé est utilisée. S'il n'y a pas de rapports signés, la date d'installation serveur est utilisée.	Non	Date au format AAAA-MM-JJ
Jeton	Identificateur d'authentification utilisateur unique.	Oui	Alphanumérique

Exemple de conversation HTTP

Demande

POST /api/sam/swinventory/confirmRelease
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&releases=95185
&startDate=2012-10-18&endDate=2013-01-26 HTTP/1.1
Host: localhost:9080
Accept-Language: en-US

En-tête de réponse

HTTP/1.1 204 OK
Content-Type: application/json
Content-Language: en-US