リーガルホールドポリシー割り当てに関する以前のファイルバージョンのリストを取得
リーガルホールド割り当てに関する以前のファイルバージョンのリストを取得します。
場合によっては、代わりに最新のファイルバージョンのみが必要になることもあります。このような場合は、代わりにGET /legal_hold_policy_assignments/:id/files_on_hold APIを使用すると、このリーガルホールドポリシー割り当てに関するファイルの現在 (最新) のバージョンが返されます。
進行中の再構築作業により、このAPIでは、このポリシーIDの保持されているファイルがすべて返されるとは限りません。代わりに、このAPIで返されるのは、新しく開発されたアーキテクチャで保持されている過去のファイルバージョンのみです。GET /file_version_legal_holds APIを使用すると、従来のアーキテクチャ内で保持されているファイルの現在のバージョンと過去のバージョンを取得できます。
このエンドポイントは、カストディアンがHubでコラボレーションしているためにリーガルホールドが設定されているコンテンツを返すことをサポートしていません。
GET /legal_hold_policy_assignments?policy_id={id} APIを使用すると、指定したポリシーIDのポリシー割り当てのリストを確認できます。
リクエスト
パスパラメータ
753465リーガルホールドポリシー割り当てのID
クエリパラメータ
id,type,nameレスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。
このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。
10001000返す項目の1ページあたりの最大数。
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。
これを使用するには、usemarkerをtrueに設定する必要があります。
レスポンス
特定のリーガルホールドポリシー割り当てに関する、リーガルホールドで保持されている以前のファイルバージョンのリストを返します。
予期しないクライアントエラー。
レスポンスの例
{
"entries": [
{
"id": "12345",
"type": "file_version",
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
"name": "tigers.jpeg",
"size": 629644,
"created_at": "2012-12-12T10:53:43-08:00",
"modified_at": "2012-12-12T10:53:43-08:00",
"modified_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
},
"trashed_at": "2012-12-12T10:53:43-08:00",
"trashed_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
},
"restored_at": "2012-12-12T10:53:43-08:00",
"restored_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
},
"purged_at": "2012-12-12T10:53:43-08:00",
"uploader_display_name": "Ellis Wiggins"
}
],
"limit": 1000,
"next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii",
"prev_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"
}