NAME
    gcloud alpha quotas preferences update - update the parameters of a single
        QuotaPreference

SYNOPSIS
    gcloud alpha quotas preferences update PREFERENCE_ID
        --preferred-value=PREFERRED_VALUE --quota-id=QUOTA_ID --service=SERVICE
        (--folder=FOLDER_ID | --organization=ORGANIZATION_ID
          | --project=PROJECT_ID_OR_NUMBER)
        [--allow-high-percentage-quota-decrease] [--allow-missing]
        [--allow-quota-decrease-below-usage] [--dimensions=[KEY=VALUE,...]]
        [--email=EMAIL] [--justification=JUSTIFICATION] [--validate-only]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) This command updates an existing or creates a new QuotaPreference.
    It can updates the config in any states, not just the ones pending
    approval.

EXAMPLES
    To update a quota preference with id my-preference in region us-central1
    that applies to the default_limit quota for projects/12321, run:

        $ gcloud alpha quotas preferences update my-preference \
            --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 \
            --quota-id=default_limit --preferred-value=100 \
            --dimensions=region=us-central1

    To create a new quota preference for organizations/789, run:

        $ gcloud alpha quotas preferences update my-preference \
            --service=example.$$UNIVERSE_DOMAIN$$ --organization=789 \
            --quota-id=default_limit --preferred-value=200 --allow-missing

POSITIONAL ARGUMENTS
     PREFERENCE_ID
        ID of the Quota Preference object, must be unique under its parent.

REQUIRED FLAGS
     --preferred-value=PREFERRED_VALUE
        Preferred value. Must be greater than or equal to -1. If set to -1, it
        means the value is "unlimited".

     --quota-id=QUOTA_ID
        ID of the quota, which is unique within the service.

     --service=SERVICE
        Name of the service in which the quota is defined.

     Exactly one of these must be specified:

       --folder=FOLDER_ID
          Folder of the quota preference to update.

       --organization=ORGANIZATION_ID
          Organization of the quota preference to update.

       --project=PROJECT_ID_OR_NUMBER
          Project of the quota preference to update.

OPTIONAL FLAGS
     --allow-high-percentage-quota-decrease
        If specified, allows you to reduce your effective limit by more than 10
        percent. Default is false.

     --allow-missing
        If specified and the quota preference is not found, a new one will be
        created. Default is false.

     --allow-quota-decrease-below-usage
        If specified, allows you to reduce your effective limit below your
        quota usage. Default is false.

     --dimensions=[KEY=VALUE,...]
        Dimensions of the quota.

     --email=EMAIL
        An optional email address that can be used for quota related
        communication between the Google Cloud and the user in case the Google
        Cloud needs further information to make a decision on whether the user
        preferred quota can be granted. The Google account for the email
        address must have quota update permission for the project, folder or
        organization this quota preference is for. If no contact email address
        is provided, or the provided email address does not have the required
        quota update permission, the quota preference request will be denied in
        case further information is required to make a decision.

     --justification=JUSTIFICATION
        A short statement to justify quota increase requests.

     --validate-only
        If specified, only validates the request, but does not actually update.
        Note that a request being valid does not mean that the request is
        guaranteed to be fulfilled. Default is false.

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.

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. This variant is also available:

        $ gcloud beta quotas preferences update

