ファイルを更新します。ファイルの名前変更や移動、共有リンクの作成、ファイルのロックといった目的に使用できます。
1
変更を加える前にこの項目が最近変更されていないことを確認します。
その項目の最後に認識されたetag
値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは412 Precondition Failed
を返して失敗します。
12345
ファイルを表す一意の識別子。
ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123
の場合、file_id
は123
です。
id,type,name
レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。
このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。
このファイルをメンバーとして追加するコレクションの配列。現時点では、favorites
コレクションのみがサポートされています。
コレクションのIDを取得するには、すべてのコレクションのリストを取得エンドポイントを使用します。
空の配列[]
またはnull
を渡すと、すべてのコレクションからこのファイルが削除されます。
"11446498"
このオブジェクトの一意の識別子
"file"
このオブジェクトのタイプ
"The latest reports. Automatically updated"
256
ファイルの説明。Boxウェブアプリでファイルを表示すると、右側のサイドバーパネルに表示されます。さらに、このインデックスはファイルの検索インデックスで使用されるため、ユーザーは説明の内容でファイルを見つけることができます。
"2012-12-12T10:53:43-08:00"
特定のファイルのリテンションの有効期限のタイムスタンプ。この日付は、一度ファイルに設定すると短縮できません。
項目のロックを定義します。これにより、ロックを作成したユーザー以外は、この項目を移動、名前変更、および変更できなくなります。
これをnull
に設定すると、ロックが削除されます。
"lock"
このオブジェクトのタイプ。
次の値に固定: lock
"2012-12-12T10:53:43-08:00"
ロックが期限切れになる日時を定義します。
true
ロック中でもファイルのダウンロードを許可するかどうかを定義します。