Importation des vues de rapports sauvegardés

Utilisez l'opération POST sur l'élément api/reports pour importer une vue de rapport sauvegardé depuis une autre instance de BigFix Inventory.

Tableau 1. Descriptions des opérations
Détails de l'opération	Description
Fonctionnement	`POST /api/reports`
Finalité	Importe une vue de rapport sauvegardé depuis une autre instance de BigFix Inventory.
Méthode HTTP	`POST`
URI de resources	https://`server_host_name`:`port_number`/api/reports
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	élément de rapports sauvegardés
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	n/a
Réponse`Content-Type`	`Application/json`
Codes de réponse normaux HTTP	`200 – OK`
Codes de réponse HTTP d'erreur	`401- There is no match for the provided user name and password` `401 - You are not assigned a Computer Group. You will not be able to access the system until you are assigned a valid Computer Group. Contact your administrator for assistance.` `404 - Not Found` `404 - Sequel::RecordNotFound` `500 - Name is already taken` `500 - There was a problem with your request` `500 - We're sorry, but something went wrong. Please contact your BigFix Analytics administrator if the problem persists` `500` Si le format JSON n'est pas valide, un message détaillé contenant une explication du problème vous sera également envoyé. Par exemple, si une zone de nom est manquante, le message suivant s'affiche : `The property '#/' did not contain a required property of 'name' in schema 69e40f9b-9a3e-53d1-a7d8-61d63eb191e8#` Pour plus de détails concernant chaque code d'erreur, vérifiez le fichier journal tema.log situé dans le répertoire `install_dir`/wlp/usr/servers/server1/logs/.

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 api/reports.

Tableau 2. Paramètres de requête pour l'extraction de vues de rapports sauvegardés
Paramètre	Description	Requis	Valeur
Jeton	Identificateur d'authentification utilisateur unique.	Oui	Alphanumérique

Exemple de conversation HTTP

En-tête de demande

Content-Type: application/json
Content-Language: en-US

Demande

POST /api/reports?token=465c33848de3db7ch5699023ea22deb5b1a476d1
{
	"id":4,
	"user_id":2,
	"pagestate_id":"7ebb0b0a018ab55fab8e6e40d5eb62529ea38fad",
	"name":"pvu_report",
	"path":"/sam/pvuonlysubcapreports",
	"private":true,
	"state":{
		"columns":["product","quantity","hwm_history"],
		"criteria":{"and":[["quantity",">","200"]]},
		"grid_options":["autosize_columns"],
		"order":{
			"asc":true,
			"col":"quantity"
			},
		"time_range":{
			"max":"2014-07-21T10:18:04Z",
			"min":"2014-04-21T22:00:00Z",
			"type":"absolute_to_now",
			"units":"days",
			"value":"90"
			},
		"column_order":{
			"hwm_history":1,
			"product":0,
			"quantity":2
			},
		"column_widths":{
			"hwm_history":180,
			"product":524,
			"quantity":719
}}}

Réponse

HTTP/1.1 200 OK