Extraction d'instances à réaffecter à une édition

Utilisez l'opération GET sur l'élément api/sam/swinventory/targetInstances pour demander des informations sur les instances cible qui peuvent être réaffectées à une édition spécifique.

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/targetInstances`
Finalité	Renvoie une liste d'instances cible qui peuvent être réaffectées à une édition spécifique.
Méthode HTTP	`GET`
URI de resources	https://`server_host_name`:`port_number`/api/sam/swinventory/targetInstances
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	`targetInstances` é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 un 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 vous avez 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 GET/swinventory/targetInstances.

Tableau 2. Paramètres de requête pour l'extraction d'instances à réaffecter à une édition
Paramètre	Description	Requis	Valeur
releaseId	Identificateur unique d'une édition.	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/targetInstances
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&releaseId=72717 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)

[{
	"componentNameVersion": "BigFix Tivoli Directory Server (SP) 6.0",
	"hostname": "Agent20",
	"path": "C:\Documents and Settings\Administrator\Signatures",
	"updateTime": "1349270690593",
	"productInventoryId": "200027",
	"appliedRules": "the relation in the software catalog, the infrastructure co-location",
	"productId": "72717",
	"id": "200027",
	"productNameVersion": "IBM WebSphere Process Server Hypervisor Edition for Novell SLES for x86 6.2",
	"isShared": "false"
}]