Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Buckets

The Buckets resource represents a bucket in Google Cloud Storage. There is a single global namespace shared by all buckets. For more information, see Bucket Name Requirements .

Buckets contain objects which can be accessed by their own methods. In addition to the acl property, buckets contain bucketAccessControls , for use in fine-grained manipulation of an existing bucket's access controls.

A bucket is always owned by its project team 's owner group.



For a list of methods for this resource, see the end of this page.

Resource representations

A bucket.

{
  "kind": "storage#bucket",
  "id": string,
  "selfLink": string,
  "projectId": unsigned long,
  "timeCreated": datetime,
  "acl": [
    bucketAccessControls Resource
  ],
  "defaultObjectAcl": [
    objectAccessControls Resource
  ],
  "owner": {
    "entity": string,
    "entityId": string
  },
  "location": string,
  "website": {
    "mainPageSuffix": string,
    "notFoundPage": string
  }
}
Property name Value Description Notes
kind string The kind of item this is. For buckets, this is always storage#bucket .
id string The name of the bucket.
projectId unsigned long The project the bucket belongs to.
timeCreated datetime Creation time of the bucket in RFC 3339 format.
acl[] list Access controls on the bucket. writable
defaultObjectAcl[] list Default access controls to apply to new objects when no ACL is provided. writable
owner object The owner of the bucket. This will always be the project team's owner group.
owner. entity string The entity, in the form group- groupId .
owner. entityId string The ID for the entity.
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 object The bucket's website configuration.
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

Methods

Available methods for Buckets resources are as follows:

delete
Deletes an empty bucket.
get
Returns metadata for the specified bucket.
insert
Creates a new bucket.
list
Retrieves a list of buckets for a given project.
patch
Updates a bucket. This method supports patch semantics.
update
Updates a bucket.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.