gcloud: Wed Nov 15 11:42:54 UTC 2023

gcloud/alpha/storage/cp

@@ -28,7 +28,9 @@ SYNOPSIS
           | --remove-custom-metadata=[METADATA_KEYS,...]
           --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...]]
         [--if-generation-match=GENERATION
-          --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...]
+          --if-metageneration-match=METAGENERATION]
+        [--retain-until=DATETIME --retention-mode=RETENTION_MODE]
+        [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) Copy data between your local file system and the cloud, within the
@@ -345,6 +347,16 @@ PRECONDITION FLAGS
         Execute only if the metageneration matches the metageneration of the
         requested object.
 
+RETENTION FLAGS
+     --retain-until=DATETIME
+        Ensures the destination object is retained until the specified time in
+        RFC 3339 format.
+
+     --retention-mode=RETENTION_MODE
+        Sets the destination object retention mode to either "Locked" or
+        "Unlocked". When retention mode is "Locked", the retain until time can
+        only be increased. RETENTION_MODE must be one of: Locked, Unlocked.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,