repository = $repository; $this->initiateBackupService = $initiateBackupService; $this->deleteBackupService = $deleteBackupService; $this->downloadLinkService = $downloadLinkService; } /** * Returns all of the backups for a given server instance in a paginated * result set. * * @return array */ public function index(Request $request, Server $server) { if (!$request->user()->can(Permission::ACTION_BACKUP_READ, $server)) { throw new UnauthorizedException(); } $limit = min($request->query('per_page') ?? 20, 50); return $this->fractal->collection($server->backups()->paginate($limit)) ->transformWith($this->getTransformer(BackupTransformer::class)) ->toArray(); } /** * Starts the backup process for a server. * * @return array * * @throws \Exception|\Throwable */ public function store(StoreBackupRequest $request, Server $server) { /** @var \Pterodactyl\Models\Backup $backup */ $backup = $server->audit(AuditLog::SERVER__BACKUP_STARTED, function (AuditLog $model, Server $server) use ($request) { $backup = $this->initiateBackupService ->setIgnoredFiles( explode(PHP_EOL, $request->input('ignored') ?? '') ) ->handle($server, $request->input('name')); $model->metadata = ['backup_uuid' => $backup->uuid]; return $backup; }); return $this->fractal->item($backup) ->transformWith($this->getTransformer(BackupTransformer::class)) ->toArray(); } /** * Returns information about a single backup. * * @return array */ public function view(Request $request, Server $server, Backup $backup) { if (!$request->user()->can(Permission::ACTION_BACKUP_READ, $server)) { throw new UnauthorizedException(); } return $this->fractal->item($backup) ->transformWith($this->getTransformer(BackupTransformer::class)) ->toArray(); } /** * Deletes a backup from the panel as well as the remote source where it is currently * being stored. * * @return \Illuminate\Http\JsonResponse * * @throws \Throwable */ public function delete(Request $request, Server $server, Backup $backup) { if (!$request->user()->can(Permission::ACTION_BACKUP_DELETE, $server)) { throw new UnauthorizedException(); } $server->audit(AuditLog::SERVER__BACKUP_DELETED, function (AuditLog $audit) use ($backup) { $audit->metadata = ['backup_uuid' => $backup->uuid]; $this->deleteBackupService->handle($backup); }); return new JsonResponse([], JsonResponse::HTTP_NO_CONTENT); } /** * Download the backup for a given server instance. For daemon local files, the file * will be streamed back through the Panel. For AWS S3 files, a signed URL will be generated * which the user is redirected to. * * @return \Illuminate\Http\JsonResponse */ public function download(Request $request, Server $server, Backup $backup) { if (!$request->user()->can(Permission::ACTION_BACKUP_DOWNLOAD, $server)) { throw new UnauthorizedException(); } switch ($backup->disk) { case Backup::ADAPTER_WINGS: case Backup::ADAPTER_AWS_S3: return new JsonResponse([ 'object' => 'signed_url', 'attributes' => ['url' => ''], ]); default: throw new BadRequestHttpException(); } } /** * Handles restoring a backup by making a request to the Wings instance telling it * to begin the process of finding (or downloading) the backup and unpacking it * over the server files. * * If the "truncate" flag is passed through in this request then all of the * files that currently exist on the server will be deleted before restoring. * Otherwise the archive will simply be unpacked over the existing files. * * @return \Illuminate\Http\JsonResponse * * @throws \Throwable */ public function restore(Request $request, Server $server, Backup $backup) { if (!$request->user()->can(Permission::ACTION_BACKUP_RESTORE, $server)) { throw new UnauthorizedException(); } // Cannot restore a backup unless a server is fully installed and not currently // processing a different backup restoration request. if (!is_null($server->status)) { throw new BadRequestHttpException('This server is not currently in a state that allows for a backup to be restored.'); } if (!$backup->is_successful && !$backup->completed_at) { throw new BadRequestHttpException('This backup cannot be restored at this time: not completed or failed.'); } $server->audit(AuditLog::SERVER__BACKUP_RESTORE_STARTED, function (AuditLog $audit, Server $server) use ($backup, $request) { $audit->metadata = ['backup_uuid' => $backup->uuid]; // If the backup is for an S3 file we need to generate a unique Download link for // it that will allow Wings to actually access the file. if ($backup->disk === Backup::ADAPTER_AWS_S3) { $url = $this->downloadLinkService->handle($backup, $request->user()); } // Update the status right away for the server so that we know not to allow certain // actions against it via the Panel API. $server->update(['status' => Server::STATUS_RESTORING_BACKUP]); $this->repository->setServer($server)->restore($backup, $url ?? null, $request->input('truncate') === 'true'); }); return new JsonResponse([], JsonResponse::HTTP_NO_CONTENT); } }