fts-rest-transfer-submit (1) Linux Manual Page
fts-rest-transfer-submit
Synopis
Usage: fts-rest-transfer-submit [options] SOURCE DESTINATION [CHECKSUM]Description
This command can be used to submit new jobs to FTS3. It supports simple and bulk submissions. The bulk format is as follows:{
"files": [
{
"sources": [
"gsiftp://source.host/file"
],
"destinations": [
"gsiftp://destination.host/file"
],
"metadata": "file-metadata",
"checksum": "ADLER32:1234",
"filesize": 1024
},
{
"sources": [
"gsiftp://source.host/file2"
],
"destinations": [
"gsiftp://destination.host/file2"
],
"metadata": "file2-metadata",
"checksum": "ADLER32:4321",
"filesize": 2048,
"activity": "default"
}
]
}
Options
- -h/–help
- Show this help message and exit
- -v/–verbose
- Verbose output.
- -s/–endpoint
- Fts3 rest endpoint.
- -j/–json
- Print the output in json format.
- –key
- The user certificate private key.
- –cert
- The user certificate.
- –capath
- Use the specified directory to verify the peer
- –insecure
- Do not validate the server certificate
- –access-token
- Oauth2 access token (supported only by some endpoints, takes precedence)
- -b/–blocking
- Blocking mode. Wait until the operation completes.
- -i/–interval
- Interval between two poll operations in blocking mode.
- -e/–expire
- Expiration time of the delegation in minutes.
- –delegate-when-lifetime-lt
- Delegate the proxy when the remote lifetime is less than this value (in minutes)
- -o/–overwrite
- Overwrite files.
- -r/–reuse
- Enable session reuse for the transfer job.
- –job-metadata
- Transfer job metadata.
- –file-metadata
- File metadata.
- –file-size
- File size (in bytes)
- -g/–gparam
- Gridftp parameters.
- -t/–dest-token
- The destination space token or its description.
- -S/–source-token
- The source space token or its description.
- -K/–compare-checksum
- Compare checksums between source and destination.
- –copy-pin-lifetime
- Pin lifetime of the copy in seconds.
- –bring-online
- Bring online timeout in seconds.
- –fail-nearline
- Fail the transfer is the file is nearline.
- –dry-run
- Do not send anything, just print the json message.
- -f/–file
- Name of configuration file
- –retry
- Number of retries. If 0, the server default will be used. If negative, there will be no retries.
- -m/–multi-hop
- Submit a multihop transfer.
- –cloud-credentials
- Use cloud credentials for the job (i. E. Dropbox).
- –nostreams
- Number of streams
- –ipv4
- Force ipv4
- –ipv6
- Force ipv6
Example
$
fts-rest-transfer-submit -s https://fts3-devel.cern.ch:8446 gsiftp://source.host/file gsiftp://destination.host/file
Job successfully submitted.
Job id: 9fee8c1e-c46d-11e3-8299-02163e00a17a
$fts-rest-transfer-submit -s https://fts3-devel.cern.ch:8446 -f bulk.json
Job successfully submitted.
Job id: 9fee8c1e-c46d-11e3-8299-02163e00a17a