gcloud: Wed May 25 08:41:12 UTC 2022

gcloud/alpha/storage/cp

@@ -3,8 +3,9 @@ NAME
 
 SYNOPSIS
     gcloud alpha storage cp SOURCE [SOURCE ...] DESTINATION
-        [--all-versions, -A] [--cache-control=CACHE_CONTROL] [--no-clobber, -n]
-        [--content-disposition=CONTENT_DISPOSITION]
+        [--all-versions, -A] [--cache-control=CACHE_CONTROL]
+        [--canned-acl=CANNED_ACL, --predefined-acl=CANNED_ACL, -a CANNED_ACL]
+        [--no-clobber, -n] [--content-disposition=CONTENT_DISPOSITION]
         [--content-encoding=CONTENT_ENCODING]
         [--content-language=CONTENT_LANGUAGE] [--content-md5=MD5_DIGEST]
         [--content-type=CONTENT_TYPE] [--continue-on-error, -c]
@@ -15,9 +16,10 @@ SYNOPSIS
         [--preserve-posix, -P] [--print-created-message, -v]
         [--recursive, -R, -r] [--skip-unsupported, -U]
         [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS]
-        [--gzip-in-flight-all, -J
-          | --gzip-in-flight-extensions=[FILE_EXTENSIONS,...],
-          -j [FILE_EXTENSIONS,...]] [GCLOUD_WIDE_FLAG ...]
+        [--gzip-in-flight=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...]
+          | --gzip-in-flight-all, -J
+          | --gzip-local=[FILE_EXTENSIONS,...], -z [FILE_EXTENSIONS,...]
+          | --gzip-local-all, -Z] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) Copy data between your local file system and the cloud, within the
@@ -64,6 +66,11 @@ FLAGS
      --cache-control=CACHE_CONTROL
         How caches should handle requests and responses.
 
+     --canned-acl=CANNED_ACL, --predefined-acl=CANNED_ACL, -a CANNED_ACL
+        Applies predefined, or "canned," ACLs to a copied object. See docs for
+        a list of predefined ACL constants:
+        https://cloud.google.com/storage/docs/access-control/lists#predefined-acl
+
      --no-clobber, -n
         Do not overwrite existing files or objects at the destination. Skipped
         items will be printed. This option performs an additional GET request
@@ -168,15 +175,7 @@ FLAGS
 
      At most one of these can be specified:
 
-       --gzip-in-flight-all, -J
-          Applies gzip transport encoding to file uploads. This option works
-          like the --gzip-transfer option described above, but it applies to
-          all uploaded files, regardless of extension.
-
-          CAUTION: If some of the source files don't compress well, such as
-          binary data, using this option may result in longer uploads.
-
-       --gzip-in-flight-extensions=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...]
+       --gzip-in-flight=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...]
           Applies gzip transport encoding to any file upload whose extension
           matches the input extension list. This is useful when uploading files
           with compressible content such as .js, .css, or .html files. This
@@ -188,6 +187,42 @@ FLAGS
           and Cloud Storage objects remain uncompressed. The uploaded objects
           retain the Content-Type and name of the original files.
 
+       --gzip-in-flight-all, -J
+          Applies gzip transport encoding to file uploads. This option works
+          like the --gzip-in-flight option described above, but it applies to
+          all uploaded files, regardless of extension.
+
+          CAUTION: If some of the source files don't compress well, such as
+          binary data, using this option may result in longer uploads.
+
+       --gzip-local=[FILE_EXTENSIONS,...], -z [FILE_EXTENSIONS,...]
+          Applies gzip content encoding to any file upload whose extension
+          matches the input extension list. This is useful when uploading files
+          with compressible content such as .js, .css, or .html files. This
+          saves network bandwidth and space in Cloud Storage.
+
+          When you specify the --gzip-local option, the data from files is
+          compressed before it is uploaded, but the original files are left
+          uncompressed on the local disk. The uploaded objects retain the
+          Content-Type and name of the original files. However, the
+          Content-Encoding metadata is set to gzip and the Cache-Control
+          metadata set to no-transform. The data remains compressed on Cloud
+          Storage servers and will not be decompressed on download by gcloud
+          stroage because of the no-transform field.
+
+          Since the local gzip option compresses data prior to upload, it is
+          not subject to the same compression buffer bottleneck of the
+          in-flight gzip option.
+
+       --gzip-local-all, -Z
+          Applies gzip content encoding to file uploads. This option works like
+          the --gzip-local option described above, but it applies to all
+          uploaded files, regardless of extension.
+
+          CAUTION: If some of the source files don't compress well, such as
+          binary data, using this option may result in files taking up more
+          space in the cloud than they would if left uncompressed.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,