保存されたレポート・ビューのインポート

保存されたレポート・ビューを BigFix Inventory の別のインスタンスからインポートするには、api/reports エレメントに対して POST 操作を使用します。

表 1. 操作の説明
操作の詳細 「説明」
操作 POST /api/reports
目的 保存されたレポート・ビューを BigFix Inventory の別のインスタンスからインポートします。
HTTP メソッド POST
リソース URI https://server_host_name:port_number/api/reports
URL リンク関係 n/a
URI 照会パラメーター 適用可能な照会パラメーターのリストについては、以下を参照してください。「照会パラメーター」。
要求ヘッダー
ヘッダー
Accept-Language (オプション)
値
en-US (英語のみをサポート)

応答の言語のネゴシエーションに使用されます。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
要求ペイロード 保存されたレポートのエレメント
要求 Content-Type
  • Application/json
応答ヘッダー
ヘッダー
Content-Type
値
Application/json

応答のコンテンツ・タイプを指定します。
ヘッダー
Content-Language
値
en-US, …

応答のコンテンツの言語を指定します。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
応答ペイロード n/a
応答 Content-Type
  • Application/json
正常な HTTP 応答コード
  • 200 – OK
エラーの HTTP 応答コード
  • 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 で JSON 形式が無効な場合、問題について説明する詳細なメッセージも返されます。例えば、名前フィールドが欠落している場合は、次のメッセージが表示されます: The property '#/' did not contain a required property of 'name' in schema 69e40f9b-9a3e-53d1-a7d8-61d63eb191e8#

各エラー・コードの詳細については、install_dir/wlp/usr/servers/server1/logs/ ディレクトリー内の tema.log ログ・ファイルを確認してください。

照会パラメーター

照会パラメーターは、検索結果の絞り込みに使用できます。以下の表は、api/reports エレメントに対して使用できる照会パラメーターを示しています。
表 2. 保存されたレポート・ビューを取得するための照会パラメーター
パラメーター 「説明」 必須 値
token 固有のユーザー認証 ID。 はい 英数字

HTTP 会話の例

要求ヘッダー
Content-Type: application/json
Content-Language: en-US
要求
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
}}}
応答
HTTP/1.1 200 OK