NAME
    gcloud beta backup-dr backup-plan-associations trigger-backup - create an
        on-demand backup for a resource

SYNOPSIS
    gcloud beta backup-dr backup-plan-associations trigger-backup
        (BACKUP_PLAN_ASSOCIATION
          : --location=LOCATION --workload-project=WORKLOAD_PROJECT) [--async]
        [--labels=[KEY=VALUE,...]]
        [--backup-rule-id=BACKUP_RULE_ID
          | --custom-retention-days=CUSTOM_RETENTION_DAYS]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Create an on-demand backup for a resource. Trigger an on demand
    backup for the given backup rule.

EXAMPLES
    To trigger an on demand backup for a backup plan association sample-bpa in
    project sample-project and location us-central1 with backup rule
    sample-backup-rule, run:

        $ gcloud beta backup-dr backup-plan-associations trigger-backup \
            sample-bpa --project=sample-project --location=us-central1 \
            --backup-rule-id=sample-backup-rule

POSITIONAL ARGUMENTS
     Backup Plan Association resource - Name of an existing backup plan
     association to use for creating an on-demand backup. The arguments in this
     group can be used to specify the attributes of this resource.

     This must be specified.

       BACKUP_PLAN_ASSOCIATION
          ID of the Backup Plan Association or fully qualified identifier for
          the Backup Plan Association.

          To set the name attribute:
          ▸ provide the argument BACKUP_PLAN_ASSOCIATION on the command line.

          This positional argument must be specified if any of the other
          arguments in this group are specified.

       --location=LOCATION
          The location of the Backup Plan Association.

          To set the location attribute:
          ▸ provide the argument BACKUP_PLAN_ASSOCIATION on the command line
            with a fully specified name;
          ▸ provide the argument --location on the command line.

       --workload-project=WORKLOAD_PROJECT
          Cloud project id for the Backup Plan Association.

          To set the workload-project attribute:
          ▸ provide the argument BACKUP_PLAN_ASSOCIATION on the command line
            with a fully specified name;
          ▸ provide the argument --workload-project on the command line;
          ▸ provide the argument --project on the command line;
          ▸ set the property core/project.

FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete. The default is True. Enabled by default, use --no-async to
        disable.

     --labels=[KEY=VALUE,...]
        Labels to be applied to the backup.

     At most one of these can be specified:

       --backup-rule-id=BACKUP_RULE_ID
          Name of an existing backup rule to use for creating an on-demand
          backup.

       --custom-retention-days=CUSTOM_RETENTION_DAYS
          Duration for which backup data will be retained.

GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
    --help, --impersonate-service-account, --log-http, --project, --quiet,
    --trace-token, --user-output-enabled, --verbosity.

    Run $ gcloud help for details.

BRIEF
    Create an on-demand backup.

NOTES
    This command is currently in beta and might change without notice. These
    variants are also available:

        $ gcloud backup-dr backup-plan-associations trigger-backup

        $ gcloud alpha backup-dr backup-plan-associations trigger-backup

