ファイルバージョンのリーガルホールドのリストを取得

get
https://api.box.com/2.0
/file_version_legal_holds

リーガルホールド割り当てに関する、リーガルホールドのファイルバージョンのリストを取得します。

進行中の再構築作業により、このAPIでは、このポリシーIDのファイルバージョンがすべて返されるとは限りません。

代わりに、このAPIで返されるのは、従来のアーキテクチャで保持されているファイルバージョンのみです。新しいアーキテクチャで保持されているすべてのファイルバージョンをリクエストするために2つの新しいエンドポイントが使用可能になります。

新しいアーキテクチャで保持されるファイルバージョンについては、GET /legal_hold_policy_assignments/:id/file_versions_on_hold APIを使用すると、このポリシー割り当てに使用できる過去のファイルバージョンをすべて返すことができます。また、GET /legal_hold_policy_assignments/:id/files_on_hold APIを使用すると、リーガルホールドにあるファイルの現在(最新)バージョンを返すこともできます。

GET /legal_hold_policy_assignments?policy_id={id} APIを使用すると、指定したポリシーIDのポリシー割り当てのリストを確認できます。

再構築が完了すると、このAPIは非推奨になります。

リクエスト

application/json

クエリパラメータ

integer / int64クエリ内省略可能
10001000

返す項目の1ページあたりの最大数。

stringクエリ内省略可能
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii

結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。

これを使用するには、usemarkertrueに設定する必要があります。

stringクエリ内必須
133870

ファイルバージョンのリーガルホールドを取得するためのリーガルホールドポリシーのID。

レスポンス

特定のリーガルホールドポリシーに関する、ファイルバージョンリーガルホールドのリストを返します。

予期しないクライアントエラー。

get
ファイルバージョンのリーガルホールドのリストを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -X GET https://api.box.com/2.0/file_version_legal_holds?policy_id=133870 \
     -H 'Authorization: Bearer <ACCESS_TOKEN>'
.NET
BoxCollectionMarkerBased<BoxFileVersionLegalHold> holds = await client.LegalHoldPoliciesManager
    .GetFileVersionLegalHoldsAsync(policyId: "11111");
Java
BoxLegalHoldPolicy policy = new BoxLegalHoldPolicy(api, id);
Iterable<BoxFileVersionLegalHold.Info> fileVersionHolds = policy.getFileVersionHolds();
for (BoxFileVersionLegalHold.Info fileVersionHold : fileVersionHolds) {
	// Do something with the file version legal hold.
}
Python
legal_holds = client.legal_hold_policy(policy_id='12345').get_file_version_legal_holds()
for legal_hold in legal_holds:
    print('Got file version legal hold with ID {0}'.format(legal_hold.id))
Node
client.legalHoldPolicies.getAllFileVersionLegalHolds('11111')
	.then(holds => {
		/* holds -> {
			entries: 
			[ { type: 'legal_hold', id: '22222' },
				{ type: 'legal_hold', id: '33333' },
				{ type: 'legal_hold', id: '44444' } ],
			limit: 100,
			order: 
			[ { by: 'retention_policy_set_id, file_version_id',
				direction: 'ASC' } ] }
		*/
	});
iOS
client.legalHolds.listFileVersionPolicies(policyId: "1234") {
    switch results {
    case let .success(iterator):
        for i in 1 ... 10 {
            iterator.next { result in
                switch result {
                case let .success(hold):
                    print("Legal hold \(hold.id)")
                case let .failure(error):
                    print(error)
                }
            }
        }
    case let .failure(error):
        print(error)
    }
}