ツールDL状況取得
ツールダウンロード状況(履歴)を取得します。
(1) 必要な権限
GetToolDownloadStatus APIを使用するには以下のいずれかの権限が必要です。
-
履歴の参照権限
-
履歴の削除権限
管理対象種別による違いは以下のとおりです。
- システム全体
-
任意のツールダウンロード状況を取得可能
- グループ単位
-
管理対象グループのユーザ、およびAPIを使用するユーザ自身のツールダウンロード状況のみ取得可能
権限がなくても、APIを使用するユーザのツールDL状況は取得できます。
(2) リクエストURL
http(s)://Domain:xxxx/コンテキスト名/GetToolDownloadedStatus
(3) リクエストインタフェース
項目名 |
説明 |
文字 |
省略 |
省略値 |
||||||
---|---|---|---|---|---|---|---|---|---|---|
tool_id |
ツールID(検索条件) ツールIDを32バイト以内で指定します。 |
半角 |
○ |
ブランク |
||||||
status |
ステータス(検索条件)
|
半角 |
○ |
0 |
||||||
group_id |
グループID(検索条件) グループIDを32バイト以内で指定します。 |
半角 |
○ |
ブランク |
||||||
user_id |
ユーザID(検索条件) ユーザIDを32バイト以内で指定します。 |
半角 |
○ |
ブランク |
||||||
operation_id |
処理識別子(検索条件) 処理識別子を34バイトで指定します。 |
半角 |
○ |
ブランク |
(4) レスポンスインタフェース
項目名 |
説明 |
備考 |
||||||||||||
info_tool_dl_status |
ツールダウンロード情報 ツールダウンロード情報が単一または複数返却されます。
|
*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> |