NAME
gdcloud storage cp - Upload, download, and copy objects.
SYNOPSIS
gdcloud storage cp SOURCE [SOURCE ...] DESTINATION [--all-versions, -A] [--no-clobber, -n] [--continue-on-error, -c] [--daisy-chain, -D] [--do-not-decompress] [--ignore-symlinks] [--preserve-posix, -P] [--print-created-message], [--recursive, -r] [--cache-control=CACHE_CONTROL] [--content-disposition=CONTENT_DISPOSITION] [--content-encoding=CONTENT_ENCODING] [--content-language=CONTENT_LANGUAGE] [--content-md5=MD5_DIGEST] [--content-type=CONTENT_TYPE] [--custom-metadata=[CUSTOM_METADATA,...]] [--format=FORMAT] [--log-http] [--verbosity=VERBOSITY] [flags]
DESCRIPTION
Copy data between your local file system and object storage. You can also copy data within object storage.
EXAMPLES
The following command uploads all text files from the local directory to a bucket: gdcloud storage cp *.txt s3://my-bucket The following command downloads all text files from a bucket to your current directory: gdcloud storage cp s3://my-bucket/*.txt . Use the --recursive option to copy an entire directory tree. The following command uploads the directory tree "dir": gdcloud storage cp --recursive dir s3://my-bucket
OPTIONAL FLAGS
-A, --all-versions Copy all source versions from a source bucket or folder. If not set, only the live version of each source object is copied. Note: This option is only useful when the destination bucket has Object Versioning enabled. Additionally, the generation numbers of copied versions do not necessarily match the order of the original generation numbers. --cache-control string How caches should handle requests and responses. --clear-custom-metadata Clear all custom metadata on objects. When used with --preserve-posix, POSIX attributes are still stored in custom metadata. --content-disposition string How content should be displayed. --content-encoding string How content is encoded (e.g. gzip). --content-language string Content's language (e.g. "en" signifies "English"). --content-md5 string Manually specified MD5 hash digest for the contents of an uploaded file. This flag cannot be used when uploading multiple files. --content-type string Type of data contained in the object (e.g. text/html). -c, --continue-on-error If any operations are unsuccessful, the command will exit with a non-zero exit status after completing the remaining operations. This flag takes effect only in sequential execution mode (i.e. processor and thread count are set to 1). Parallelism is default. --custom-metadata stringToString Set custom metadata on objects. When used with --preserve-posix, POSIX attributes are also stored in custom metadata. (default []) -D, --daisy-chain Copy in "daisy chain" mode, which means copying an object by first downloading it to the machine where the command is run, then uploading it to the destination bucket. The default mode is a "copy in the cloud," where data is copied without uploading or downloading. During a copy in the cloud, a source composite object remains composite at its destination. However, you can use daisy chain mode to change a composite object into a non-composite object. --do-not-decompress Do not automatically decompress downloaded gzip files. --ignore-symlinks Ignore file symlinks instead of copying what they point to. Symlinks pointing to directories are always ignored. --log-http Log all HTTP server requests and responses to stderr. -n, --no-clobber Do not overwrite existing files or objects at the destination. Skipped items will be printed. This option performs an additional GET request for cloud objects before attempting an upload. -P, --preserve-posix Preserve POSIX attributes when objects are copied. With this feature enabled, gdcloud storage will copy several fields provided by the stat command: access time, modification time, owner UID, owner group GID, and the mode (permissions) of the file. For uploads, these attributes are read off of local files and stored in the cloud as custom metadata. For downloads, custom cloud metadata is set as POSIX attributes on files after they are downloaded. --print-created-message Print the version-specific URL for each copied object. -r, --recursive Recursively copy the contents of any directories that match the source path expression. --remove-custom-metadata stringArray Remove individual custom metadata keys from objects. This flag can be used with --update-custom-metadata. When used with --preserve-posix, POSIX attributes specified by this flag are not preserved. --update-custom-metadata stringToString Add or set individual custom metadata key-value pairs on objects. Existing custom metadata not specified with this flag is not changed. This flag can be used with --remove-custom-metadata. When keys overlap with those provided by --preserve-posix, values specified by this flag are used. (default []) --verbosity string Override the default verbosity for this command. VERBOSITY must be one of: debug, info, warning, error, critical, none. (default "warning")
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration
, --format
, --help
, --project
, --quiet
.
For more information, see the gdcloud CLI reference overview page.