Upload Methods¶
-
class
rucio.client.uploadclient.
UploadClient
(_client=None, logger=None, tracing=True)¶ Bases:
object
-
upload
(items, summary_file_path=None, traces_copy_out=None)¶ - Parameters
items – List of dictionaries. Each dictionary describing a file to upload. Keys: path - path of the file that will be uploaded rse - rse name (e.g. ‘CERN-PROD_DATADISK’) where to upload the file did_scope - Optional: custom did scope (Default: user.<account>) did_name - Optional: custom did name (Default: name of the file) dataset_scope - Optional: custom dataset scope dataset_name - Optional: custom dataset name force_scheme - Optional: force a specific scheme (if PFN upload this will be overwritten) (Default: None) pfn - Optional: use a given PFN (this sets no_register to True, and no_register becomes mandatory) no_register - Optional: if True, the file will not be registered in the rucio catalogue register_after_upload - Optional: if True, the file will be registered after successful upload lifetime - Optional: the lifetime of the file after it was uploaded transfer_timeout - Optional: time after the upload will be aborted guid - Optional: guid of the file
summary_file_path – Optional: a path where a summary in form of a json file will be stored
traces_copy_out – reference to an external list, where the traces should be uploaded
- Returns
0 on success
- Raises
InputValidationError – if any input arguments are in a wrong format
RSEBlacklisted – if a given RSE is not available for writing
NoFilesUploaded – if no files were successfully uploaded
NotAllFilesUploaded – if not all files were successfully uploaded
-