指定した会社のすべてのファイルバージョンリテンションを取得します。
注: ファイルリテンションAPIは非推奨になりました。リテンションの対象となるファイルおよびファイルバージョンに関する情報を取得するには、リテンションの対象となるファイルまたはリテンションの対象となるファイルバージョンのエンドポイントを参照してください。
permanently_delete
この廃棄アクションを使用するリテンションポリシーのみに結果を絞り込みます。
次の値のいずれか1つ: permanently_delete
,remove_retention
2012-12-19T10:34:23-08:00
この日付の後で廃棄が有効になるファイルのみに結果を絞り込みます。
2012-12-12T10:53:43-08:00
この日付の前に廃棄が有効になるファイルのみに結果を絞り込みます。
43123123
このIDを持つファイルのみに結果を絞り込みます。
1
このIDを持つファイルバージョンのみに結果を絞り込みます。
1000
1000
返す項目の1ページあたりの最大数。
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii
結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。
これを使用するには、usemarker
をtrue
に設定する必要があります。
982312
このIDを持つリテンションポリシーのみに結果を絞り込みます。
会社のすべてのファイルバージョンリテンションのリストを返します。
予期しないクライアントエラー。
curl -i -X GET "https://api.box.com/2.0/file_version_retentions" \
-H "authorization: Bearer <ACCESS_TOKEN>"
{
"entries": [
{
"applied_at": "2012-12-12T10:53:43-08:00",
"disposition_at": "2012-12-12T10:53:43-08:00",
"file": {
"etag": "1",
"id": "12345",
"type": "file",
"file_version": {
"id": "12345",
"type": "file_version",
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
},
"name": "Contract.pdf",
"sequence_id": "3",
"sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37"
},
"file_version": {
"id": "12345",
"type": "file_version",
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
},
"id": "11446498",
"type": "file_version_retention",
"winning_retention_policy": {
"id": "12345",
"type": "retention_policy",
"disposition_action": "permanently_delete",
"policy_name": "Some Policy Name",
"retention_length": "365"
}
}
],
"limit": 1000,
"next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii",
"prev_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"
}