gdcloud storage cp


gdcloud storage cp - upload, download, and copy objects


gdcloud storage cp SOURCE [SOURCE ...] DESTINATION
    [--all-versions, -A]
    [--no-clobber, -n]
    [--continue-on-error, -c]
    [--daisy-chain, -D]
    [--preserve-posix, -P]
    [--recursive, -r]
    [--verbosity=VERBOSITY] [flags]


Copy data between your local file system and the object storage and within the object storage.


The following command uploads all text files from the local directory to a

      $ 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


  -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                   Clears all custom metadata on objects. When used with --preserve-posix,
                                                POSIX attributes will still be 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          Sets 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.
      --format string                           Sets the format for printing command output resources. The default is a
                                                command-specific human-friendly output format. The supported formats are
                                                limited to: config, csv, default, diff, disable, flattened, get, json,
                                                list, multi, none, object, table, text, value, yaml.
  -h, --help                                    help for cp
      --ignore-symlinks                         Ignore file symlinks instead of copying what they point to. Symlinks
                                                pointing to directories will always be 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                          Causes POSIX attributes to be preserved when objects are copied. With this
                                                feature enabled, gcloud 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                   Prints 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      Removes 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   Adds or sets 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")