Bucket (Cloud Storage JSON API v1 (Rev. 148) 1.25.0)

java.lang.Object
- java.util.AbstractMap<java.lang.String,java.lang.Object>
- - com.google.api.client.util.GenericData
  - - com.google.api.client.json.GenericJson
    - - com.google.api.services.storage.model.Bucket

All Implemented Interfaces:

java.lang.Cloneable, java.util.Map<java.lang.String,java.lang.Object>
```
public final class Bucket
extends com.google.api.client.json.GenericJson
```
A bucket.
This is the Java data model class that specifies how to parse/serialize into the JSON that is transmitted over HTTP when working with the Cloud Storage JSON API. For a detailed explanation see: https://developers.google.com/api-client-library/java/google-http-java-client/json

Author:

Google, Inc.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Bucket.Billing` The bucket's billing configuration.
`static class`	`Bucket.Cors` Model definition for BucketCors.
`static class`	`Bucket.Encryption` Encryption configuration for a bucket.
`static class`	`Bucket.IamConfiguration` The bucket's IAM configuration.
`static class`	`Bucket.Lifecycle` The bucket's lifecycle configuration.
`static class`	`Bucket.Logging` The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.
`static class`	`Bucket.Owner` The owner of the bucket.
`static class`	`Bucket.RetentionPolicy` The bucket's retention policy.
`static class`	`Bucket.Versioning` The bucket's versioning configuration.
`static class`	`Bucket.Website` The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site.

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData
com.google.api.client.util.GenericData.Flags

Nested classes/interfaces inherited from class java.util.AbstractMap
java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map
java.util.Map.Entry<K,V>

Constructor Summary

Constructors
Constructor and Description

Bucket()

Constructors
Constructor and Description
`Bucket()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Bucket`	`clone()`
`java.util.List<BucketAccessControl>`	`getAcl()` Access controls on the bucket.
`Bucket.Billing`	`getBilling()` The bucket's billing configuration.
`java.util.List<Bucket.Cors>`	`getCors()` The bucket's Cross-Origin Resource Sharing (CORS) configuration.
`java.lang.Boolean`	`getDefaultEventBasedHold()` The default value for event-based hold on newly created objects in this bucket.
`java.util.List<ObjectAccessControl>`	`getDefaultObjectAcl()` Default access controls to apply to new objects when no ACL is provided.
`Bucket.Encryption`	`getEncryption()` Encryption configuration for a bucket.
`java.lang.String`	`getEtag()` HTTP 1.1 Entity tag for the bucket.
`Bucket.IamConfiguration`	`getIamConfiguration()` The bucket's IAM configuration.
`java.lang.String`	`getId()` The ID of the bucket.
`java.lang.String`	`getKind()` The kind of item this is.
`java.util.Map<java.lang.String,java.lang.String>`	`getLabels()` User-provided labels, in key/value pairs.
`Bucket.Lifecycle`	`getLifecycle()` The bucket's lifecycle configuration.
`java.lang.String`	`getLocation()` The location of the bucket.
`Bucket.Logging`	`getLogging()` The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.
`java.lang.Long`	`getMetageneration()` The metadata generation of this bucket.
`java.lang.String`	`getName()` The name of the bucket.
`Bucket.Owner`	`getOwner()` The owner of the bucket.
`java.math.BigInteger`	`getProjectNumber()` The project number of the project the bucket belongs to.
`Bucket.RetentionPolicy`	`getRetentionPolicy()` The bucket's retention policy.
`java.lang.String`	`getSelfLink()` The URI of this bucket.
`java.lang.String`	`getStorageClass()` The bucket's default storage class, used whenever no storageClass is specified for a newly- created object.
`com.google.api.client.util.DateTime`	`getTimeCreated()` The creation time of the bucket in RFC 3339 format.
`com.google.api.client.util.DateTime`	`getUpdated()` The modification time of the bucket in RFC 3339 format.
`Bucket.Versioning`	`getVersioning()` The bucket's versioning configuration.
`Bucket.Website`	`getWebsite()` The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site.
`Bucket`	`set(java.lang.String fieldName, java.lang.Object value)`
`Bucket`	`setAcl(java.util.List<BucketAccessControl> acl)` Access controls on the bucket.
`Bucket`	`setBilling(Bucket.Billing billing)` The bucket's billing configuration.
`Bucket`	`setCors(java.util.List<Bucket.Cors> cors)` The bucket's Cross-Origin Resource Sharing (CORS) configuration.
`Bucket`	`setDefaultEventBasedHold(java.lang.Boolean defaultEventBasedHold)` The default value for event-based hold on newly created objects in this bucket.
`Bucket`	`setDefaultObjectAcl(java.util.List<ObjectAccessControl> defaultObjectAcl)` Default access controls to apply to new objects when no ACL is provided.
`Bucket`	`setEncryption(Bucket.Encryption encryption)` Encryption configuration for a bucket.
`Bucket`	`setEtag(java.lang.String etag)` HTTP 1.1 Entity tag for the bucket.
`Bucket`	`setIamConfiguration(Bucket.IamConfiguration iamConfiguration)` The bucket's IAM configuration.
`Bucket`	`setId(java.lang.String id)` The ID of the bucket.
`Bucket`	`setKind(java.lang.String kind)` The kind of item this is.
`Bucket`	`setLabels(java.util.Map<java.lang.String,java.lang.String> labels)` User-provided labels, in key/value pairs.
`Bucket`	`setLifecycle(Bucket.Lifecycle lifecycle)` The bucket's lifecycle configuration.
`Bucket`	`setLocation(java.lang.String location)` The location of the bucket.
`Bucket`	`setLogging(Bucket.Logging logging)` The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.
`Bucket`	`setMetageneration(java.lang.Long metageneration)` The metadata generation of this bucket.
`Bucket`	`setName(java.lang.String name)` The name of the bucket.
`Bucket`	`setOwner(Bucket.Owner owner)` The owner of the bucket.
`Bucket`	`setProjectNumber(java.math.BigInteger projectNumber)` The project number of the project the bucket belongs to.
`Bucket`	`setRetentionPolicy(Bucket.RetentionPolicy retentionPolicy)` The bucket's retention policy.
`Bucket`	`setSelfLink(java.lang.String selfLink)` The URI of this bucket.
`Bucket`	`setStorageClass(java.lang.String storageClass)` The bucket's default storage class, used whenever no storageClass is specified for a newly- created object.
`Bucket`	`setTimeCreated(com.google.api.client.util.DateTime timeCreated)` The creation time of the bucket in RFC 3339 format.
`Bucket`	`setUpdated(com.google.api.client.util.DateTime updated)` The modification time of the bucket in RFC 3339 format.
`Bucket`	`setVersioning(Bucket.Versioning versioning)` The bucket's versioning configuration.
`Bucket`	`setWebsite(Bucket.Website website)` The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site.

Methods inherited from class com.google.api.client.json.GenericJson
getFactory, setFactory, toPrettyString, toString

Methods inherited from class com.google.api.client.util.GenericData
entrySet, get, getClassInfo, getUnknownKeys, put, putAll, remove, setUnknownKeys

Methods inherited from class java.util.AbstractMap
clear, containsKey, containsValue, equals, hashCode, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Constructor Detail
  - Bucket
```
public Bucket()
```
- Method Detail
  - getAcl
```
public java.util.List<BucketAccessControl> getAcl()
```
    Access controls on the bucket.
    
    Returns:
    
    value or null for none
  - setAcl
```
public Bucket setAcl(java.util.List<BucketAccessControl> acl)
```
    Access controls on the bucket.
    
    Parameters:
    
    acl - acl or null for none
  - getBilling
```
public Bucket.Billing getBilling()
```
    The bucket's billing configuration.
    
    Returns:
    
    value or null for none
  - setBilling
```
public Bucket setBilling(Bucket.Billing billing)
```
    The bucket's billing configuration.
    
    Parameters:
    
    billing - billing or null for none
  - getCors
```
public java.util.List<Bucket.Cors> getCors()
```
    The bucket's Cross-Origin Resource Sharing (CORS) configuration.
    
    Returns:
    
    value or null for none
  - setCors
```
public Bucket setCors(java.util.List<Bucket.Cors> cors)
```
    The bucket's Cross-Origin Resource Sharing (CORS) configuration.
    
    Parameters:
    
    cors - cors or null for none
  - getDefaultEventBasedHold
```
public java.lang.Boolean getDefaultEventBasedHold()
```
    The default value for event-based hold on newly created objects in this bucket. Event-based hold is a way to retain objects indefinitely until an event occurs, signified by the hold's release. After being released, such objects will be subject to bucket-level retention (if any). One sample use case of this flag is for banks to hold loan documents for at least 3 years after loan is paid in full. Here, bucket-level retention is 3 years and the event is loan being paid in full. In this example, these objects will be held intact for any number of years until the event has occurred (event-based hold on the object is released) and then 3 more years after that. That means retention duration of the objects begins from the moment event-based hold transitioned from true to false. Objects under event-based hold cannot be deleted, overwritten or archived until the hold is removed.
    
    Returns:
    
    value or null for none
  - setDefaultEventBasedHold
```
public Bucket setDefaultEventBasedHold(java.lang.Boolean defaultEventBasedHold)
```
    The default value for event-based hold on newly created objects in this bucket. Event-based hold is a way to retain objects indefinitely until an event occurs, signified by the hold's release. After being released, such objects will be subject to bucket-level retention (if any). One sample use case of this flag is for banks to hold loan documents for at least 3 years after loan is paid in full. Here, bucket-level retention is 3 years and the event is loan being paid in full. In this example, these objects will be held intact for any number of years until the event has occurred (event-based hold on the object is released) and then 3 more years after that. That means retention duration of the objects begins from the moment event-based hold transitioned from true to false. Objects under event-based hold cannot be deleted, overwritten or archived until the hold is removed.
    
    Parameters:
    
    defaultEventBasedHold - defaultEventBasedHold or null for none
  - getDefaultObjectAcl
```
public java.util.List<ObjectAccessControl> getDefaultObjectAcl()
```
    Default access controls to apply to new objects when no ACL is provided.
    
    Returns:
    
    value or null for none
  - setDefaultObjectAcl
```
public Bucket setDefaultObjectAcl(java.util.List<ObjectAccessControl> defaultObjectAcl)
```
    Default access controls to apply to new objects when no ACL is provided.
    
    Parameters:
    
    defaultObjectAcl - defaultObjectAcl or null for none
  - getEncryption
```
public Bucket.Encryption getEncryption()
```
    Encryption configuration for a bucket.
    
    Returns:
    
    value or null for none
  - setEncryption
```
public Bucket setEncryption(Bucket.Encryption encryption)
```
    Encryption configuration for a bucket.
    
    Parameters:
    
    encryption - encryption or null for none
  - getEtag
```
public java.lang.String getEtag()
```
    HTTP 1.1 Entity tag for the bucket.
    
    Returns:
    
    value or null for none
  - setEtag
```
public Bucket setEtag(java.lang.String etag)
```
    HTTP 1.1 Entity tag for the bucket.
    
    Parameters:
    
    etag - etag or null for none
  - getIamConfiguration
```
public Bucket.IamConfiguration getIamConfiguration()
```
    The bucket's IAM configuration.
    
    Returns:
    
    value or null for none
  - setIamConfiguration
```
public Bucket setIamConfiguration(Bucket.IamConfiguration iamConfiguration)
```
    The bucket's IAM configuration.
    
    Parameters:
    
    iamConfiguration - iamConfiguration or null for none
  - getId
```
public java.lang.String getId()
```
    The ID of the bucket. For buckets, the id and name properties are the same.
    
    Returns:
    
    value or null for none
  - setId
```
public Bucket setId(java.lang.String id)
```
    The ID of the bucket. For buckets, the id and name properties are the same.
    
    Parameters:
    
    id - id or null for none
  - getKind
```
public java.lang.String getKind()
```
    The kind of item this is. For buckets, this is always storage#bucket.
    
    Returns:
    
    value or null for none
  - setKind
```
public Bucket setKind(java.lang.String kind)
```
    The kind of item this is. For buckets, this is always storage#bucket.
    
    Parameters:
    
    kind - kind or null for none
  - getLabels
```
public java.util.Map<java.lang.String,java.lang.String> getLabels()
```
    User-provided labels, in key/value pairs.
    
    Returns:
    
    value or null for none
  - setLabels
```
public Bucket setLabels(java.util.Map<java.lang.String,java.lang.String> labels)
```
    User-provided labels, in key/value pairs.
    
    Parameters:
    
    labels - labels or null for none
  - getLifecycle
```
public Bucket.Lifecycle getLifecycle()
```
    The bucket's lifecycle configuration. See lifecycle management for more information.
    
    Returns:
    
    value or null for none
  - setLifecycle
```
public Bucket setLifecycle(Bucket.Lifecycle lifecycle)
```
    The bucket's lifecycle configuration. See lifecycle management for more information.
    
    Parameters:
    
    lifecycle - lifecycle or null for none
  - getLocation
```
public java.lang.String getLocation()
```
    The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. Defaults to US. See the developer's guide for the authoritative list.
    
    Returns:
    
    value or null for none
  - setLocation
```
public Bucket setLocation(java.lang.String location)
```
    The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. Defaults to US. See the developer's guide for the authoritative list.
    
    Parameters:
    
    location - location or null for none
  - getLogging
```
public Bucket.Logging getLogging()
```
    The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.
    
    Returns:
    
    value or null for none
  - setLogging
```
public Bucket setLogging(Bucket.Logging logging)
```
    The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.
    
    Parameters:
    
    logging - logging or null for none
  - getMetageneration
```
public java.lang.Long getMetageneration()
```
    The metadata generation of this bucket.
    
    Returns:
    
    value or null for none
  - setMetageneration
```
public Bucket setMetageneration(java.lang.Long metageneration)
```
    The metadata generation of this bucket.
    
    Parameters:
    
    metageneration - metageneration or null for none
  - getName
```
public java.lang.String getName()
```
    The name of the bucket.
    
    Returns:
    
    value or null for none
  - setName
```
public Bucket setName(java.lang.String name)
```
    The name of the bucket.
    
    Parameters:
    
    name - name or null for none
  - getOwner
```
public Bucket.Owner getOwner()
```
    The owner of the bucket. This is always the project team's owner group.
    
    Returns:
    
    value or null for none
  - setOwner
```
public Bucket setOwner(Bucket.Owner owner)
```
    The owner of the bucket. This is always the project team's owner group.
    
    Parameters:
    
    owner - owner or null for none
  - getProjectNumber
```
public java.math.BigInteger getProjectNumber()
```
    The project number of the project the bucket belongs to.
    
    Returns:
    
    value or null for none
  - setProjectNumber
```
public Bucket setProjectNumber(java.math.BigInteger projectNumber)
```
    The project number of the project the bucket belongs to.
    
    Parameters:
    
    projectNumber - projectNumber or null for none
  - getRetentionPolicy
```
public Bucket.RetentionPolicy getRetentionPolicy()
```
    The bucket's retention policy. The retention policy enforces a minimum retention time for all objects contained in the bucket, based on their creation time. Any attempt to overwrite or delete objects younger than the retention period will result in a PERMISSION_DENIED error. An unlocked retention policy can be modified or removed from the bucket via a storage.buckets.update operation. A locked retention policy cannot be removed or shortened in duration for the lifetime of the bucket. Attempting to remove or decrease period of a locked retention policy will result in a PERMISSION_DENIED error.
    
    Returns:
    
    value or null for none
  - setRetentionPolicy
```
public Bucket setRetentionPolicy(Bucket.RetentionPolicy retentionPolicy)
```
    The bucket's retention policy. The retention policy enforces a minimum retention time for all objects contained in the bucket, based on their creation time. Any attempt to overwrite or delete objects younger than the retention period will result in a PERMISSION_DENIED error. An unlocked retention policy can be modified or removed from the bucket via a storage.buckets.update operation. A locked retention policy cannot be removed or shortened in duration for the lifetime of the bucket. Attempting to remove or decrease period of a locked retention policy will result in a PERMISSION_DENIED error.
    
    Parameters:
    
    retentionPolicy - retentionPolicy or null for none
  - getSelfLink
```
public java.lang.String getSelfLink()
```
    The URI of this bucket.
    
    Returns:
    
    value or null for none
  - setSelfLink
```
public Bucket setSelfLink(java.lang.String selfLink)
```
    The URI of this bucket.
    
    Parameters:
    
    selfLink - selfLink or null for none
  - getStorageClass
```
public java.lang.String getStorageClass()
```
    The bucket's default storage class, used whenever no storageClass is specified for a newly- created object. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include MULTI_REGIONAL, REGIONAL, STANDARD, NEARLINE, COLDLINE, and DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket is created, it will default to STANDARD. For more information, see storage classes.
    
    Returns:
    
    value or null for none
  - setStorageClass
```
public Bucket setStorageClass(java.lang.String storageClass)
```
    The bucket's default storage class, used whenever no storageClass is specified for a newly- created object. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include MULTI_REGIONAL, REGIONAL, STANDARD, NEARLINE, COLDLINE, and DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket is created, it will default to STANDARD. For more information, see storage classes.
    
    Parameters:
    
    storageClass - storageClass or null for none
  - getTimeCreated
```
public com.google.api.client.util.DateTime getTimeCreated()
```
    The creation time of the bucket in RFC 3339 format.
    
    Returns:
    
    value or null for none
  - setTimeCreated
```
public Bucket setTimeCreated(com.google.api.client.util.DateTime timeCreated)
```
    The creation time of the bucket in RFC 3339 format.
    
    Parameters:
    
    timeCreated - timeCreated or null for none
  - getUpdated
```
public com.google.api.client.util.DateTime getUpdated()
```
    The modification time of the bucket in RFC 3339 format.
    
    Returns:
    
    value or null for none
  - setUpdated
```
public Bucket setUpdated(com.google.api.client.util.DateTime updated)
```
    The modification time of the bucket in RFC 3339 format.
    
    Parameters:
    
    updated - updated or null for none
  - getVersioning
```
public Bucket.Versioning getVersioning()
```
    The bucket's versioning configuration.
    
    Returns:
    
    value or null for none
  - setVersioning
```
public Bucket setVersioning(Bucket.Versioning versioning)
```
    The bucket's versioning configuration.
    
    Parameters:
    
    versioning - versioning or null for none
  - getWebsite
```
public Bucket.Website getWebsite()
```
    The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site. See the Static Website Examples for more information.
    
    Returns:
    
    value or null for none
  - setWebsite
```
public Bucket setWebsite(Bucket.Website website)
```
    The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site. See the Static Website Examples for more information.
    
    Parameters:
    
    website - website or null for none
  - set
```
public Bucket set(java.lang.String fieldName,
                  java.lang.Object value)
