feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/backup_dr/backup_plans/__init__.py

@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command group for Backup and DR Backup Plan."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class BackupPlans(base.Group):
+  """Manage Backup and DR backup plans."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/backup_dr/backup_plans/create.py

@@ -0,0 +1,198 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Creates a new Backup Plan."""
+
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from apitools.base.py import exceptions as apitools_exceptions
+from googlecloudsdk.api_lib.backupdr import backup_plans
+from googlecloudsdk.api_lib.backupdr import util
+from googlecloudsdk.api_lib.util import exceptions
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.backupdr import flags
+from googlecloudsdk.core import log
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class Create(base.CreateCommand):
+  """Creates a new Backup Plan."""
+
+  detailed_help = {
+      'BRIEF': 'Creates a new backup plan',
+      'DESCRIPTION': """\
+          Create a new backup plan in the project. It can only be created in
+          locations where Backup and DR is available.
+      """,
+      'EXAMPLES': """\
+        To create a new backup plan ``sample-backup-plan''
+        in project ``sample-project'',
+        at location ``us-central1'',
+        with resource-type ``compute.<UNIVERSE_DOMAIN>.com/Instance'' and
+        backup-vault ``backup-vault''
+        with 2 backup-rules:
+
+        run:
+
+          $ {command} sample-backup-plan --project=sample-project --location=us-central1
+            --resource-type 'compute.<UNIVERSE_DOMAIN>.com/Instance'
+            --backup-vault <BACKUP-VAULT>
+            --backup-rule <BACKUP-RULE>
+            --backup-rule <BACKUP-RULE>
+
+        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
+
+        <BACKUP-RULE>: 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
+
+        <BACKUP-RULE>: 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
+
+        <BACKUP-RULE>: 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
+        """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Specifies additional command flags.
+
+    Args:
+      parser: argparse.Parser: Parser object for command line inputs.
+    """
+    base.ASYNC_FLAG.AddToParser(parser)
+    base.ASYNC_FLAG.SetDefault(parser, True)
+    flags.AddBackupPlanResourceArgWithBackupVault(
+        parser,
+        """Name of the backup plan to be created.
+        Once the backup plan is created, this name can't be changed.
+        The name must be unique for a project and location.
+        """,
+    )
+    flags.AddResourceType(
+        parser,
+        """Type of resource to which the backup plan should be applied.
+          E.g., `compute.<UNIVERSE_DOMAIN>.com/Instance` """,
+    )
+    flags.AddBackupRule(parser)
+    flags.AddMaxCustomOnDemandRetentionDays(parser)
+
+    description_help = """\
+        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.
+        """
+    flags.AddDescription(parser, description_help)
+
+    labels_help = """\
+        If you have assigned labels to your resources for grouping, you can
+        provide the label using this flag.A label is a key-value pair.
+
+        Keys must start with a lowercase character and contain only hyphens (-),
+        underscores (_), lowercase characters, and numbers. Values must contain
+        only hyphens (-), underscores (_), lowercase characters, and numbers.
+        """
+    flags.AddLabels(parser, labels_help)
+    flags.AddLogRetentionDays(parser)
+
+  def Run(self, args):
+    """Constructs 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.
+    """
+    client = backup_plans.BackupPlansClient()
+    is_async = args.async_
+
+    backup_plan = args.CONCEPTS.backup_plan.Parse()
+    backup_vault = args.CONCEPTS.backup_vault.Parse()
+    resource_type = args.resource_type
+    backup_rules = args.backup_rule
+    log_retention_days = args.log_retention_days
+    description = args.description
+    labels = args.labels
+    max_custom_on_demand_retention_days = (
+        args.max_custom_on_demand_retention_days
+    )
+
+    try:
+      operation = client.Create(
+          backup_plan,
+          backup_vault.RelativeName(),
+          resource_type,
+          backup_rules,
+          log_retention_days,
+          description,
+          labels,
+          max_custom_on_demand_retention_days
+      )
+    except apitools_exceptions.HttpError as e:
+      raise exceptions.HttpException(e, util.HTTP_ERROR_FORMAT)
+
+    if is_async:
+      log.CreatedResource(
+          backup_plan.RelativeName(),
+          kind='backup plan',
+          is_async=True,
+          details=util.ASYNC_OPERATION_MESSAGE.format(operation.name),
+      )
+      return operation
+
+    resource = client.WaitForOperation(
+        operation_ref=client.GetOperationRef(operation),
+        message=(
+            'Creating backup plan [{}]. (This operation could'
+            ' take up to 2 minutes.)'.format(backup_plan.RelativeName())
+        ),
+    )
+    log.CreatedResource(backup_plan.RelativeName(), kind='backup plan')
+
+    return resource

gcloud auth application-default login/google-cloud-sdk/lib/surface/backup_dr/backup_plans/delete.py

@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Deletes a Backup Plan."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from apitools.base.py import exceptions as apitools_exceptions
+from googlecloudsdk.api_lib.backupdr import util
+from googlecloudsdk.api_lib.backupdr.backup_plans import BackupPlansClient
+from googlecloudsdk.api_lib.util import exceptions
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.backupdr import flags
+from googlecloudsdk.core import log
+from googlecloudsdk.core.console import console_io
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+@base.DefaultUniverseOnly
+class Delete(base.DeleteCommand):
+  """Deletes a Backup Plan."""
+
+  detailed_help = {
+      'BRIEF': 'Deletes a specific backup plan',
+      'DESCRIPTION': '{description}',
+      'EXAMPLES': """\
+        To delete a backup plan `sample-backup-plan` in project `sample-project` and location `us-central1` , run:
+
+          $ {command} sample-backup-plan --project=sample-project --location=us-central1
+        """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Specifies additional command flags.
+
+    Args:
+      parser: argparse.Parser: Parser object for command line inputs.
+    """
+    base.ASYNC_FLAG.AddToParser(parser)
+    base.ASYNC_FLAG.SetDefault(parser, True)
+    flags.AddBackupPlanResourceArg(
+        parser,
+        'Name of the backup plan to delete'
+    )
+
+  def Run(self, args):
+    """Constructs 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.
+    """
+    client = BackupPlansClient()
+    is_async = args.async_
+
+    backup_plan = args.CONCEPTS.backup_plan.Parse()
+
+    console_io.PromptContinue(
+        message=(
+            'The backup plan will be deleted. You cannot undo this action.'
+        ),
+        default=True,
+        cancel_on_no=True,
+    )
+
+    try:
+      operation = client.Delete(backup_plan)
+    except apitools_exceptions.HttpError as e:
+      raise exceptions.HttpException(e, util.HTTP_ERROR_FORMAT) from e
+    if is_async:
+      log.DeletedResource(
+          backup_plan.RelativeName(),
+          kind='backup plan',
+          is_async=True,
+          details=util.ASYNC_OPERATION_MESSAGE.format(operation.name),
+      )
+      return operation
+
+    # For sync operation
+    return client.WaitForOperation(
+        operation_ref=client.GetOperationRef(operation),
+        message=(
+            'Deleting backup plan [{}]. '
+            '(This operation could take up to 2 minutes.)'
+            .format(backup_plan.RelativeName())
+        ),
+        has_result=False,
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/backup_dr/backup_plans/describe.yaml

@@ -0,0 +1,22 @@
+- release_tracks: [ALPHA, GA]
+  help_text:
+    brief: Show details of the backup plan.
+    description: Show all data associated with the specified backup plan.
+    examples: |
+      To view details for backup plan 'BACKUP_PLAN', run:
+
+        $ {command} BACKUP_PLAN
+
+  request:
+    collection: backupdr.projects.locations.backupPlans
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: Name of the backup plan to describe.
+      spec: !REF googlecloudsdk.command_lib.backupdr.resources:backupPlans
+
+  output:
+    format: json

gcloud auth application-default login/google-cloud-sdk/lib/surface/backup_dr/backup_plans/list.yaml

@@ -0,0 +1,27 @@
+- release_tracks: [ALPHA, GA]
+  help_text:
+    brief: List backup plans in the project
+    description: List backup plans in the project.
+    examples: |
+      To list backup plans for all locations, run:
+
+      $ {command}
+
+      To list backup plans in a location "my-location", run:
+
+      $ {command} --location=my-location
+
+  request:
+    collection: backupdr.projects.locations.backupPlans
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: Location for which backup plans should be listed.
+      spec: !REF googlecloudsdk.command_lib.backupdr.resources:locationDefaultGlobal
+
+  output:
+    format: json
+# TODO: b/336698260 Update the format to table format

gcloud auth application-default login/google-cloud-sdk/lib/surface/backup_dr/backup_plans/update.py

@@ -0,0 +1,311 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Updates a new Backup Plan."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import argparse
+
+from apitools.base.py import exceptions as apitools_exceptions
+from googlecloudsdk.api_lib.backupdr import backup_plans
+from googlecloudsdk.api_lib.backupdr import util
+from googlecloudsdk.api_lib.util import exceptions
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.backupdr import flags
+from googlecloudsdk.core import exceptions as core_exceptions
+from googlecloudsdk.core import log
+from googlecloudsdk.core import yaml
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class Update(base.UpdateCommand):
+  """Update a specific backup plan."""
+
+  detailed_help = {
+      'BRIEF': 'Update a specific backup plan',
+      'DESCRIPTION': """\
+          Update a specific backup plan in the project. It can only be updated in regions supported by the Backup and DR Service.
+      """,
+      'EXAMPLES': """\
+        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>
+            --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 <BACKUP-RULE>
+            --add-backup-rule <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 <FILE_PATH>
+
+        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
+
+        <BACKUP-RULE>: 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
+
+        <BACKUP-RULE>: 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
+
+        <BACKUP-RULE>: 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"
+            }
+          ]
+        }
+        ```
+        """,
+  }
+
+  @staticmethod
+  def Args(parser: argparse.ArgumentParser):
+    """Specifies additional command flags.
+
+    Args:
+      parser: Parser object for command line inputs.
+    """
+    base.ASYNC_FLAG.AddToParser(parser)
+    base.ASYNC_FLAG.SetDefault(parser, True)
+    flags.AddBackupPlanResourceArg(
+        parser,
+        """Name of the backup plan to be updated.
+        The name must be unique for a project and location.
+        """,
+    )
+    flags.AddUpdateBackupRule(parser)
+    flags.AddAddBackupRule(parser)
+    flags.AddRemoveBackupRule(parser)
+    flags.AddBackupRulesFromFile(parser)
+
+    description_help = """\
+        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.
+        """
+    flags.AddDescription(parser, description_help)
+    flags.AddLogRetentionDays(parser)
+    flags.AddMaxCustomOnDemandRetentionDays(parser)
+
+  class YamlOrJsonLoadError(core_exceptions.Error):
+    """Error parsing YAML or JSON file content."""
+
+  def _GetBackupRulesFromFile(self, backup_rules_file_content):
+    """Parses the backup rules from the file content."""
+    try:
+      backup_rules = yaml.load(backup_rules_file_content)
+      return backup_rules.get('backup-rules')
+    except Exception as exc:  # pylint: disable=broad-except
+      raise self.YamlOrJsonLoadError(
+          'Could not parse content in the backup rules file: {0}'.format(exc)
+      ) from exc
+
+  def Run(self, args) -> any:
+    """Constructs 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.
+    """
+    client = backup_plans.BackupPlansClient()
+
+    backup_plan = args.CONCEPTS.backup_plan.Parse()
+    backup_rules_file_content = args.backup_rules_from_file
+    update_backup_rules = args.backup_rule
+    add_backup_rules = args.add_backup_rule
+    remove_backup_rules = args.remove_backup_rule
+
+    if backup_rules_file_content and (
+        update_backup_rules or add_backup_rules or remove_backup_rules
+    ):
+      raise core_exceptions.Error(
+          '--backup-rules-from-file flag cannot be used with'
+          ' --backup-rule, --add-backup-rule or --remove-backup-rule flags.'
+      )
+
+    log_retention_days = args.log_retention_days
+    description = args.description
+    max_custom_on_demand_retention_days = (
+        args.max_custom_on_demand_retention_days
+    )
+
+    try:
+      current_backup_plan = client.Describe(backup_plan)
+      new_backup_rules_from_file = None
+      if backup_rules_file_content:
+        new_backup_rules_from_file = self._GetBackupRulesFromFile(
+            backup_rules_file_content
+        )
+      updated_backup_plan = client.ParseUpdate(
+          description,
+          new_backup_rules_from_file,
+          update_backup_rules,
+          add_backup_rules,
+          remove_backup_rules,
+          current_backup_plan,
+          log_retention_days,
+          max_custom_on_demand_retention_days,
+      )
+      update_mask = []
+      if (
+          description is not None
+          and description != current_backup_plan.description
+      ):
+        update_mask.append('description')
+      if (
+          log_retention_days is not None
+          and log_retention_days != current_backup_plan.logRetentionDays
+      ):
+        update_mask.append('logRetentionDays')
+      if (
+          max_custom_on_demand_retention_days is not None
+          and max_custom_on_demand_retention_days
+          != current_backup_plan.maxCustomOnDemandRetentionDays
+      ):
+        update_mask.append('maxCustomOnDemandRetentionDays')
+      if any([
+          update_backup_rules,
+          add_backup_rules,
+          remove_backup_rules,
+          new_backup_rules_from_file,
+      ]):
+        update_mask.append('backupRules')
+      operation = client.Update(
+          backup_plan, updated_backup_plan, ','.join(update_mask)
+      )
+    except apitools_exceptions.HttpError as e:
+      raise exceptions.HttpException(e, util.HTTP_ERROR_FORMAT)
+
+    if args.async_:
+      log.UpdatedResource(
+          backup_plan.RelativeName(),
+          kind='backup plan',
+          is_async=True,
+          details=util.ASYNC_OPERATION_MESSAGE.format(operation.name),
+      )
+      return operation
+
+    resource = client.WaitForOperation(
+        operation_ref=client.GetOperationRef(operation),
+        message=(
+            f'Updating backup plan [{backup_plan.RelativeName()}]. (This'
+            ' operation could take up to 2 minutes.)'
+        ),
+    )
+    log.UpdatedResource(backup_plan.RelativeName(), kind='backup plan')
+
+    return resource