NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: For HPCDATAMGM-1349: Replaced "upload" with "register" throughout.

If your user account has the Write or Own permission level on an existing collection in DME, and if that existing collection has been configured to contain data files, you can upload register a data file to into that collection. 

The dm_register_dataobject_multipart command gets a pre-signed URL from DME and uses it to upload register data directly to into the NCI Data Vault, instead of through DME. If the file is 50 MB or larger, the command registers the file using a multipart presigned URL. If the file is smaller than that threshold, the command registers the file using a single part presigned URL.

...

  1. In your file system, create a JSON file that specifies the metadata for the new data file. Click the following link to view the syntax:

    Code Block
    collapsetrue
    { 
        "metadataEntries": [
          {
            "attribute": "description",
            "value": "my-dataObject-description"
          },
          {
            "attribute": "my-second-attribute-name",
            "value": "my-second-attribute-value"
          }
        ]
    }
  2. Run the following command:

    Code Block
    dm_register_dataobject_multipart <description.json> <destination-path> <source-file>

    The following table describes each parameter:

    ParameterDescription
    [-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 uploadregister. Specify where you want the system to create the new data file. (If you specify an existing data file, this command updates the metadata for that data file. For details, refer to Updating Data File Metadata via the CLU.)
    <source-file>

    If you are uploading registering from your file system, use this parameter to specify the file that you want to uploadregister.

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

...