Requires authorization
Creates a new bucket. Try it now or see an example .
Google Cloud Storage uses a flat namespace, so you can't create a bucket with a name that is already in use. For more information, see
Bucket Naming Guidelines
.
The authenticated user must be a member of the
project's team
as an editor or owner.
Request
HTTP request
POST https://www.googleapis.com/storage/v1beta1/b
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Optional parameters | ||
projection
|
string
|
Set of properties to return. Defaults to
no_acl
, unless the bucket resource specifies
acl
or
defaultObjectAcl
properties, when it defaults to
full
.
Acceptable values are:
|
Authorization
This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).
| Scope |
|---|
https://www.googleapis.com/auth/devstorage.write_only
|
https://www.googleapis.com/auth/devstorage.read_write
|
https://www.googleapis.com/auth/devstorage.full_control
|
Request body
In the request body, supply a bucket resource with the following properties:
| Property name | Value | Description | Notes |
|---|---|---|---|
| Required Properties | |||
id
|
string
|
The name of the bucket. | |
projectId
|
unsigned long
|
The project the bucket belongs to. | |
| Optional Properties | |||
acl[]
|
list
|
Access controls on the bucket. | writable |
defaultObjectAcl[]
|
list
|
Default access controls to apply to new objects when no ACL is provided. | writable |
location
|
string
|
The location of the bucket. Object data for objects in the bucket resides in physical storage in this location. Can be
US
or
EU
. Defaults to
US
.
|
writable |
website.
mainPageSuffix
|
string
|
Behaves as the bucket's directory index where missing objects are treated as potential directories. | writable |
website.
notFoundPage
|
string
|
The custom object to return when a requested resource is not found. | writable |
Response
If successful, this method returns a bucket resource in the response body.
Examples
Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).
Ruby
Uses the Ruby client library
# Create a bucket in the project
bucket_insert_result = client.execute(
api_method: storage.buckets.insert,
body_object: {id: BUCKET, projectId: PROJECTID}
)
contents = bucket_insert_result.data
puts "Created bucket #{contents.id} at #{contents.selfLink}"
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .