PUT Bucket Stay organized with collections Save and categorize content based on your preferences.
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.
| Header | Description | Required |
|---|---|---|
Authorization | The 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-Type | The MIME type of the request body. | No |
Date | The date and time of the request. | Yes |
Host | The URI for Cloud Storage. For more information, seeRequest Endpoints. | Yes |
x-goog-user-project | The 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.