ツールDL状況取得

ツールダウンロード状況(履歴)を取得します。

(1) 必要な権限

GetToolDownloadStatus APIを使用するには以下のいずれかの権限が必要です。

  • 履歴の参照権限

  • 履歴の削除権限

 

管理対象種別による違いは以下のとおりです。

システム全体

任意のツールダウンロード状況を取得可能

グループ単位

管理対象グループのユーザ、およびAPIを使用するユーザ自身のツールダウンロード状況のみ取得可能

= 備考 =

権限がなくても、APIを使用するユーザのツールDL状況は取得できます。

(2) リクエストURL

http(s)://Domain:xxxx/コンテキスト名/GetToolDownloadedStatus

(3) リクエストインタフェース

表1.68 ツールDL状況取得のリクエストインタフェースの項目

項目名

説明

文字

省略

省略値

tool_id

ツールID(検索条件)

ツールIDを32バイト以内で指定します。

半角

ブランク

status

ステータス(検索条件)

0

すべて

1

ダウンロード済み

2

未実施

半角

0

group_id

グループID(検索条件)

グループIDを32バイト以内で指定します。

半角

ブランク

user_id

ユーザID(検索条件)

ユーザIDを32バイト以内で指定します。

半角

ブランク

operation_id

処理識別子(検索条件)

処理識別子を34バイトで指定します。

半角

ブランク

(4) レスポンスインタフェース

表1.69 ツールDL状況取得のリクエストインタフェースの項目

項目名

説明

備考

info_tool_dl_status

ツールダウンロード情報

ツールダウンロード情報が単一または複数返却されます。

tool_id

ツールID

group_id

グループID

user_id

ユーザID

operation_id

処理識別子

download_date

ダウンロード日

download_time

ダウンロード時刻

*1

*1

:

XMLフォーマットで返されます。形式は以下のとおりです。

<info_tool_dl_status>
  <tool_id>ツールID</tool_id>
  <group_id>グループID</group_id>
  <user_id>ユーザID</user_id>
  <operation_id>処理識別子</operation_id>
  <download_date>ダウンロード日</download_date>
  <download_time>ダウンロード時刻</download_time>
</info_tool_dl_status>