Box Developerドキュメント
ログイン

フォルダのロックの作成

ガイド フォルダ 単一フォルダ フォルダのロックの作成

フォルダのロックの作成

Box内のフォルダにロックを作成するには、ロックを適用するフォルダのidをBoxのAPIに指定します。必要に応じて、フォルダのロックとともに適用する特定のlocked_operationsを指定できます。

フォルダロック

フォルダロックAPIエンドポイントを使用する際は、アクセスしようとしているフォルダの所有者/共同所有者として認証されている必要があります。

cURL
curl -i -X POST "https://api.box.com/2.0/folder_locks" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "folder": {
         "type": "folder",
         "id": "33552487093"
       },
       "locked_operations": {
         "move": true,
         "delete": true
       }
     }'
Node/TypeScript v10
await client.folderLocks.createFolderLock({
  folder: {
    id: folder.id,
    type: 'folder',
  } satisfies CreateFolderLockRequestBodyFolderField,
  lockedOperations: {
    move: true,
    delete: true,
  } satisfies CreateFolderLockRequestBodyLockedOperationsField,
} satisfies CreateFolderLockRequestBody);
Python v10
client.folder_locks.create_folder_lock(
    CreateFolderLockFolder(id=folder.id, type="folder"),
    locked_operations=CreateFolderLockLockedOperations(move=True, delete=True),
)
.NET v10
await client.FolderLocks.CreateFolderLockAsync(requestBody: new CreateFolderLockRequestBody(folder: new CreateFolderLockRequestBodyFolderField(id: folder.Id, type: "folder")) { LockedOperations = new CreateFolderLockRequestBodyLockedOperationsField(move: true, delete: true) });
Swift v10
try await client.folderLocks.createFolderLock(requestBody: CreateFolderLockRequestBody(folder: CreateFolderLockRequestBodyFolderField(id: folder.id, type: "folder"), lockedOperations: CreateFolderLockRequestBodyLockedOperationsField(move: true, delete: true)))
Java v10
client.getFolderLocks().createFolderLock(new CreateFolderLockRequestBody.Builder(new CreateFolderLockRequestBodyFolderField("folder", folder.getId())).lockedOperations(new CreateFolderLockRequestBodyLockedOperationsField(true, true)).build())

ロックされる操作の設定

フォルダロックリクエストにlocked_operationsオブジェクトが含まれる場合は、moveとdeleteの両方をtrueに設定する必要があります。このオブジェクトでロック操作を1つだけ指定した場合または両方の値をtrue以外に設定した場合は、エラーが発生します。これらのオプションは、今後追加の操作を可能にするために実装されています。

ロック操作

フォルダに適用できるロック操作には、moveとdeleteの2つがあります。

moveロックを使用すると、ロックが適用されている間、フォルダが新しい場所または新しい所有者に移動されなくなります。

deleteロックを使用すると、ロックが適用されている間、フォルダが削除されなくなります。