=SrSSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSK J r SS K J r SS K J r SS K Jr SS K Jr SS K Jr SSKJr SSKJr SSKJr SSKJr SrSrSrSrSrSr\ R:"\ R<R>5\ R@"SS\ RB555r"\ R:"\ R<RF5"SS\"55r$g)z>Implementation of update command for updating bucket settings.)absolute_import)division)unicode_literals) cloud_api) arg_parsers)base) errors_util)flags)stdin_iterator) storage_url)user_request_args_factory)wildcard_iterator) task_executor)task_graph_executor) task_status)update_bucket_taska Sets the Cross-Origin Resource Sharing (CORS) configuration on a bucket. An example CORS JSON document looks like the following: [ { "origin": ["http://origin1.example.com"], "responseHeader": ["Content-Type"], "method": ["GET"], "maxAgeSeconds": 3600 } ] For more information about supported endpoints for CORS, see [Cloud Storage CORS support](https://cloud.google.com/storage/docs/cross-origin#server-side-support). z Sets the label configuration for the bucket. An example label JSON document looks like the following: { "your_label_key": "your_label_value", "your_other_label_key": "your_other_label_value" } ad Sets the lifecycle management configuration on a bucket. For example, The following lifecycle management configuration JSON document specifies that all objects in this bucket that are more than 365 days old are deleted automatically: { "rule": [ { "action": {"type": "Delete"}, "condition": {"age": 365} } ] } cURSS[SS9 UR5n[R"U5 UR5nURSSS9 URSS S9 URS S S [ R "5S S9 URSS SS9 UR5nURS[S9 URSSSS9 URSSS9 UR5nURSSS9 URSSSS9 URS[ RSS9 UR5nURS[S9 UR5nURSS [ R "5S!S"9 URS#S$[ R"5S%S"9 URS&SS'S9 UR5nURS([S9 URS)SS*S9 UR5nURS+S,S9 URS-SS.S9 UR5n U RS/S0S9 U RS1SS2S9 UR5n U RS3S4[ RS5S9 U RS6S7SS8S9 UR5n U RS9S:S9 U RS;SSS9 URS?[ RS@S9 URSA[ R"5SBSC9 URSDSSES9 URSF[ RSGS9 URSH[ RSIS9 UR5n U RSJSKS9 U RSLSSMS9 UR5n U RSNSOS9 U RSPSSQS9 [R"U5 [R"U5 [R "U5 [R""U5 [R$"U5 UR5nURSRSSSS9 [R&"U5 gT)UzRegister flags for this command. Args: parser (argparse.ArgumentParser): The parser to add the arguments to. Returns: buckets update flag group url*z,Specifies the URLs of the buckets to update.)nargstypehelpz--default-object-acl-filez5Sets the default object ACL from file for the bucket.)rz--predefined-default-object-aclzBApply a predefined set of default object access controls tobucketsz--add-default-object-acl-grantappendDEFAULT_OBJECT_ACL_GRANTzNAdds default object ACL grant. See --add-acl-grant help text for more details.)actionmetavarrrz!--remove-default-object-acl-grantzTRemoves default object ACL grant. See --remove-acl-grant help text for more details.)rrz --cors-filez --clear-cors store_truez"Clears the bucket's CORS settings.z--default-storage-classz.Sets the default storage class for the bucket.z--default-encryption-keyz'Set the default KMS key for the bucket.z--clear-default-encryption-keyz+Clears the bucket's default encryption key.z--default-event-based-holdzSets the default value for an event-based hold on the bucket. By setting the default event-based hold on a bucket, newly-created objects inherit that value as their event-based hold (it is not applied retroactively).z --labels-filez--update-labelsLABEL_KEYS_AND_VALUESzFAdd or update labels. Example: --update-labels=key1=value1,key2=value2)rrrz--remove-labels LABEL_KEYSz!Remove labels by their key names.z--clear-labelsz*Clear all labels associated with a bucket.z--lifecycle-filez--clear-lifecyclez3Removes all lifecycle configuration for the bucket.z --log-bucketajEnables usage and storage logging for the bucket specified in the overall update command, outputting log files to the bucket specified in this flag. Cloud Storage does not validate the existence of the bucket receiving logs. In addition to enabling logging on your bucket, you also need to grant cloud-storage-analytics@google.com write access to the log bucket.z--clear-log-bucketzZDisables usage and storage logging for the bucket specified in the overall update command.z--log-object-prefixzSpecifies a prefix for the names of logs generated in the log bucket. The default prefix is the bucket name. If logging is not enabled, this flag has no effect.z--clear-log-object-prefixzTClears the prefix used to determine the naming of log objects in the logging bucket.z--public-access-preventionz--papzIf True, sets [public access prevention](https://cloud.google.com/storage/docs/public-access-prevention) to "enforced". If False, sets public access prevention to "inherited".z --clear-public-access-preventionz --clear-papz8Unsets the public access prevention setting on a bucket.z--retention-periodaoMinimum [retention period](https://cloud.google.com/storage/docs/bucket-lock#retention-periods) for objects stored in the bucket, for example ``--retention-period=P1Y1M1DT5S''. Objects added to the bucket cannot be deleted until they've been stored for the specified length of time. Default is no retention period. Only available for Cloud Storage using the JSON API.z--clear-retention-periodz0Clears the object retention period for a bucket.z--lock-retention-periodzLocks an unlocked retention policy on the buckets. Caution: A locked retention policy cannot be removed from a bucket or reduced in duration. Once locked, deleting the bucket is the only way to "remove" a retention policy.z--requester-payszAllows you to configure a Cloud Storage bucket so that the requester pays all costs related to accessing the bucket and its objects.z--soft-delete-durationzVDuration to retain soft-deleted objects. For example, "2w1d" is two weeks and one day.)rrz--clear-soft-deletezZClears bucket soft delete settings. Does not affect objects already in soft-deleted state.z--uniform-bucket-level-accessz|Enables or disables [uniform bucket-level access](https://cloud.google.com/storage/docs/bucket-policy-only) for the buckets.z --versioningzOAllows you to configure a Cloud Storage bucket to keep old versions of objects.z--web-main-page-suffixzCloud Storage allows you to configure a bucket to behave like a static website. A subsequent GET bucket request through a custom domain serves the specified "main" page instead of performing the usual bucket listing.z--clear-web-main-page-suffixz>@%% 4&6%%&  8&: "  - - !"  . . 0&o,=>""$-%     1 2     . 0    79113) +2FG   @B224*     !" 99;   +!,   !  ! $@@B''"  - - A (B''(  E ( 88: / 0  = ?   &'   - -       ! $    $  %  - -     - - "  <<>## #$##$  I$ 668. :  C ##F+F#""6*))&1&&v.113)   G  *cAg)zRegister flags for the alpha version of this command. Args: parser (argparse.ArgumentParser): The parser to add the arguments to. Nr2s rA_add_alpha_argsrG>s rCcURnU(dg[R"U5=(d, [URUR UR /5$)z?Determines if the bucket update has to patch existing metadata.F) resource_argsr adds_or_removes_aclsanylabels_file_pathlabels_to_appendlabels_to_remove)user_request_argsrIs rA"_is_initial_bucket_metadata_neededrPIsV#11-   " 7 7    ( (  ( (  ( (!  rCc>\rSrSrSrSSS.r\S5rSrSr S r g ) UpdateiVUpdate bucket settings.z/ Update the settings for a bucket. aK The following command updates the default storage class of a Cloud Storage bucket named "my-bucket" to NEARLINE and sets requester pays to true: $ {command} gs://my-bucket --default-storage-class=NEARLINE --requester-pays The following command updates the retention period of a Cloud Storage bucket named "my-bucket" to one year and thirty-six minutes: $ {command} gs://my-bucket --retention-period=1y36m The following command clears the retention period of a bucket: $ {command} gs://my-bucket --clear-retention-period  DESCRIPTIONEXAMPLESc[U5 gN)rBrFs rAArgs Update.Argsss VrCc#T# [R"U[RRS9n[R"U5(a[ R RnO[ R Rn[R"URUR5nUHvn[R"U5n[R "UR"U5 [$R&"UU[)U5S9Hn[*R,"XrS9v M Mx g7f)N) metadata_type) fields_scopeget_bucket_metadata)rO)r 'get_user_request_args_from_command_args MetadataTypeBUCKETrJr FieldsScopeFULLNO_ACLr get_urls_iterablerread_paths_from_stdinr storage_url_from_stringr raise_error_if_not_bucket command_pathrget_wildcard_iteratorrPrUpdateBucketTask)selfargsrOr]urls url_stringrresources rAupdate_task_iteratorUpdate.update_task_iteratorws!II  9 F F M M  !556GHH**//l**11l  + + $,, D  / / ;c++D,=,=sC'== #@!"( !11 ; ; "sD&D(c &[RR5n[USS5n[R "UR U5U(+U[R"[RRSS9URS9Ul g)Nlock_retention_periodF)increment_type manifest_path)parallelizabletask_status_queueprogress_manager_argscontinue_on_error) rmultiprocessing_contextQueuegetattrr execute_tasksrqrProgressManagerArgs IncrementTypeINTEGERrz exit_code)rlrmrxlocks_retention_periods rARun Update.Runs{+CCIIK$T+BEJ"00 !!$'11+)==&44<< 00DNrC)rN) __name__ __module__ __qualname____firstlineno____doc__ detailed_help staticmethodrYrqr__static_attributes__rErCrArRrRVs6   -0;2 rCrRc2\rSrSrSrSSS.r\S5rSrg) UpdateAlphairSz Update a bucket. aW The following command updates the retention period of a Cloud Storage bucket named "my-bucket" to one year and thirty-six minutes: $ {command} gs://my-bucket --retention-period=1y36m The following command clears the retention period of a bucket: $ {command} gs://my-bucket --clear-retention-period rTc0[U5 [U5 grX)rBrGrFs rArYUpdateAlpha.ArgssVFrCrEN) rrrrrrrrYrrErCrArrs*  -&rCrN)%r __future__rrrgooglecloudsdk.api_lib.storagergooglecloudsdk.callioperr"googlecloudsdk.command_lib.storager r r r r r(googlecloudsdk.command_lib.storage.tasksrrr0googlecloudsdk.command_lib.storage.tasks.bucketsrr&r(r*rBrGrP ReleaseTracks ReleaseTrackGAUniverseCompatibleCommandrRALPHArrErCrArsE&'4/(:4=:H@BH@O $l+^   D%%(()ET\\E*EPD%%++,&-rC