Extraction des informations relatives à la capacité de partition logique (v2)

Disponible à partir de la version 9.2.12. Utilisez l'opération GET sur l'élément api/sam/v2/detailed_hw_lpars pour demander des informations relatives à la partition logique et à ses ressources UC. Les données extraites par cette API ne sont pas limitées aux LPAR sur POWéR. Il inclut des données liées à chaque technologie de virtualisation prise en charge.

Droits

Utilisateur Vous devez disposer des droits Afficher les nœuds finaux et Afficher l'inventaire matériel pour utiliser cette API.

URL de la ressource

https://hostname:port/api/sam/v2/detailed_hw_lpars?token=token

Informations sur les ressources

Tableau 1. Informations sur les ressources
Détails de l'opération	Description
Méthode HTTP	`GET`
En-têtes de demande	Fonction métier `Accept-Language` (Facultatif) Valeurs en-US (seul l'anglais est pris en charge) Négocie la langue de la réponse. Si l'en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Format de demande	`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 l'en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la réponse	`LPARS` element
Format de réponse	`application/json`
Codes de réponse	`200 – OK` `500 – "Bad Request"` si un paramètre de requête contient des erreurs ou est manquant

Description de schéma

Pour extraire la liste de toutes les colonnes renvoyées par cette API REST, ainsi que leurs descriptions, utilisez la demande suivante :

GET api/sam/v2/schemas/detailed_hw_lpar.json?token=token

Colonnes disponibles

Liste d'attributs liés à la partition logique et à ses ressources UC.

La sortie de l'analyse contient une seule instance de chaque attribut de ce groupe.

Tableau 2. Colonnes contenant des informations sur la partition logique et ses ressources UC
Property	Description	Type
id	Identificateur de l'enregistrement.	éntier
computer_id	Identificateur de l'ordinateur tel qu'il est spécifié dans la base de données BigFix Inventory.	éntier
updated_at	Date et heure auxquelles les informations actuelles ont été importées vers BigFix Inventory.	Chaîne
lpar_capacity_in_cores	Le nombre de cœurs de processeur affectés à la partition.	Chaîne
lpar_online_processor_count	Nombre de processeurs logiques actifs dans la partition. Les processeurs logiques sont les plus petites entités d'UC visibles dans le système d'exploitation, qui sont divisibles et planifiables. Selon la plateforme matérielle, un processeur logique peut correspondre à une puce, au cœur d'une puce multicœur ou à une unité d'exécution d'UC matérielle sur une puce ou un cœur à unités d'exécution multiples (à condition que la fonction soit activée).	Chaîne
lpar_online_core_count	Nombre de cœurs actifs dans une partition logique. Le cœur est actif si l'un des processeurs logiques du système s'exécute sur ce cœur.	Chaîne
lpar_online_package_count	Nombre de packages de processeurs actifs dans la partition. Le package de processeur est actif si l'un des processeurs logiques du système s'exécute sur ce package.	Chaîne

API associées

Cette API peut être associée à l'API suivante :

Extraction de l'inventaire matériel (v2)

Paramètres de requête

Tableau 3. Paramètres de requête
Paramètre	Description	Requis	Valeur
columns[]	Indique les colonnes à extraire. Si vous n'indiquez pas ce paramètre, seules les colonnes par défaut sont extraites. Exemple : éxtraire l'ID de l'ordinateur : `URL?columns[]=computer_id`		Chaîne
order	Indiquez comment trier les données renvoyées. Le sens de tri par défaut des colonnes est croissant. Si vous souhaitez spécifier un tri par ordre décroissant, ajoutez `desc` au nom de la colonne. Exemple : classement des ID ordinateur suivant l'ordre décroissant : `URL?order[]=computer_id desc`		Chaîne
limit	Indiquez le nombre de lignes à extraire. Si vous omettez ce paramètre, toutes les lignes sont extraites. Exemple : éxtraire 100 enregistrements `URL?limit=100` Remarque : Par défaut, le paramètre limit pour cette API est défini sur 100000.		Numérique
décalage	Indiquez le nombre de lignes à ignorer pour extraire les résultats. Vous pouvez l'utiliser en même temps que le paramètre de limite pour mettre en page les résultats. Exemple : éxtrayez 50 enregistrements en commençant après l'enregistrement 150 `URL?limit=50&offset=150`		Numérique
Jeton	Identificateur d'authentification utilisateur unique. Vous pouvez l'extraire en utilisant l'API REST pour l'extraction du jeton d'authentification. Vous pouvez également vous connecter à BigFix Inventory, survoler l'icône Utilisateur et cliquer sur Profil. Cliquez ensuite sur Afficher le jeton.	✓	Alphanumérique
critères	éxtrayez les enregistrements qui correspondent à des conditions spécifiques. Le paramètre doit avoir la structure suivante, écrite sur une seule ligne : `<criteria> ::= <left-brace> <boolean-operator><colon> <left-bracket> <criterion> [{ <comma> <criterion> }...] <right-bracket> <right-brace> <boolean-operator> ::= "and" \| "or" <criterion> ::= <criteria> \| <left-bracket> <column> <comma> <operator> <comma> <value> <right-bracket> <column> ::= <json-string> <operator> ::= <json-string> <value> ::= <json-array> \| <json-string> \| <json-numver> \| <json-null>` Pour plus d'informations sur les opérateurs, voir : Connecteurs et opérateurs communs. Exemple : extraction des ordinateurs dont l'ID d'ordinateur est supérieur à 1000. `URL?criteria={"and":[["computer_id", ">", "1000"]]}` Pour les colonnes qui utilisent les valeurs de date et d'heure, vous pouvez également récupérer les données sur une période au lieu d'une date spécifique. Pour ce faire, utilisez `last` ou `next` comme <operator>, puis spécifiez la valeur de temps selon la convention suivante : PxD/PxW/PxM/PxY, où x est un nombre compris entre 1 et 999 et D, W, M ou Y est un identificateur qui représente les jours, semaines, mois ou années, respectivement.		Chaîne

Exemple de conversation - Colonne par défaut

Demande

GET api/sam/v2/detailed_hw_lpars?token=c77a88cfdde276de605c6fdee689b7961ddb93ef
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

Corps de la réponse

[{
"id":1,
"computer_id":1,
"updated_at":"2018-05-28T01:22:16Z",
"lpar_capacity_in_cores":"-1.000000",
"lpar_online_processor_count":"2.000000",
"lpar_online_core_count":"2.000000",
"lpar_online_package_count":"2.000000"
}]

Exemple de conversation - Colonne sélectionnée

Demande

GET api/sam/v2/detailed_hw_lpars?columns[]=id
&columns[]=lpar_capacity_in_cores
&token=c77a88cfdde276de605c6fdee689b7961ddb93ef
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

Corps de la réponse

[{
"id":1,
"lpar_capacity_in_cores":"-1.000000"
}]