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. | |
selfLink
|
string
|
The URI of this 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: