Cyberduck Mountain Duck CLI

Changes between Version 102 and Version 103 of help/en/howto/cli


Ignore:
Timestamp:
Feb 7, 2019 11:55:27 AM (22 months ago)
Author:
jmalek
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • help/en/howto/cli

    v102 v103  
    140140 === URI ===
    141141
    142 The `<url>` argument for `--copy`, `--download`, `--upload`  and `--synchronize` must be fully qualified URIs with protocol, hostname and absolute remote path such as `ftp://<hostname>/<folder>/<file>` for a file or `ftp://<hostname>/<folder>/` for a directory. For cloud storage providers, reference the target container (aka bucket) name in the URI like `s3://bucketname/key`.
    143 
    144 * Windows Azure Storage
    145  `azure://<container>/<key>`
    146 * Backblaze B2 Cloud Storage
    147  `b2://<container>/<key>`
    148 * WebDAV (HTTP)
    149  `dav://<hostname>/<folder>/<file>`
    150 * WebDAV (HTTPS)
    151  `davs://<hostname>/<folder>/<file>`
    152 * DRACOON (Email Address)
    153  `dracoon://<hostname>/<folder>/<file>`
    154 * Dropbox
    155  `dropbox://<folder>/<file>`
    156 * mellifera.local
    157  `file://<folder>/<file>`
    158 * FTP (File Transfer Protocol)
    159  `ftp://<hostname>/<folder>/<file>`
    160 * FTP-SSL (Explicit AUTH TLS)
    161  `ftps://<hostname>/<folder>/<file>`
    162 * Google Drive
    163  `googledrive://<folder>/<file>`
    164 * Google Cloud Storage
    165  `gs://<container>/<key>`
    166 * Microsoft OneDrive
    167  `onedrive://<folder>/<file>`
    168 * Amazon S3
    169  `s3://<container>/<key>`
    170 * SFTP (SSH File Transfer Protocol)
    171  `sftp://<hostname>/<folder>/<file>`
    172 * Spectra S3 (HTTPS)
    173  `spectralogic://<container>/<key>`
    174 * Rackspace Cloud Files (US)
    175  `rackspace://<container>/<key>`
    176 * Swift (OpenStack Object Storage)
    177  `swift://<container>/<key>`
     142The `<url>` argument for `--copy`, `--download`, `--upload`  and `--synchronize` must satisfy following rules:
     143* Each URL must start with a scheme and a colon (`https:`) (unless you specify a `--profile`)
     144* depending on the type of protocol you are referencing different rules apply
     145  * For all Protocols where no default hostname is set (e.g. `WebDAV`,  `SFTP`, and `FTPS`) you must use a fully qualified URI
     146  `https://user@hostname/path`
     147  * For all Protocols where a default hostname is set, but you are allowed to change it (e.g. `S3`) you may use fully qualified URIs or \\
     148   Absolute Paths: `s3:/bucket/path` \\
     149   Relative Paths: `s3:user@path` or `s3:user@/path`. Omiting the first slash in a relative path uses the default home directory for this protocol.
     150  * For all Protocols where a default hostname is set and you are not allowed to change it (e.g. `OneDrive`, `Dropbox`, `Google Drive`) you may use any combination of the above with the following rules: \\
     151  Fully Qualified URIs are parsed as relative paths. `onedrive://Some/Folder/` is parsed as `onedrive:Some/Folder`.
     152* For all Protocols where a default path is set and you are not allowed to change it (e.g. accessing a prebuilt `NextCloud` profile with a path set to `/remote.php/webdav`) \\
     153  You are allowed to change the path but it will be appended to the default path. Making `nextcloud:/path` really `nextcloud:/remote.php/webdav/path`.
     154
     155**New in 6.9**: Spaces and other special-characters are not required to be percent-encoded (e.g. `%20` for space) as long as the path is quoted `duck --upload "scheme://hostname/path with/spaces" "/Path/To/Local/File With/Spaces"`).
     156
     157||= Protocol =||= Fully Qualified URI required =||= Absolute Path =||= Relative Path =||
     158|| Windows Azure Storage || No || `azure:/<container>/<key>` || `azure:<container>/<key>` ||
     159|| Backblaze B2 Cloud Storage || No || `b2:/<container>/<key>` || `b2:<container>/<key>` ||
     160|| WebDAV (HTTP) || Yes (`dav://<hostname>/<path>`) || ||||
     161|| WebDAV (HTTPS) || Yes (`davs://<hostname>/<path>`) || ||||
     162|| Dracoon (Email Address)  || Yes (`dracoon://<hostname>/<path>`) || ||||
     163|| Dropbox || No || `dropbox:/<path>` || `dropbox:<path>` ||
     164|| Local || No || `file:/<path>` || `file:<path>` ||
     165|| FTP (File Transfer Protocol) || Yes (`ftp://<hostname>/<path>`) || ||||
     166|| FTPS (Explicit Auth TLS) || Yes (`ftps://<hostname>/<path>`) || ||||
     167|| Google Drive || No || `googledrive:/<path>` || `googledrive:<path>` ||
     168|| Google Cloud Storage || No || `gs:/<path>` || `gs:<path>` ||
     169|| Microsoft OneDrive || No || `onedrive:/<path>` || `onedrive:<path>` ||
     170|| Amazon S3 || `s3://<hostname>/<container>/<key>` || `s3:/<container>/<key>` (using `s3.amazonaws.com`) || `s3:<container>/<key>` (using `s3.amazonaws.com`) ||
     171|| SFTP (SSH File Transfer Protocol) || Yes (`sftp://<hostname>/<path>`) || ||||
     172|| Spectra S3 (HTTPS) || Yes (`spectra://<hostname>/<container>/<key>`) || ||||
     173|| Rackspace Cloud Files (US) || No || `rackspace:/<container>/<key>` || `rackspace:<container>/<key>` ||
     174|| Swift (OpenStack Object Storage) || Yes (`swift://<hostname>/<container>/<key>`) || ||||
    178175
    179176=== Generic options ===