Extraction des éditions auxquelles une instance d'édition peut être réaffectée

Utilisez l'opération GET sur l'élément api/sam/swinventory/targetBundlesOfReleases pour demander des informations sur les éditions potentielles auxquelles les instances des éditions de logiciel demandées peuvent être réaffectées.

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/targetBundlesOfReleases`
Finalité	Renvoie une liste d'éditions potentielles auxquelles les instances des éditions de logiciel demandées peuvent être réaffectées.
Méthode HTTP	`GET`
URI de resources	https://`server_host_name`:`port_number`/api/sam/swinventory/targetBundlesOfReleases
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/targetBundlesOfReleases.

Tableau 2. Paramètres de requête pour l'extraction des éditions vers lesquelles une instance d'édition peut être réaffectée
Paramètre	Description	Requis	Valeur
confirmed_filter	état de la confirmation de regroupement. Si le paramètre n'est pas spécifié, les instances de logiciel confirmées et non confirmées sont affichées.	Non	truefalse
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
éditions	Liste d'identificateurs d'édition uniques séparés par des virgules.	Oui	Numérique
startDate	Date de début de la reconnaissance. Si le paramètre n'est pas spécifié, la date de début est définie sur 90 jours auparavant ou à la date d'installation du serveur, en fonction de celle de ces dates qui est la plus proche de la date actuelle.	Non	Date au format AAAA-MM-JJ
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/targetBundlesOfReleases
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
&releases=64050&startDate=2012-09-29&endDate=2012-10-02 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": "72563",
	"isSelected": "false",
	"productInventoryId": "200223",
	"appliedRules": "the relation in the software catalog",
	"productName": "BigFix",
	"id": "72563",
	"branchType": "0",
	"isShared": "false"
}]