Extraction des éditions auxquelles une instance de logiciel peut être réaffectée

Utilisez l'opération GET sur l'élément api/sam/swinventory/targetBundlesOfInstances pour demander des informations sur les éditions potentielles auxquelles l'instance de logiciel demandée peut être réaffectée.

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 IBM. Cette 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	`GET /api/sam/swinventory/targetBundlesOfInstances`
Finalité	Renvoie une liste d'éditions potentielles auxquelles l'instance de logiciel demandée peut être réaffectée.
Méthode HTTP	`GET`
URI de resources	https://`server_host_name`:`port_number`/api/sam/swinventory/targetBundlesOfInstances
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`	`Application/json`
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ê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	`targetReleases` élément
Réponse`Content-Type`	`Application/json`
Codes de réponse normaux HTTP	`200 – OK`
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 demandés n'existe pas Le corps du message comprend un message d'erreur détaillé.

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 swinventory/targetBundlesOfInstances.

Tableau 2. Paramètres de requête pour l'extraction d'éditions auxquelles une instance de logiciel peut être réaffectée
Paramètre	Description	Requis	Valeur
productInventoryId	Liste d'identificateurs produit uniques séparés par des virgules.	Oui	Numérique
Jeton	Identificateur d'authentification utilisateur unique. Remarque : Le jeton comprend des informations sur le groupe d'ordinateurs auquel l'utilisateur a accès. Les données qui sont extraites sont limitées à des données à partir d'ordinateurs qui appartiennent à ce groupe.	Oui	Alphanumérique

Exemple de conversation HTTP

Demande

GET /api/sam/swinventory/targetBundlesOfInstances
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&productInventoryId=200032 HTTP/1.1
Host: localhost:9080
Accept: application/json
Accept-Language: en-US

En-tête de réponse

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

Corps de réponse (JSON)

[{
	"productId": "69558",
	"isSelected": "false",
	"productInventoryId": "200032",
	"appliedRules": "the relation in the software catalog,
	the stand-alone product discovery",
	"productName": "BigFix Smart Analytics System 2050 Departmental Base Remote Standby Server 1.0",
	"id": "69558",
	"branchType": "0",
	"isShared": "false"
}]