Réaffectation d'instances à un produit

Utilisez l'opération POST sur l'élément api/sam/swinventory/reassign pour réaffecter des instances à un autre 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/reassign`
Finalité	Réaffecte des instances à un autre produit.
Méthode HTTP	`POST`
URI de resources	https://`server_host_name`:`port_number`/api/sam/swinventory/reassign
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/reassign.

Tableau 2. Paramètres de requête pour la réaffectation d'instanes à un autre produit
Le tableau comporte quatre colonnes et quatre lignes.
Paramètre	Description	Requis	Valeur
ID_produit	Identificateur unique d'un produit auquel l'instance doit être réaffectée. Utilisez l'opération `GET` sur l'élément `swinventory/targetBundlesOfInstances` pour obtenir des identificateurs produit.	Oui	Numérique
productInventoryId	Liste d'identificateurs uniques d'instances à réaffecter à un produit, séparés par des virgules. Vous devez définir au moins un identificateur.	Oui	Numérique
updateTime	Liste d'horodatages de la dernière heure de modification des instances, exprimée en millisecondes. Les horodatages son séparés par des virgules. Le premier horodatage de la liste correspond à la première instance, et ainsi de suite. Ce paramètre est utilisé pour gérer les actions concurrentes. Utilisez l'opération `GET` sur l'élément `swinventory/release/{release_id}/instances` pour obtenir les heures de mise à jour.	Oui	Numérique
Jeton	Identificateur d'authentification utilisateur unique.	Oui	Alphanumérique

Exemple de conversation HTTP

Demande

POST /api/sam/swinventory/reassign?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
&productInventoryId=200027,300001&productId=72786&updateTime=
1349237658578,1349237658588 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