PUT Bucket

Creates a bucket in a specified project, sets the ACL for an existing bucket,or modifies the metadata for an existing bucket. You can only apply oneconfiguration setting per request.

Use a PUT bucket request to:

Note: Bucket configuration changes may take time to propagate. For moreinformation, seeConsistency.

Common request headers

The following are common request headers for PUT bucket requests.

HeaderDescriptionRequired
AuthorizationThe authentication string for the request.Yes
Content-Length

The length of the request body without headers (in bytes).

* Not required for requests that use chunked transfer encoding.

Yes*
Content-TypeThe MIME type of the request body.No
DateThe date and time of the request.Yes
HostThe URI for Cloud Storage. For more information, seeRequest Endpoints.Yes
x-goog-user-projectThe project to be billed for charges associated with the request.No

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-17 UTC.