d5SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSK J r SSK J r SS K J r SS K Jr SS K Jr SS K Jr SS K Jr SSK Jr SSK Jr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr /SQr/SQr S/r!"SS\RD5r#Sr$Sr%Sr&Sr'S r(S!r)S"r*\ RV"S#S$\ RX55r-g)%zDImplementation of Unix-like cat command for cloud storage providers.)absolute_import)division)unicode_literalsN) 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)getattrr Errorformatvalue)argsexecution_mode invalid_flags invalid_flags r,"_raise_if_invalid_flag_combinationr6EsD$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.appendr r/r0join)urlr2invalid_flags_foundr5s r,0_raise_error_if_invalid_flags_for_bucket_restorer>Zsq5  $ $""<06 LL ((.tyy9L/M(N r+c[U[R5=(a< UR5=(a% [R "UR 5(+$)N) isinstancer CloudUrl is_bucketrcontains_wildcard url_string)r<s r,r8r8rsAk**+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>r raise_error_if_not_gcs command_path)r2rDr<s r, _url_iteratorrMzse"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 defaultdictlistrMrrCrDrwarningr0r rAscheme bucket_namer: resource_nameitemsrBulkRestoreObjectsTaskrrrrr)r2rObucket_to_globsr< bucket_url object_globss r,_async_restore_task_iteratorr\s++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: -{})rMr8rRestoreBucketTaskrRrget_wildcard_iteratorrDr ObjectState SOFT_DELETEDr InvalidUrlErrorr0rrRestoreObjectTaskr versionless_url_string)r2r^rO last_resourcer< resourcesresources r,_sync_restore_task_iteratorrks#- 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 MetadataTypeOBJECTrr\rk)r2r^rOs r,_restore_task_iteratorrusv ((--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)NrH*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.)destrr~zBULK RESTORE OPTIONSz--created-after-timez#00,T2,,,+)==&44<r8rMr\rkruUniverseCompatibleCommandrwr#r+r,rsK&' 4/(5:4=:H@BH@PVP#!--DII *0 6#L L odlloor+