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

{
  "kind": "storage#bucket",
  "id": string,
  "selfLink": string,
  "projectNumber": unsigned long,
  "name": string,
  "timeCreated": datetime,
  "metageneration": long,
  "acl": [
    bucketAccessControls Resource
  ],
  "defaultObjectAcl": [
    defaultObjectAccessControls Resource
  ],
  "owner": {
    "entity": string,
    "entityId": string
  },
  "location": string,
  "website": {
    "mainPageSuffix": string,
    "notFoundPage": string
  },
  "logging": {
    "logBucket": string,
    "logObjectPrefix": string
  },
  "versioning": {
    "enabled": boolean
  },
  "cors": [
    {
      "origin": [
        string
      ],
      "method": [
        string
      ],
      "responseHeader": [
        string
      ],
      "maxAgeSeconds": integer
    }
  ],
  "lifecycle": {
    "rule": [
      {
        "action": {
          "type": string
        },
        "condition": {
          "age": integer,
          "createdBefore": date,
          "isLive": boolean,
          "numNewerVersions": integer
        }
      }
    ]
  },
  "storageClass": string,
  "etag": string
}

Methods

Available methods for Buckets resources are as follows:

delete

Permanently 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.