```
    Overrides:
    
    set in class com.google.api.client.json.GenericJson
  - clone
```
public Bucket clone()
```
    Overrides:
    
    clone in class com.google.api.client.json.GenericJson

Cloud Storage JSON API v1 (revision 148)

Class Bucket

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

Nested classes/interfaces inherited from class java.util.AbstractMap

Nested classes/interfaces inherited from interface java.util.Map

Constructor Summary

Method Summary

Methods inherited from class com.google.api.client.json.GenericJson

Methods inherited from class com.google.api.client.util.GenericData

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Detail

Bucket

Method Detail

getAcl

setAcl

getBilling

setBilling

getCors

setCors

getDefaultEventBasedHold

setDefaultEventBasedHold

getDefaultObjectAcl

setDefaultObjectAcl

getEncryption

setEncryption

getEtag

setEtag

getIamConfiguration

setIamConfiguration

getId

setId

getKind

setKind

getLabels

setLabels

getLifecycle

setLifecycle

getLocation

setLocation

getLogging

setLogging

getMetageneration

setMetageneration

getName

setName

getOwner

setOwner

getProjectNumber

setProjectNumber

getRetentionPolicy

setRetentionPolicy

getSelfLink

setSelfLink

getStorageClass

setStorageClass

getTimeCreated

setTimeCreated

getUpdated

setUpdated

getVersioning

setVersioning

getWebsite

setWebsite

set

clone