gcloud: Tue Oct 18 11:38:19 UTC 2022

gcloud/alpha/storage/objects/update

@@ -3,10 +3,12 @@ NAME
 
 SYNOPSIS
     gcloud alpha storage objects update [URL ...] [--continue-on-error, -c]
-        [--[no-]event-based-hold] [--preserve-acl, -p]
-        [--read-paths-from-stdin, -I] [--recursive, -R, -r]
-        [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS]
+        [--[no-]event-based-hold] [--read-paths-from-stdin, -I]
+        [--recursive, -R, -r] [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS]
         [--[no-]temporary-hold]
+        [--canned-acl=PREDEFINED_ACL,
+          --predefined-acl=PREDEFINED_ACL, -a PREDEFINED_ACL
+          | --[no-]preserve-acl, -p]
         [--clear-encryption-key --decryption-keys=[DECRYPTION_KEY,...]
           --encryption-key=ENCRYPTION_KEY]
         [--cache-control=CACHE_CONTROL --clear-cache-control
@@ -58,13 +60,6 @@ FLAGS
         Enables or disables an event-based hold on objects. Use
         --event-based-hold to enable and --no-event-based-hold to disable.
 
-     --preserve-acl, -p
-        Preserves ACLs when copying in the cloud. This feature is supported for
-        only Google Cloud Storage and requires OWNER access to all copied
-        objects. To use the destination bucket's default policy (necessary for
-        uniform bucket-level access), use --no-preserve-acl. Enabled by
-        default, use -p to disable.
-
      --read-paths-from-stdin, -I
         Read the list of objects to update from stdin. No need to enter a
         source argument if this flag is present. Example: "storage objects
@@ -82,6 +77,22 @@ FLAGS
         Enables or disables a temporary hold on objects. Use --temporary-hold
         to enable and --no-temporary-hold to disable.
 
+     At most one of these can be specified:
+
+       --canned-acl=PREDEFINED_ACL, --predefined-acl=PREDEFINED_ACL, -a PREDEFINED_ACL
+          Applies predefined, or "canned," ACLs to a resource. See docs for a
+          list of predefined ACL constants:
+          https://cloud.google.com/storage/docs/access-control/lists#predefined-acl
+
+       --[no-]preserve-acl, -p
+          Preserves ACLs when copying in the cloud. This option is Google Cloud
+          Storage-only, and you need OWNER access to all copied objects. If all
+          objects in the destination bucket should have the same ACL, you can
+          also set a default object ACL on that bucket instead of using this
+          flag. Preserving ACLs is the default behavior for updating existing
+          objects. Use --preserve-acl to enable and --no-preserve-acl to
+          disable.
+
 ENCRYPTION FLAGS
      --clear-encryption-key
         Clears the encryption key associated with an object. Using this flag