- release_tracks: [ALPHA, BETA]
  help_text:
    brief: Set the IAM policy for a backup.
    description: |
      Set the IAM policy associated with a backup.

      ## EXAMPLES

      To set the IAM policy associated with a backup ``my-backup'' in backup plan ``my-backup-plan'' in project ``my-project'' in location ``us-central1'' with the policy defined in the JSON file ``policy.json'', run:

        $ {command} my-backup policy.json --project=my-project --location=us-central1 --backup-plan=my-backup-plan

  request:
    collection: gkebackup.projects.locations.backupPlans.backups
    api_version: v1

  arguments:
    resource:
      help_text: |
        Name of the backup for which to set IAM policy. The name may be provided either as a relative name,
        e.g.
        `projects/<project>/locations/<location>/backupPlans/<backupPlan>/backups/<backup>`
        or as a single ID name (with the parent resources provided via options or through
        properties), e.g.
        `BACKUP --project=<project> --location=<location> --backup-plan=<backupPlan>`
      spec: !REF googlecloudsdk.command_lib.container.backup_restore.resources:backup
