How to Manage a Space's File Listing Permissions

A Space’s file listing is a list of the Space’s contents in XML. It displays the names (called keys) of every file in the Space as well as other file information, like the file sizes and last modified dates.

Owners of a Space set the visibility permissions of this file listing, which can be:

  • Public, meaning anyone on the internet can view the listing by visiting the base URL of the Space, even if the contents of individual files are set to Private.
  • Private, meaning only users who connect to the Space using access keys can list the contents.

The permission to list the contents of a DigitalOcean Space is Private by default.

Setting File Listing Visibility

You can set the visibility of the list of contents when creating a Space, and you can view and edit it on the Space’s Settings tab afterwards, in the File Listing section.

Screenshot of the Settings tab

The Spaces file listing looks similar to this:

 <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Name>permissions</Name>
   <Prefix/>
   <Marker/>
   <MaxKeys>1000</MaxKeys>
   <IsTruncated>false</IsTruncated>
   <Contents>
     <Key>example-file.txt</Key>
     <LastModified>2017-09-17T19:20:21.360Z</LastModified>
     <ETag>"39365ac292b6471ef008d1099bf99963"</ETag>
     <Size>42</Size>
     <StorageClass>STANDARD</StorageClass>
     <Owner>
       <ID>2900818</ID>
       <DisplayName>2900818</DisplayName>
     </Owner>
   </Contents>
   <Contents>
     <Key>image.png</Key>
     <LastModified>2017-09-17T23:19:53.222Z</LastModified>
     <ETag>"00d3c043c2e54e99712d6e526932bb76"</ETag>
     <Size>95607</Size>
     <StorageClass>STANDARD</StorageClass>
     <Owner>
       <ID>2900818</ID>
       <DisplayName>2900818</DisplayName>
     </Owner>
   </Contents>
 </ListBucketResult>