REST Resource: projects.locations.buckets

Resource: LogBucket

Describes a repository of logs (Beta).

JSON representation
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "retentionDays": integer,
  "locked": boolean,
  "lifecycleState": enum (LifecycleState)
}
Fields
name

string

The resource name of the bucket. For example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id The supported locations are: "global"

For the location of global it is unspecified where logs are actually stored. Once a bucket has been created, the location can not be changed.

description

string

Describes this bucket.

createTime

string (Timestamp format)

Output only. The creation timestamp of the bucket. This is not set for any of the default buckets.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The last update timestamp of the bucket.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

retentionDays

integer

Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used.

locked

boolean

Whether the bucket has been locked. The retention period on a locked bucket may not be changed. Locked buckets may only be deleted if they are empty.

lifecycleState

enum (LifecycleState)

Output only. The bucket lifecycle state.

Methods

create

Creates a bucket that can be used to store log entries.

delete

Deletes a bucket.

get

Gets a bucket (Beta).

list

Lists buckets (Beta).

patch

Updates a bucket.

undelete

Undeletes a bucket.