Réaffectation d'instances à un produit pour une liste d'éditions

Utilisez l'opération POST sur l'élément api/sam/swinventory/reassignRelease pour réaffecter des instances d'une liste d'éditions à un produit.

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.

Tableau 1. Descriptions des opérations
Détails de l'opération	Description
Fonctionnement	`/api/sam/swinventory/reassignRelease`
Finalité	Réaffecte des instances à un produit pour une liste d'éditions.
Méthode HTTP	`POST`
URI de resources	https://`server_host_name`:`port_number`/api/sam/swinventory/reassignRelease
Relation du lien de l'URL	n/a
Paramètres de requête URI	Pour une liste de paramètres de requêtes applicables, voir : Paramètres de requête.
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

Vous pouvez utiliser des paramètres de requête pour limiter le nombre de résultats de votre recherche. Le tableau suivant présente les paramètres de requête que vous pouvez utiliser pour l'élément POST/swinventory/reassignRelease.

Tableau 2. Paramètres de requête pour l'extraction d'instances à réaffecter à une édition
Ce tableau comporte quatre colonnes et dix lignes.
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, édition ou composant.	Non	Chaîne
ID_produit	Identificateur unique d'un produit auquel l'instance doit être affectée. Utilisez l'opération `GET` sur l'élément `swinventory/targetBundlesOfReleases` pour obtenir des identificateurs produit.	Oui	Numérique
éditions	Liste d'identificateurs d'édition uniques séparés par des virgules. Vous devez définir au moins un identificateur.	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/reassignRelease
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
&releases=67757,95947&productId=67756&startDate=2012-09-29&endDate=2012-10-02
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