G*ddZddlmZddlmZddlmZddlZddlmZddl m Z ddl m Z ddl mZdd l mZdd lmZddlmZdd lmZdd lmZej*ej,ej.j0ej.j2Gd dej4Zy)zUpdates a new Backup Plan.)absolute_import)division)unicode_literalsN) exceptions) backup_plans)util)base)flags)log)yamlceZdZdZddddZedejfdZGdd e jZ d Z d e fd Zy )UpdatezUpdate a specific backup plan.zUpdate a specific backup planz Update a specific backup plan in the project. It can only be updated in regions supported by the Backup and DR Service. a To update 2 backup rules and description of an existing backup plan ``sample-backup-plan'' in project ``sample-project'', at location ``us-central1'': run: $ {command} sample-backup-plan --project=sample-project --location=us-central1 --backup-rule --backup-rule --description "This is a sample backup plan" To add backup rules to an existing backup plan ``sample-backup-plan'' in project ``sample-project'', at location ``us-central1'': run: $ {command} sample-backup-plan --project=sample-project --location=us-central1 --add-backup-rule --add-backup-rule To remove a backup rule with id ``sample-daily-rule'' from an existing backup plan ``sample-backup-plan'' in project ``sample-project'', at location ``us-central1'': run: $ {command} sample-backup-plan --project=sample-project --location=us-central1 --remove-backup-rule sample-daily-rule To override backup rules in an existing backup plan ``sample-backup-plan'' in project ``sample-project'', at location ``us-central1'', pass a file path containing backup rules in YAML or JSON format: This flag is mutually exclusive with --add-backup-rule, --remove-backup-rule and --backup-rule flags. run: $ {command} sample-backup-plan --project=sample-project --location=us-central1 --backup-rules-fom-file Backup Rule Examples: 1. Hourly backup rule with hourly backup frequency of 6 hours and store it for 30 days, and expect the backups to run only between 10:00 to 20:00 UTC : rule-id=sample-hourly-rule,retention-days=30,recurrence=HOURLY,hourly-frequency=6,time-zone=UTC,backup-window-start=10,backup-window-end=20 Properties: -- rule-id = "sample-hourly-rule" -- retention-days = 30 -- recurrence = HOURLY -- hourly-frequency = 6 -- time-zone = UTC -- backup-window-start = 10 -- backup-window-end = 20 2. Daily backup rule with daily backup frequency of 6 hours and store it for 7 days : rule-id=sample-daily-rule,retention-days=7,recurrence=DAILY,backup-window-start=1,backup-window-end=14 Properties: -- rule-id = "sample-daily-rule" -- retention-days = 7 -- recurrence = DAILY -- backup-window-start = 1 -- backup-window-end = 14 3. Weekly backup rule with weekly backup frequency on every MONDAY & FRIDAY and store it for 21 days : rule-id=sample-weekly-rule,retention-days=21,recurrence=WEEKLY,days-of-week="MONDAY FRIDAY",backup-window-start=10,backup-window-end=20 Properties: -- rule-id = "sample-weekly-rule" -- retention-days: 21 -- recurrence = WEEKLY -- days-of-week = "MONDAY FRIDAY" -- backup-window-start = 10 -- backup-window-end = 20 YAML and JSON file examples: YAML file example: ``` backup-rules: - rule-id: weekly-rule retention-days: 7 recurrence: WEEKLY backup-window-start: 0 backup-window-end: 23 days-of-week: [MONDAY, TUESDAY] time-zone: UTC - rule-id: daily-rule retention-days: 1 recurrence: DAILY backup-window-start: 1 backup-window-end: 24 time-zone: UTC ``` JSON file example: ``` { "backup-rules": [ { "rule-id": "weekly-rule", "retention-days": 7, "recurrence": "WEEKLY", "backup-window-start": 0, "backup-window-end": 23, "days-of-week": ["MONDAY", "TUESDAY"], "time-zone": "UTC" }, { "rule-id": "daily-rule", "retention-days": 1, "recurrence": "DAILY", "backup-window-start": 1, "backup-window-end": 24, "time-zone": "UTC" } ] } ``` )BRIEF DESCRIPTIONEXAMPLESparserctjj|tjj|dt j |dt j |t j|t j|t j|d}t j||t j|t j|y)zhSpecifies additional command flags. Args: parser: Parser object for command line inputs. TzkName of the backup plan to be updated. The name must be unique for a project and location. a Provide a description of the backup plan, such as specific use cases and relevant details, in 2048 characters or less. E.g., This is a backup plan that performs a daily backup at 6 p.m. and retains data for 3 months. N) r ASYNC_FLAG AddToParser SetDefaultr AddBackupPlanResourceArgAddUpdateBackupRuleAddAddBackupRuleAddRemoveBackupRuleAddBackupRulesFromFileAddDescriptionAddLogRetentionDays!AddMaxCustomOnDemandRetentionDays)rdescription_helps ,lib/surface/backup_dr/backup_plans/update.pyArgsz Update.Argss OO'OOvt, ""   f% 6" f%   (  !12 f% ++F3ceZdZdZy)Update.YamlOrJsonLoadErrorz(Error parsing YAML or JSON file content.N)__name__ __module__ __qualname____doc__r"r YamlOrJsonLoadErrorr$s2r"r*c tj|}|jdS#t$r&}|j dj ||d}~wwxYw)z.Parses the backup rules from the file content.z backup-rulesz5Could not parse content in the backup rules file: {0}N)r loadget Exceptionr*format)selfbackup_rules_file_content backup_rulesexcs r _GetBackupRulesFromFilezUpdate._GetBackupRulesFromFiles[YY89l   n --   $ $ A H H M  s%( A!AAreturnc tj}|jjj }|j }|j }|j}|j}|r|s|s|rtjd|j}|j} |j} |j|} d} |r|j|} |j!| | |||| || } g}| | | jk7r|j#d| || j$k7r|j#d| | | j&k7r|j#dt)|||| gr|j#d|j+|| dj-|}|j:rPt=j>|jAdd t6jBjE|jF |S|jI|jK|d |jAd  }t=j>|jAd|S#t.j0$r)}t3j4|t6j8d}~wwxYw)zConstructs and sends request. Args: args: argparse.Namespace, An object that contains the values for the arguments specified in the .Args() method. Returns: ProcessHttpResponse of the request made. zq--backup-rules-from-file flag cannot be used with --backup-rule, --add-backup-rule or --remove-backup-rule flags.N descriptionlogRetentionDaysmaxCustomOnDemandRetentionDays backupRules,z backup planT)kindis_asyncdetailszUpdating backup plan [z/]. (This operation could take up to 2 minutes.)) operation_refmessage)r<)&rBackupPlansClientCONCEPTS backup_planParsebackup_rules_from_file backup_ruleadd_backup_ruleremove_backup_rulecore_exceptionsErrorlog_retention_daysr7#max_custom_on_demand_retention_daysDescriber4 ParseUpdateappendr8r9anyrjoinapitools_exceptions HttpErrorr HttpExceptionrHTTP_ERROR_FORMATasync_r UpdatedResource RelativeNameASYNC_OPERATION_MESSAGEr/nameWaitForOperationGetOperationRef)r0argsclientrCr1update_backup_rulesadd_backup_rulesremove_backup_rulesrKr7rLcurrent_backup_plannew_backup_rules_from_fileupdated_backup_plan update_mask operationeresources r Runz Update.Runs + + -F--++113K $ ; ;**++11 /3F  ! ! M  00""K 00(-@"OOK8#' "%)%A%A %& "#..  $      - k  !0<<<=)  ( $7$H$HH-. - 91 ? ?@ ;<    $  =)-- *CHH[,Ai  {{   " " $..55innE  &&,,Y7$[%=%=%?$@A6 6'H 002G O+  ( (@  $ $Q(>(> ??@s+C(I J$JJN)r%r&r'r( detailed_help staticmethodargparseArgumentParserr!rIrJr*r4rPrir)r"r rr"sf'/ { A-F48**44<3O113aar"r)r( __future__rrrrlapitools.base.pyrrRgooglecloudsdk.api_lib.backupdrrrgooglecloudsdk.api_lib.utilgooglecloudsdk.callioper #googlecloudsdk.command_lib.backupdrr googlecloudsdk.corerIr r UniverseCompatible ReleaseTracks ReleaseTrackALPHAGA UpdateCommandrr)r"r r{s!&'>802(5=#$D%%++T->->-A-ABST  SCSr"