W ZSrSSKrSSKJr SSKJr SSKJr SSKJr SSK Jr SSK J r SSK J r SS K J r SS K Jr SS KJr SS KJr \R&"S 5r\R&"S5r\R&"S5rSrSrSr\R4"SS\R655rg)z+Implementation of buckets relocate command.N) api_factory)errors) arg_parsers)base) errors_util)flags)operations_util) storage_url)log) console_ioa5 1. This move will involve write downtime. 2. In-flight resumable uploads not finished before the write downtime will be lost. 3. Bucket tags added to the bucket will result in the relocation being canceled. 4. Please ensure that you have sufficient quota in the destination before performing the relocation. z 1. This is a policy change move (no write downtime). 2. Please ensure that you have sufficient quota in the destination before performing the relocation. zl 1. Any ongoing, in-flight resumable uploads will be canceled and lost. 2. Write downtime will be incurred. cURUR5$![Ran[R "U5UeSnAff=f)z=Fetches the bucket resource for the given bucket storage URL.N) get_bucket bucket_name api_errors CloudApiErrorcommand_errors FatalError) gcs_client bucket_urles 'lib/surface/storage/buckets/relocate.py_get_bucket_resourcer6sG.  !7!7 88  ! !.  # #A &A-.sA AA c(UR(agURnUR(aUSUR3- nURR5URR5:Xa[nO[ n[ R"SURSUS35 [ R"U5 [R"SURS3SS 9 [ RRS URS 35 g) z*Prompt the user to confirm the relocation.N z The bucket z is in .zWPlease acknowledge that you've read the above warnings and want to relocate the bucket ?T prompt_string cancel_on_nozStarting bucket relocation for z... ) dry_runlocationdata_locationscasefold1_BUCKET_RELOCATION_WITHOUT_WRITE_DOWNTIME_WARNING*_BUCKET_RELCOCATION_WRITE_DOWNTIME_WARNINGr warningurlr PromptContinuestatusPrint)bucket_resourceargssource_locationwarning_messages r&_prompt_user_to_confirm_the_relocationr/>s \\ &//0/##?99:;;O&&(DMM,B,B,DDGO@O++ DHH:W_,=Q?@++o  ""&((1 . **4TXXJeDEcj[R"[5 [R"SUS3SS9 g)z4Prompt the user to confirm advancing the relocation.z?This will start the write downtime for your relocation of gs://z$, are you sure you want to continue?TrN)r r&$_ADVANCING_BUCKET_RELOCATION_WARNINGr r()rs r0_prompt_user_to_confirm_advancing_the_relocationr3Zs2++23  K M= ? r0c8\rSrSrSrSSS.r\S5rSrSr g ) Relocategz-Relocates bucket between different locations.z= Relocates a bucket between different locations. a< To move a bucket (``gs://my-bucket'') to the ``us-central1'' location, use the following command: $ {command} gs://my-bucket --location=us-central1 To move a bucket to a custom dual-region, use the following command: $ {command} gs://my-bucket --location=us --placement=us-central1,us-east1 To validate the operation without actually moving the bucket, use the following command: $ {command} gs://my-bucket --location=us-central1 --dry-run To schedule a write lock for the move, with ttl for reverting the write lock after 7h, if the relocation has not succeeded, use the following command: $ {command} --operation=projects/_/buckets/my-bucket/operations/C894F35J --finalize --ttl=7h ) DESCRIPTIONEXAMPLEScURS5 URSS9nURS5nURS5 URS[SS9 URS[SS S 9 [ R "U5 URS S S S9 URS5nURS5 URS[SSS 9 URSS SSS9 URS[R"5SS9 g)NFT)requiredz7Arguments for initiating the bucket relocate operation.r'z"The URL of the bucket to relocate.)typehelpz --locationzThe final [location](https://cloud.google.com/storage/docs/locations) where the bucket will be relocated to. If no location is provided, Cloud Storage will use the default location, which is us.)r;r:r<z --dry-run store_truezPrints the operations that the relocate command would perform without actually performing relocation. This is helpful to identify any issues that need to be detected asynchronously.)actionr<z1Arguments for advancing the relocation operation.z --operationzSpecify the relocation operation name to advance the relocation operation.The relocation operation name must include the Cloud Storage bucket and operation ID.z --finalizeaSchedules the write lock to occur. Once activated, no further writes will be allowed to the associated bucket. This helps minimize disruption to bucket usage. For certain types of moves(between Multi Region and Custom Dual Regions), finalize is not required.)r>r:r<z--ttlzKTime to live for the relocation operation. Defaults to 12h if not provided.) SetSortArgsadd_mutually_exclusive_group add_group add_argumentstrradd_placement_flagrDuration)clsparserrelocate_arguments_groupbucket_relocate_group advance_relocate_operation_groups rArgs Relocate.ArgssT u%BB C 5>>A%%e,&&  1' &&  C '  23&& L '(@'I'I;($%007$11  0 2 %11  2 %11  ! ! #  2r0c[R"[RR5nUR (a[R "UR 5n[R"URU5 [X#5n[XA5 URURURURUR 5$["R$"UR&5upV[)U5 UR+XVUR,5 [.R0R3SUSUS35 g)Nz3Sent request to advance relocation for bucket gs://z with operation r)rget_apir ProviderPrefixGCSr'storage_url_from_stringrraise_error_if_not_gcs_bucket command_pathrr/relocate_bucketrr! placementr r %get_operation_bucket_and_id_from_name operationr3advance_relocate_bucketttlr r)r*)selfr,rr'r+bucket operation_ids rRun Relocate.Runs$$[%?%?%C%CDJ xx  / / 9c//0A0A3G,Z=o,_C  ' ' // -- .. ,,  ==dnnMF5V<&&vTXXFJJ =fXF"^1 &r0N) __name__ __module__ __qualname____firstlineno____doc__ detailed_help classmethodrKr]__static_attributes__r_r0rr5r5gs25  -<EENr0r5)rdtextwrapgooglecloudsdk.api_lib.storagerrrgooglecloudsdk.callioperr"googlecloudsdk.command_lib.storagerrrr r googlecloudsdk.corer googlecloudsdk.core.consoler dedentr%r$r2rr/r3DefaultUniverseOnlyCommandr5r_r0rrqs 26?/(G:4>:#2.6__>.*5=OOE51 (08($ .F8 Bt||BBr0