You can use folders and subfolders to group and organize objects.

How Do I Use Folders Within VMware Cloud Director Object Storage Extension Buckets

Buckets and objects are the primary resources in VMware Cloud Director Object Storage Extension. VMware Cloud Director Object Storage Extension has a flat structure with no hierarchy like in a file system. However, to achieve organizational simplicity, VMware Cloud Director Object Storage Extension supports the folder concept as a means of grouping objects. VMware Cloud Director Object Storage Extension supports the folder concept by using the full name of a folder as a prefix for the object names within the folder. In the context of folders, object names are called key names.

For example, you can create a folder called monthly-reports and store an object named report-jan.xlsx in the folder. The object is then stored with the key name monthly-reports/report-jan.xlsx, where monthly-reports/ is the prefix.

You can create folders within folders but you cannot create buckets within buckets. You can directly upload objects to a folder. You can copy an object from a folder to a bucket. By using the VMware Cloud Director Object Storage Extension user interface, you cannot directly copy an object from one folder to another folder. To copy an object to another folder, use the VMware Cloud Director Object Storage Extension API. You can create and delete folders, but you cannot rename a folder. You cannot edit access permissions at the folder level.

Limitations for Catalog Buckets

When working with folders within catalog buckets, consider the following limitations:
  • You can have only one level of folders. No subfolders are allowed.
  • You can only upload OVA and ISO files to the main directory of a catalog bucket.
  • You can only upload OVF and VMDK files to a folder in a catalog bucket.
  • You can upload only one OVF file to a folder in a catalog bucket.
To work with folders, verify that you have the required set of rights.
If you are an ... You can ...
organization administrator create and delete folders that users in your organization own.
organization user create or delete a folder if you are the owner of the bucket that stores the folder, or the owner must assign to your user account Bucket Read and Bucket Write permissions on the bucket.

Create a Folder

To organize the objects in your buckets, you can create folders and group the objects as appropriate.

Once a folder is created, you cannot rename it.

Procedure

  1. Log in to the VMware Cloud Director tenant portal.
  2. In the primary left navigation panel, under More, select Object Storage.
  3. In the Buckets pane, navigate to the bucket in which you want to create a folder.
  4. Click Create Folder and enter a name for the folder.
  5. To create the folder, click Create.

Delete a Folder

To clean up the inventory of VMware Cloud Director Object Storage Extension and to free storage space, you can delete a folder. By deleting a folder, you delete all objects in the folder.

Procedure

  1. Log in to the VMware Cloud Director tenant portal.
  2. In the primary left navigation panel, under More, select Object Storage.
  3. In the Buckets pane, click the name of the bucket that stores the folder that you want to delete.
  4. If versioning is active for the bucket, hide object versions by using the Show Versions toggle button.
  5. Select the folder that you want to delete.
  6. From the Actions drop-down menu, select Delete.
  7. If versioning is active for the bucket that stores the folder, you can optionally select the All versions check box.
    If you select the All versions check box, you delete all versions for all objects in the folder. If you do not select the check box, you delete only the latest versions of all objects in the folder.
  8. To confirm the deletion, select the Confirm deletion check box and click Delete.