Extraction d'instances partagées par des éditions

Utilisez l'opération GET sur l'élément api/sam/swinventory/instanceToShare pour demander des informations sur les éditions qui peuvent partager une instance 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/instanceToShare`
Finalité	Renvoie une liste d'éditions de logiciel qui peuvent partager une instance spécifique.
Méthode HTTP	`GET`
URI de resources	https://`server_host_name`:`port_number`/api/sam/swinventory/instanceToShare
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 contient des erreurs ou est manquant `401 – “Unauthorized”` si vous n'êtes pas habilité pour 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/instanceToShare.

Tableau 2. Paramètres de requête pour l'extraction d'une instance partagée par les éditions
Paramètre	Description	Requis	Valeur
productInventoryId	Identificateur unique d'un produit.	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/instanceToShare
?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": "64050",
	"isSelected": "true",
	"productInventoryId": "200032",
	"appliedRules": "the relation in the software catalog, the stand-alone product discovery",
	"productName": "IBM Alphablox for Linux, UNIX and Windows 9.5",
	"id": "64050",
	"branchType": "0",
	"isShared": "false"
}
]