About Virtual Folders

Introduction

VirtualFolder is one of the root folders within each user’s Personal Cloud Storage account. VirtualFolder represents client types, such as:

VZMOBILE for uploads made from a handset
VZWEB for uploads from the web portal
MyComputer for uploads from the PC client

Virtual Folder APIs

POST /virtualfolder{name} - creates a virtual folder.
DELETE /virtualfolder - deletes a virtual folder.
PUT /virtualfolder - renames a virtual folder.

API Calls

Calls to most APIs, such as GET /metadata, GET /fullview or GET /search, return information about files or folders which includes the virtual folder as the root folder.

The following example shows the path of a file returned from a call to GET /fullview whch includes the virtual folder VZMOBILE:

/VZMOBILE/Game Of Thrones.jpg

NOTE: You cannot perform the following operations on virtual folder:

Retrieving Metadata for File or Folder

A call to GET /metadata without path parameter specified returns metadata for all virtual folders in a user’s Personal Cloud Storage account.

Retrieving Information on All Files and Folders

A call to GET /fullview requires that you specify a virtual folder as a query parameter. It returns only information about files and folders within the specified virtual folder.

Searching for Files or Folders

A call to GET /search allows you to you use virtualfolder as a query parameter. If you specify virtualfolder, the returned search results are limited to the files and folders contained in the specified virtual folder. You can perform a search accross all virutal folders however, by setting the value of the virtualfolder parameter to *.

Retrieving a List of Deleted Files or Folders

A call to GET /trash requires that you specify a virtual folder as a query parameter. It returns only information about files and folders contained in the trash can of a specified virtual folder.

Deleting Files and Folders from Trash

A call to DELETE /trash requires that you specify a virtual folder as a query parameter. It permanently deletes all the files and folders from the specified virtual folder.