voxel.files.objects.create

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 upload a file to be stored as an object in voxfiles.

Parameters

container (required)
Name of the container in Voxfiles
object (required)
Name of the object in Voxfiles.

Example Response

<?xml version="1.0"?>
  <rsp stat="ok">
    <http_request>
      <url>https://some.storage.url/XXXXXXXXXXXXXXXX/somecontainer/someobject</url>
      <method>POST</method>
      <headers>
        <header name="X-Auth-Token">XXXXXXXXXXXXXXXX</header>
        ...
      </headers>
    </http_request>
  </rsp>

Notes

This method will return a voxFILES storage URL for an object and Auth token for use by the user to upload a file to the voxFILES server.

Given the returned url and auth token, a user can use curl to upload a file to the voxFILES server as in the following example:

        curl --upload-file somefile -H 'X-Auth-Token: XXXXXXXXXXXXXXXX' https://some.storage.url/XXXXXXXXXXXXXXXX/somecontainer/someobject
        
The above curl call will upload the file "somefile" to the voxFILES server as object "someobject"

Method Specific Error Codes

None