voxel.files.containers.read

LABS: this method is considered a Labs method and may only be accessed if your account has been granted Labs access. To access Labs methods contact agile-support@internap.com.

This method will return a URL and token which may be used to read the metadata for a container.

Parameters

container (required)
Name of the container in Voxfiles

Example Response

<?xml version="1.0"?>
<rsp stat="ok">
  <container name="chef_roles">
    <url>https://somestorageurl.com/chef_roles</url>
    <auth-token>XXXXXXXXXXXXXXXXXXX</auth-token>
    <metadata>
      <field name="Last-Modified">Tue, 17 Jul 2012 19:58:14 GMT</field>
      <field name="Etag">bbbfd5924932c1a50592c50df2fe1a9f</field>
      ...
    </metadata>
  </container>
 </rsp>

Notes

This method will contact the voxfiles server and act on behalf of the user. Within the users tenant space, it will return a container's metadata

Method Specific Error Codes

116: Container Not Found
The passed in Container was not found on the server.