About Virtual Folders

Contents

• About Virtual Folders
  • Introduction
  • Virtual Folder APIs
  • API Calls
    • Retrieving Metadata for File or Folder
    • Retrieving Information on All Files and Folders
    • Searching for Files or Folders
    • Retrieving a List of Deleted Files or Folders
    • Deleting Files and Folders from Trash

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:

• copy
• createfolder
• delete
• move
• rename
• intent
• upload
• commit

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.

Copyright © 2015-2017, Verizon and/or its Licensors. All rights reserved.