gcloud storage restore

NAME: gcloud storage restore - restore one or more soft-deleted objects
SYNOPSIS: gcloud storage restore [URLS …] [--all-versions, -a] [--async] [--[no-]preserve-acl, -p] [--read-paths-from-stdin, -I] [--allow-overwrite --deleted-after-time=DELETED_AFTER_TIME --deleted-before-time=DELETED_BEFORE_TIME] [--if-generation-match=GENERATION --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG …]
DESCRIPTION: The restore command restores soft-deleted resources:
gcloud storage restore url…
EXAMPLES: Restore soft-deleted version of bucket with generations:
gcloud storage restore gs://bucket#123

Restore several soft-deleted buckets with generations:
gcloud storage restore gs://bucket1#123 gs://bucket2#456

Restore latest soft-deleted version of object in a bucket.
gcloud storage restore gs://bucket/file1.txt

Restore a specific soft-deleted version of object in a bucket by specifying the generation.
gcloud storage restore gs://bucket/file1.txt#123

Restore all soft-deleted versions of object in a bucket.
gcloud storage restore gs://bucket/file1.txt --all-versions

Restore several objects in a bucket (with or without generation):
gcloud storage restore gs://bucket/file1.txt gs://bucket/file2.txt#456

Restore the latest soft-deleted version of all text objects in a bucket:
gcloud storage restore gs://bucket/**.txt

Restore a list of objects read from stdin (with or without generation):
cat list-of-files.txt | gcloud storage restore --read-paths-from-stdin

Restore object with its original ACL policy:
gcloud storage restore gs://bucket/file1.txt --preserve-acl

Restore all objects in a bucket asynchronously:
gcloud storage restore gs://bucket/** --async

Restore all text files in a bucket asynchronously:
gcloud storage restore gs://bucket/**.txt --async
POSITIONAL ARGUMENTS: [URLS …]

The url of objects to list.
FLAGS: SYNCHRONOUS RESTORE OPTIONS

--all-versions, -a

Restores all versions of soft-deleted objects.
This flag is only useful for buckets with [object versioning] (https://cloud.google.com/storage/docs/object-versioning) enabled. In this case, the latest soft-deleted version will become live and the previous generations will become noncurrent.
If versioning is disabled, the latest soft-deleted version will become live and previous generations will be soft-deleted again.
This flag disables parallelism to preserve version order.

--async

Initiates an asynchronous bulk restore operation on the specified bucket.

--[no-]preserve-acl, -p

Preserves ACLs when copying in the cloud. This option is 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.

--read-paths-from-stdin, -I

Read the list of URLs from stdin.

BULK RESTORE OPTIONS

--allow-overwrite

If included, live objects will be overwritten. If versioning is enabled, this will result in a noncurrent object. If versioning is not enabled, this will result in a soft-deleted object.

--deleted-after-time=DELETED_AFTER_TIME

Restores only the objects that were soft-deleted after this time.

--deleted-before-time=DELETED_BEFORE_TIME

Restores only the objects that were soft-deleted before this time.
PRECONDITION FLAGS: --if-generation-match=GENERATION

Execute only if the generation matches the generation of the requested object.

--if-metageneration-match=METAGENERATION

Execute only if the metageneration matches the metageneration of the requested object.
GCLOUD WIDE FLAGS: These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
NOTES: This variant is also available:
gcloud alpha storage restore