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

SYNOPSIS
    gcloud alpha 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
    (ALPHA) 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 alpha 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 alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. These variants are also available:

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

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

