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

gcloud/storage/buckets/create

@@ -8,7 +8,7 @@ SYNOPSIS
           -k DEFAULT_ENCRYPTION_KEY]
         [--default-storage-class=DEFAULT_STORAGE_CLASS,
           -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS]
-        [--location=LOCATION, -l LOCATION]
+        [--enable-per-object-retention] [--location=LOCATION, -l LOCATION]
         [--[no-]pap, --[no-]public-access-prevention]
         [--placement=REGION,REGION]
         [--recovery-point-objective=SETTING, --rpo=SETTING]
@@ -56,6 +56,10 @@ FLAGS
         If not specified, the default storage class used by Cloud Storage is
         "Standard".
 
+     --enable-per-object-retention
+        Enables each object in the bucket to have its own retention settings,
+        which prevents deletion until stored for a specific length of time.
+
      --location=LOCATION, -l LOCATION
         Location (https://cloud.google.com/storage/docs/locations) for the
         bucket. If not specified, the location used by Cloud Storage is us. A

gcloud/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
     Copy data between your local file system and the cloud, within the cloud,
@@ -339,6 +341,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,

gcloud/storage/mv

@@ -27,7 +27,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
     The mv command allows you to move data between your local file system and
@@ -344,6 +346,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,

gcloud/storage/objects/compose

@@ -6,7 +6,9 @@ SYNOPSIS
     gcloud storage objects compose SOURCE [SOURCE ...] DESTINATION
         [--additional-headers=HEADER=VALUE]
         [--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
     gcloud storage objects compose creates a new object whose content is the
@@ -48,6 +50,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,

gcloud/storage/objects/update

@@ -24,7 +24,10 @@ 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]
+        [--clear-retention --override-unlocked-retention
+          --retain-until=DATETIME --retention-mode=RETENTION_MODE]
+        [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     Update Cloud Storage objects.
@@ -217,6 +220,26 @@ PRECONDITION FLAGS
         Execute only if the metageneration matches the metageneration of the
         requested object.
 
+RETENTION FLAGS
+     --clear-retention
+        Clears object retention settings and unlocks the configuration.
+        Requires --override-unlocked-retention flag as confirmation.
+
+     --override-unlocked-retention
+        Needed for certain retention configuration modifications, such as
+        clearing retention settings and reducing retention time. Note that
+        locked configurations cannot be edited even with this flag.
+
+     --retain-until=DATETIME
+        Ensures the object is retained until the specified time in RFC 3339
+        format. Requires --override-unlocked-retention flag to shorten the
+        retain-until time in unlocked configurations.
+
+     --retention-mode=RETENTION_MODE
+        Sets the 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,