NAME
    gcloud storage buckets create - create buckets for storing objects

SYNOPSIS
    gcloud storage buckets create URL [--additional-headers=HEADER=VALUE]
        [--default-encryption-key=DEFAULT_ENCRYPTION_KEY,
          -k DEFAULT_ENCRYPTION_KEY]
        [--default-storage-class=DEFAULT_STORAGE_CLASS,
          -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS]
        [--[no-]enable-autoclass] [--location=LOCATION, -l LOCATION]
        [--[no-]pap, --[no-]public-access-prevention]
        [--placement=REGION,REGION]
        [--recovery-point-objective=SETTING, --rpo=SETTING]
        [--retention-period=RETENTION_PERIOD]
        [--[no-]uniform-bucket-level-access, -b] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Create a new bucket.

EXAMPLES
    The following command creates a Cloud Storage bucket named my-bucket:

        $ gcloud storage buckets create gs://my-bucket

    The following command creates a bucket with the nearline default storage
    class (https://cloud.google.com/storage/docs/storage-classes) in the asia
    location (https://cloud.google.com/storage/docs/locations):

        $ gcloud storage buckets create gs://my-bucket \
            --default-storage-class=nearline --location=asia

POSITIONAL ARGUMENTS
     URL
        The URL of the bucket to create.

FLAGS
     --additional-headers=HEADER=VALUE
        Includes arbitrary headers in storage API calls. Accepts a comma
        separated list of key=value pairs, e.g. header1=value1,header2=value2.
        Overrides the default storage/additional_headers property value for
        this command invocation.

     --default-encryption-key=DEFAULT_ENCRYPTION_KEY, -k DEFAULT_ENCRYPTION_KEY
        Set the default KMS key using the full path to the key, which has the
        following form:
        projects/[project-id]/locations/[location]/keyRings/[key-ring]/cryptoKeys/[my-key].

     --default-storage-class=DEFAULT_STORAGE_CLASS, -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS
        Default storage class
        (https://cloud.google.com/storage/docs/storage-classes) for the bucket.
        If not specified, the default storage class used by Cloud Storage is
        "Standard".

     --[no-]enable-autoclass
        The Autoclass feature automatically selects the best storage class for
        objects based on access patterns. Use --enable-autoclass to enable and
        --no-enable-autoclass to disable.

     --location=LOCATION, -l LOCATION
        Location (https://cloud.google.com/storage/docs/locations) for the
        bucket. If not specified, the location used by Cloud Storage is us. A
        bucket's location cannot be changed after creation.

     --[no-]pap, --[no-]public-access-prevention
        Sets public access prevention to "enforced". For details on how exactly
        public access is blocked, see:
        http://cloud.google.com/storage/docs/public-access-prevention. Use
        --public-access-prevention to enable and --no-public-access-prevention
        to disable.

     --placement=REGION,REGION
        A comma-separated list of exactly 2 regions that form the custom
        dual-region. Only regions within the same continent are or will ever be
        valid. Invalid location pairs (such as mixed-continent, or with
        unsupported regions) will return an error.

     --recovery-point-objective=SETTING, --rpo=SETTING
        Sets the recovery point objective
        (https://cloud.google.com/architecture/dr-scenarios-planning-guide#basics_of_dr_planning)
        of a bucket. This flag can only be used with multi-region and
        dual-region buckets. DEFAULT option is valid for multi-region and
        dual-regions buckets. ASYNC_TURBO option is only valid for dual-region
        buckets. If unspecified when the bucket is created, it defaults to
        DEFAULT for dual-region and multi-region buckets. For more information,
        see replication in Cloud Storage
        (https://cloud.google.com/storage/docs/availability-durability#cross-region-redundancy).
        SETTING must be one of: ASYNC_TURBO, DEFAULT.

     --retention-period=RETENTION_PERIOD
        Minimum retention period
        (https://cloud.google.com/storage/docs/bucket-lock#retention-periods)
        for objects stored in the bucket, for example
        --retention-period=1Y1M1D5S. Objects added to the bucket cannot be
        deleted until they've been stored for the specified length of time.
        Default is no retention period. Only available for Cloud Storage using
        the JSON API.

     --[no-]uniform-bucket-level-access, -b
        Turns on uniform bucket-level access setting. Default is False. Use
        --uniform-bucket-level-access to enable and
        --no-uniform-bucket-level-access to disable.

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

        $ gcloud alpha storage buckets create

