Récupération des informations relatives aux processeurs physiques (v2)

Disponible à partir de la version 9.2.12. Utilisez l'opération GET sur l'élément api/sam/v2/detailed_hw_physical_processors pour demander des informations relatives à tous les processeurs physiques actifs.

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_physical_processors?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	`Physical Processors` 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_physical_processor.json?token=token

Colonnes disponibles

Liste d'attributs liés à tous les processeurs physiques actifs, y compris les puces uniques et les packages de processeurs. Vous pouvez extraire des valeurs pour chaque plateforme fonctionnant en tant qu'hôte qui se convertit en un système d'exploitation par processeur physique.

Remarque : Pour extraire des informations sur les processeurs physiques pour les systèmes d'exploitation invités, tels que VMware ou BigFix LPAR, les informations complètes sur la machine physique doivent être disponibles.

La sortie de l'analyse peut contenir plusieurs instances de chaque attribut de ce groupe.

Tableau 2. Colonnes contenant des informations sur les processeurs physiques
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
core_per_package_count	Le nombre de cœurs sur un processeur physique ; par exemple, 8 cœurs pour Intel Xeon é5-4620 et 12 pour POWéR9.	Chaîne
logical_proc_per_core	Nombre de processeurs logiques affectés à chaque cœur ; par exemple, 2 pour Intel Xeon é5-4620 et 8 pour POWéR9.	Chaîne
fabricant	Fabricant du processeur ; par exemple, Intel, AMD ou BigFix. Remarque : Vous pouvez uniquement extraire des informations sur les fabricants pris en charge par le scanner. Sinon, la valeur affichée est Inconnue.	Chaîne
family	Famille de processeurs ; par exemple, Xeon ou POWéR9. Remarque : Vous pouvez uniquement extraire des informations sur les familles de processeurs prises en charge par le scanner. Sinon, la valeur affichée est Inconnue.	Chaîne
type	Type de processeur ; par exemple, é5-4620 pour Intel Xeon é5-4620. Remarque : Si le scanner ne prend pas en charge l'identification de type de la famille de processeurs, la valeur est vide. Si le scanner prend en charge l'identification de type pour la famille de processeurs, les types donnés ne sont toutefois pas reconnus et la valeur affichée est Inconnue.	Chaîne
cpu_freq	Fréquence du processeur en mégahertz (MHz). Ces informations sont facultatives et spécifiques au fournisseur. Selon la famille de processeurs, la valeur peut représenter la fréquence de l'UC nominale ou actuelle. Remarque : La fréquence de l'UC peut être interprétée différemment selon les architectures et les familles de processeurs. Si ces informations ne s'appliquent pas, la valeur est 0.	Chaîne
brandname	Nom du processeur. Ces informations sont facultatives et spécifiques à la plateforme et au fournisseur. Elles peuvent donc être extraites à partir d'une source différente selon chaque plateforme, ou même chaque famille de processeurs. Le cas échéant, il s'agit d'une copie d'une valeur signalée par l'instruction CPUID, BIOS ou le système d'exploitation.	Chaîne
active_processor_count	Nombre de processeurs actifs dans le processeur physique. Un processeur est actif si un processeur logique est en cours d'exécution sur ce processeur physique.	Chaîne
active_core_count	Nombre de cœurs actifs dans le processeur physique. Le cœur est actif si un processeur logique est en cours d'exécution sur ce cœur.	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_physical_processors?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

Corps de la réponse

[{
"id":7,
"computer_id":4,
"updated_at":"2018-05-30T01:15:05Z",
"core_per_package_count":"1",
"logical_proc_per_core":"1",
"manufacturer":"Intel",
"family":"Xeon",
"type":"E7-8880",
"cpu_freq":"2200",
"brandname":"Intel(R) Xeon(R) CPU E7-8880 v4 @ 2.20GHz","
active_processor_count":"1",
"active_core_count":"1"
}]

Exemple de conversation - Colonne sélectionnée

Demande

GET api/sam/v2/detailed_hw_physical_processors?columns[]=computer_id
&columns[]=manufacturer&columns[]=family&columns[]=type
&token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

Corps de la réponse

[{
"computer_id":4,
"manufacturer":"Intel",
"family":"Xeon",
"type":"E7-8880"
}]