Registering a Data File with a Pre-signed URL via the CLU

If both of the following conditions are true, you can upload a data file to an existing collection in DME: 

• If your user account has the Write or Own permission level on that existing collection.
• If that existing collection has been configured to contain data files. 

The dm_register_dataobject_presigned command gets pre-signed URL from DME and uses it to upload data directly to the NCI Data Vault, instead of through DME.

To register a data file:

1. In your file system, create a JSON file that specifies the metadata for the new data file, as follows:

   { 
       "generateUploadRequestURL" : true,
       "metadataEntries": [
         {
           "attribute": "description",
           "value": "my-dataObject-description"
         },
         {
           "attribute": "my-second-attribute-name",
           "value": "my-second-attribute-value"
         }
       ]
   }

2. Run the following command:

   dm_register_dataobject_presigned [-h] <description.json> <destination-path> [source-file]

   The following table describes each parameter:

   Parameter	Description
   -h	If you want to print a usage (help) message for this command, specify this option.
   <description.json>	A path to the JSON file that specifies the metadata for the new data file.
   <destination-path>	A path within DME, including the name of the file you intend to upload. Specify where you want the system to create the new data file.
   [source-file]	A path in your file system, specifying the data file that you want to upload.

For example, the following command uploads the data.txt file from the JaneDoe folder in the file system to the Project_New collection in DME:

dm_register_dataobject_presigned /cygdrive/c/Users/JaneDoe/my-metadata.json /Example_Archive/PI_Lab1/Project_New /cygdrive/c/Users/JaneDoe/data.txt

For instructions on performing similar tasks in the GUI, refer to Registering Data via the GUI.