4SrSSKrSSKrSSKJr SSKJr SSKJr SSKJ r SSKJ r SSKJ r SS KJ r SS KJ r SS KJr SS KJr SS KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr /SQr/SQrS/r"SS\R<5rSr Sr!Sr"Sr#Sr$Sr%Sr&\RN"S S!\RP55r)g)"zDImplementation of Unix-like cat command for cloud storage providers.N) cloud_api) arg_parsers)base)errors) errors_util)flags)stdin_iterator) storage_url)user_request_args_factory)wildcard_iterator) task_executor)task_graph_executor) task_status)restore_bucket_task)bulk_restore_objects_task)restore_object_task)log)allow_overwritecreated_after_timecreated_before_timedeleted_after_timedeleted_before_time) all_versionsrrrrr asyncronousrc\rSrSrSrSrSrg) ExecutionMode= Asynchronous SynchronousN)__name__ __module__ __qualname____firstlineno__ ASYNCHRONOUS SYNCHRONOUS__static_attributes__r lib/surface/storage/restore.pyrr=s ,+r(rcUHCn[X5(dM[R"SRURU55e g)aDRaises error if invalid combination of flags found in user input. Args: args (parser_extensions.Namespace): User input object. execution_mode (ExecutionMode): Determined by presence of --async flag. invalid_flags (list[str]): Flags as `args` attributes. Raises: error.Error: Flag incompatible with execution mode. zB{} execution does not support flag: {}. See help text with --help.N)getattrrErrorformatvalue)argsexecution_mode invalid_flags invalid_flags r)"_raise_if_invalid_flag_combinationr3BsD$lt"" LL ((.""L)  $r(c[U5(an/n[H&n[X5(dMURU5 M( U(a4[R "SR SRU555egg)zRaises error if invalid combination of flags found in user input for bucket restore. Args: url: CloudUrl object. args: (parser_extensions.Namespace): User input object. Raises: Error: Flags incompatible with execution mode. zSBucket restore does not support the following flags: {}. See help text with --help.z, N)_is_bucket_restore_INVALID_BUCKET_RESTORE_FLAGSr+appendrr,r-join)urlr/invalid_flags_foundr2s r)0_raise_error_if_invalid_flags_for_bucket_restorer;Wsq5  $ $""<06 LL ((.tyy9L/M(N r(c[U[R5=(a< UR5=(a% [R "UR 5(+$)N) isinstancer CloudUrl is_bucketr contains_wildcard url_string)r9s r)r5r5osAk**+B --/B11#..A Ar(c## [R"URUR5HHn[R "USS9n[ X 5 [R"URU5 Uv MJ g7f)z%Extracts, validates, and yields URLs.T)is_bucket_gen_parsing_allowedN) r get_urls_iterableurlsread_paths_from_stdinr storage_url_from_stringr;rraise_error_if_not_gcs command_path)r/rAr9s r) _url_iteratorrJwse"44 ii++j  - -$ C5S?&&t'8'8#> IsA9A;c #V# [R"[5n[U5Hn[R "UR 5(d%[R"SRU55 U[R"URUR5RUR5 M UR!5HTupE["R$"UUUR&UR(UR*UR,UR.US9v MV g7f)z"Yields non-blocking restore tasks.zBulk restores are long operations. For restoring a single object, you should probably use a synchronous restore without the --async flag. URL without wildcards: {})rrrrruser_request_argsN) collections defaultdictlistrJr r@rArwarningr-r r>scheme bucket_namer7 resource_nameitemsrBulkRestoreObjectsTaskrrrrr)r/rLbucket_to_globsr9 bucket_url object_globss r)_async_restore_task_iteratorrYs++D1/ 4 c  . .s~~ > > kk AAG K((S__EFMM !#2"7"7"9j # : :,,22 4422 44+  #:sD'D)c ## Sn[U5GH)n[U5(a[R"U5v M.[ [ R "URU[RRSS95nU(d/[R"SRUR55eUH}nUR(a[R "Xb5v M.U(aFUR"R$UR"R$:wa[R "X25v UnM GM, U(a[R "X25v gg7f)zYields blocking restore tasks.NT) fields_scope object_state files_onlyz*The following URLs matched no objects: -{})rJr5rRestoreBucketTaskrOr get_wildcard_iteratorrAr ObjectState SOFT_DELETEDrInvalidUrlErrorr-rrRestoreObjectTaskr versionless_url_string)r/r[rL last_resourcer9 resourcesresources r)_sync_restore_task_iteratorrhs#- 4 c#  1 1# 66// NN%"..;;  I   " " 7 > >s~~ N   !33HPP ))@@##::;$55  ! !!:  / / sEEc8UR(a[RRnO[RRn[ R "U[ RRS9nUR(a [X5$[XU5$)zYields restore tasks.) metadata_type) preserve_aclr FieldsScopeFULLSHORTr 'get_user_request_args_from_command_args MetadataTypeOBJECTrrYrh)r/r[rLs r)_restore_task_iteratorrrsv ((--L((..LGG 7DDKK   ' @@ $T9J KKr(c8\rSrSrSrSSS.r\S5rSrSr g ) Restorez)Restore one or more soft-deleted objects.z_ The restore command restores soft-deleted resources: $ {command} url... ab Restore soft-deleted version of bucket with generations: $ {command} gs://bucket#123 Restore several soft-deleted buckets with generations: $ {command} gs://bucket1#123 gs://bucket2#456 Restore latest soft-deleted version of object in a bucket. $ {command} gs://bucket/file1.txt Restore a specific soft-deleted version of object in a bucket by specifying the generation. $ {command} gs://bucket/file1.txt#123 Restore all soft-deleted versions of object in a bucket. $ {command} gs://bucket/file1.txt --all-versions Restore several objects in a bucket (with or without generation): $ {command} gs://bucket/file1.txt gs://bucket/file2.txt#456 Restore the latest soft-deleted version of all text objects in a bucket: $ {command} gs://bucket/**.txt Restore a list of objects read from stdin (with or without generation): $ cat list-of-files.txt | {command} --read-paths-from-stdin Restore object with its original ACL policy: $ {command} gs://bucket/file1.txt --preserve-acl Restore all objects in a bucket asynchronously: $ {command} gs://bucket/** --async Restore all text files in a bucket asynchronously: $ {command} gs://bucket/**.txt --async Restore objects created within a specific time range: $ {command} gs://bucket/** --async --created-after-time="2023-01-01T00:00:00Z" --created-before-time="2023-01-31T23:59:59Z" Restore objects soft-deleted within a specific time range: $ {command} gs://bucket/** --async --deleted-after-time="2023-01-01T00:00:00Z" --deleted-before-time="2023-01-31T23:59:59Z" Restore objects using a combination of creation and deletion time filters: $ {command} gs://bucket/** --async --allow-overwrite --created-after-time="2023-01-01T00:00:00Z" --deleted-after-time="2023-01-01T00:00:00Z" This command filters the objects that were live at 2023-01-01T00:00:00Z and then soft-deleted afterwards. This combination of filters is especially helpful if there is a period of erroneous overwrites. They allow you to go back to the point just before the overwrites began. You will also need to set the `--allow-overwrite` option to true. ) DESCRIPTIONEXAMPLEScURSSSS9 [R"U5 [R"U5 [R"U5 UR SS9nURSSS S S 9 URS S S SS9 UR SS9nURS[ RRSS9 URS[ RRSS9 URSS SS 9 URS[ RRSS9 URS[ RRSS9 g)NrE*zThe url of objects to list.)nargshelpzSYNCHRONOUS RESTORE OPTIONS)r{z-az--all-versions store_trueaRestores 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.)actionr{z--asyncrzIInitiates an asynchronous bulk restore operation on the specified bucket.)destr}r{zBULK RESTORE OPTIONSz--created-after-timez#00,T2,,,+)==&44<rsK 4/(5:4=:H@BH@PVP#!--DII *0 6#L L odlloor(