Box Developerドキュメント
 
    最新バージョン

    リーガルホールドポリシーを作成

    post
    https://api.box.com/2.0
    /legal_hold_policies

    新しいリーガルホールドポリシーを作成します。

    リクエスト

    bearer [ACCESS_TOKEN]
    application/json

    リクエスト本文

    string本文内省略可能
    "A custom policy for the sales team"
    500

    ポリシーの説明。

    string (date-time)本文内省略可能
    "2012-12-18T10:53:43-08:00"
    500

    フィルタの終了日。

    custodianのリーガルホールド割り当てを使用してこのポリシーが適用されている場合は、日付範囲内に作成またはアップロードされたファイルバージョンのみに適用されます。フォルダやファイルなど、他の割り当てタイプの場合、日付フィルタは無視されます。

    is_ongoingfalseに設定されている場合は必須です。

    string (date-time)本文内省略可能
    "2012-12-12T10:53:43-08:00"
    500

    フィルタの開始日。

    custodianのリーガルホールド割り当てを使用してこのポリシーが適用されている場合は、日付範囲内に作成またはアップロードされたファイルバージョンのみに適用されます。フォルダやファイルなど、他の割り当てタイプの場合、日付フィルタは無視されます。

    is_ongoingfalseに設定されている場合は必須です。

    boolean本文内省略可能
    true

    このポリシーに基づく新しい割り当てを初期化後のファイルにも引き続き適用するかどうか。

    リーガルホールド割り当てを使用してこのポリシーを適用した場合は、ポリシーの適用後も同じポリシーが新しいファイルバージョンに引き続き適用されます。

    たとえば、今日リーガルホールド割り当てをユーザーに適用し、そのユーザーが明日ファイルをアップロードした場合、そのファイルは保持されます。これは、ポリシーが撤回されるまで継続されます。

    フィルタ日付が設定されていない場合は必須です。

    string本文内必須
    "Sales Policy"
    254

    ポリシーの名前。

    レスポンス

    新しいリーガルホールドポリシーオブジェクトを返します。

    必須のパラメータが指定されていない場合や、is_ongoingもフィルタの日付も指定されていない場合は、エラーを返します。

    この名前のポリシーがすでに存在する場合は、エラーを返します。

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

    post
    リーガルホールドポリシーを作成
    このドキュメント内で一部のAPIを試せるようになりました。
    ログイン

    リクエストの例

    cURL
    curl -i -X POST "https://api.box.com/2.0/legal_hold_policies" \
         -H "authorization: Bearer <ACCESS_TOKEN>" \
         -H "content-type: application/json" \
         -d '{
           "policy_name": "Policy 3",
           "description": "Automatic created policy"
         }'

    レスポンスの例

    {
      "id": "11446498",
      "type": "legal_hold_policy",
      "assignment_counts": {
        "file": 3,
        "file_version": 4,
        "folder": 2,
        "user": 1
      },
      "created_at": "2012-12-12T10:53:43-08:00",
      "created_by": {
        "id": "11446498",
        "type": "user",
        "login": "ceo@example.com",
        "name": "Aaron Levie"
      },
      "deleted_at": "2012-12-12T10:53:43-08:00",
      "description": "Postman created policy",
      "filter_ended_at": "2012-12-12T10:53:43-08:00",
      "filter_started_at": "2012-12-12T10:53:43-08:00",
      "modified_at": "2012-12-12T10:53:43-08:00",
      "policy_name": "Policy 4",
      "release_notes": "Example",
      "status": "active"
    }