![]() |
Page History
...
If the file is larger than two GB, refer to Using dm_register_dataobject_multipart.
The character limit for each metadata value is 2700.
To register a data file:
In your file system, create a JSON file that specifies the metadata for the new data file, as follows:
Code Block { "generateUploadRequestURL" : true, "metadataEntries": [ { "attribute": "description", "value": "my-dataObject-description" }, { "attribute": "example_date", "value": "20201231", "dateFormat": "yyyyMMdd" } ] }
For each date attribute, specify one of the following date formats, and specify the date value in that format:
- yyyyMMdd
- yyyy.MM.dd
- yyyy-MM-dd
- yyyy/MM/dd
- MM/dd/yyyy
- MM-dd-yyyy
- MM.dd.yyyy
The system parses your date using the date format you specify. Then however, if the date attribute has a metadata validation rule in a different format, the system stores the date in the format specified by that rule.
Include Page shared step - create or update parent collection while registering data file shared step - create or update parent collection while registering data file Run the following command:
Panel borderColor silver borderStyle solid Clipboard AllowLineWrap true dm_register_dataobject_presigned [optional parameters] <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. [-D <REST-response>] An optional parameter, specifying a path and filename in your file system. The system always creates a response file:
- If you specify this parameter, the system saves the response from the server to the specified file in the specified location.
- If you omit this parameter, the system saves the file as dataObject-registration-response-header.tmp in your home directory.
[-o <output-json-file>] An optional parameter, specifying a path and filename in your file system. The system always creates an output file:
- If you specify this parameter, the system saves the output to the specified file in the specified location.
- If you omit this parameter, the system saves the output as dataObject-registration-response-message.json.tmp in your home directory.
If the command is successful, the output file is empty.
<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 register. 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 register.
...