NAME
    gcloud beta quotas preferences create - create a new QuotaPreference that
        declares the desired value for a quota

SYNOPSIS
    gcloud beta quotas preferences create --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-quota-decrease-below-usage] [--dimensions=[KEY=VALUE,...]]
        [--email=EMAIL] [--justification=JUSTIFICATION]
        [--preference-id=PREFERENCE_ID] [GCLOUD_WIDE_FLAG ...]

EXAMPLES
    To create a quota preference in region us-central1 that applies to the
    default_limit quota under service example.$$UNIVERSE_DOMAIN$$ for
    projects/12321, run:

        $ gcloud beta quotas preferences create \
            --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 \
            --quota-id=default_limit --preferred-value=100 \
            --dimensions=region=us-central1 \
            --preference-id=example_default-limit_us-central1

    To create a quota preference under service example.$$UNIVERSE_DOMAIN$$``
    for organizations/789 with random preference ID, run:

        $ gcloud beta quotas preferences create \
            --service=example.$$UNIVERSE_DOMAIN$$ --organization=789 \
            --quota-id=default_limit --preferred-value=200

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 create.

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

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

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-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.

     --preference-id=PREFERENCE_ID
        ID of the Quota Preference object, must be unique under its parent.

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 beta and might change without notice. This
    variant is also available:

        $ gcloud alpha quotas preferences create

