- 2.58.1 (latest)
- 2.58.0
- 2.57.0
- 2.56.0
- 2.55.0
- 2.54.0
- 2.53.3
- 2.52.3
- 2.50.0
- 2.49.0
- 2.48.2
- 2.47.0
- 2.46.0
- 2.45.0
- 2.44.1
- 2.43.2
- 2.42.0
- 2.41.0
- 2.40.1
- 2.39.0
- 2.38.0
- 2.37.0
- 2.36.1
- 2.34.0
- 2.33.0
- 2.32.1
- 2.30.1
- 2.29.1
- 2.28.0
- 2.27.1
- 2.24.0
- 2.23.0
- 2.22.6
- 2.21.0
- 2.20.2
- 2.19.0
- 2.18.0
- 2.17.2
- 2.16.0
- 2.15.1
- 2.14.0
- 2.13.1
- 2.12.0
- 2.11.3
- 2.10.0
- 2.9.3
- 2.8.1
- 2.7.1
- 2.6.1
- 2.5.1
- 2.4.5
- 2.3.0
- 2.2.3
- 2.1.10
public class BucketInfo implements SerializableGoogle Storage bucket metadata; See Also: Concepts and Terminology
Implements
SerializableStatic Methods
newBuilder(String name)
public static BucketInfo.Builder newBuilder(String name)Returns a BucketInfo builder where the bucket's name is set to the provided name.
| Name | Description |
| name | String |
| Type | Description |
| BucketInfo.Builder |
of(String name)
public static BucketInfo of(String name)Creates a BucketInfo object for the provided bucket name.
| Name | Description |
| name | String |
| Type | Description |
| BucketInfo |
Methods
equals(Object obj)
public boolean equals(Object obj)| Name | Description |
| obj | Object |
| Type | Description |
| boolean |
getAcl()
public List<Acl> getAcl()Returns the bucket's access control configuration. See Also: About Access Control Lists
| Type | Description |
| List<Acl> |
getCors()
public List<Cors> getCors()Returns the bucket's Cross-Origin Resource Sharing (CORS) configuration. See Also: Cross-Origin Resource Sharing (CORS)
| Type | Description |
| List<Cors> |
getCreateTime()
public Long getCreateTime()Returns the time at which the bucket was created.
| Type | Description |
| Long |
getDefaultAcl()
public List<Acl> getDefaultAcl()Returns the default access control configuration for this bucket's blobs. See Also: About Access Control Lists
| Type | Description |
| List<Acl> |
getDefaultEventBasedHold()
public Boolean getDefaultEventBasedHold()Returns a Boolean with either true, null and in certain cases
false.
Case 1: true the field com.google.cloud.storage.Storage.BucketField#DEFAULT_EVENT_BASED_HOLD is selected in a Storage#get(String, Storage.BucketGetOption...) and default event-based hold for the bucket is
enabled.
Case 2.1: null the field com.google.cloud.storage.Storage.BucketField#DEFAULT_EVENT_BASED_HOLD is selected in a Storage#get(String, Storage.BucketGetOption...), but default event-based hold for the bucket
is not enabled. This case can be considered implicitly false.
Case 2.2: null the field com.google.cloud.storage.Storage.BucketField#DEFAULT_EVENT_BASED_HOLD is not selected in a
Storage#get(String, Storage.BucketGetOption...), and the state for this field is
unknown.
Case 3: false default event-based hold is explicitly set to false using in a Builder#setDefaultEventBasedHold(Boolean) client side for a follow-up request e.g. Storage#update(BucketInfo, Storage.BucketTargetOption...) in which case the value of default
event-based hold will remain false for the given instance.
| Type | Description |
| Boolean |
getDefaultKmsKeyName()
public String getDefaultKmsKeyName()Returns the default Cloud KMS key to be applied to newly inserted objects in this bucket.
| Type | Description |
| String |
getDeleteRules()
public List<? extends BucketInfo.DeleteRule> getDeleteRules()Returns bucket's lifecycle configuration as a number of delete rules. See Also: Lifecycle Management
| Type | Description |
| List<? extends com.google.cloud.storage.BucketInfo.DeleteRule> |
getEtag()
public String getEtag()Returns HTTP 1.1 Entity tag for the bucket. See Also: Entity Tags
| Type | Description |
| String |
getGeneratedId()
public String getGeneratedId()Returns the service-generated id for the bucket.
| Type | Description |
| String |
getIamConfiguration()
public BucketInfo.IamConfiguration getIamConfiguration()Returns the IAM configuration
| Type | Description |
| BucketInfo.IamConfiguration |
getIndexPage()
public String getIndexPage()Returns bucket's website index page. Behaves as the bucket's directory index where missing blobs are treated as potential directories.
| Type | Description |
| String |
getLabels()
public Map<String,String> getLabels()Returns the labels for this bucket.
| Type | Description |
| Map<String,String> |
getLifecycleRules()
public List<? extends BucketInfo.LifecycleRule> getLifecycleRules()| Type | Description |
| List<? extends com.google.cloud.storage.BucketInfo.LifecycleRule> |
getLocation()
public String getLocation()Returns the bucket's location. Data for blobs in the bucket resides in physical storage within this region or regions. See Also: Bucket Locations
| Type | Description |
| String |
getLocationType()
public String getLocationType()Returns the bucket's locationType. See Also: Bucket LocationType
| Type | Description |
| String |
getLogging()
public BucketInfo.Logging getLogging()Returns the Logging
| Type | Description |
| BucketInfo.Logging |
getMetageneration()
public Long getMetageneration()Returns the metadata generation of this bucket.
| Type | Description |
| Long |
getName()
public String getName()Returns the bucket's name.
| Type | Description |
| String |
getNotFoundPage()
public String getNotFoundPage()Returns the custom object to return when a requested resource is not found.
| Type | Description |
| String |
getOwner()
public Acl.Entity getOwner()Returns the bucket's owner. This is always the project team's owner group.
| Type | Description |
| Acl.Entity |
getRetentionEffectiveTime()
public Long getRetentionEffectiveTime()Returns the retention effective time a policy took effect if a retention policy is defined as a
Long.
| Type | Description |
| Long |
getRetentionPeriod()
public Long getRetentionPeriod()Returns the retention policy retention period.
| Type | Description |
| Long |
getRpo()
public Rpo getRpo()Returns the bucket's recovery point objective (RPO). This defines how quickly data is replicated between regions in a dual-region bucket. Not defined for single-region buckets. See Also: <a href="https://cloud.google.com/storage/docs/turbo-replication"Turbo Replication"
| Type | Description |
| Rpo |
getSelfLink()
public String getSelfLink()Returns the URI of this bucket as a string.
| Type | Description |
| String |
getStorageClass()
public StorageClass getStorageClass()Returns the bucket's storage class. This defines how blobs in the bucket are stored and determines the SLA and the cost of storage. See Also: Storage Classes
| Type | Description |
| StorageClass |
getUpdateTime()
public Long getUpdateTime()Returns the last modification time of the bucket's metadata expressed as the number of milliseconds since the Unix epoch.
| Type | Description |
| Long |
hashCode()
public int hashCode()| Type | Description |
| int |
requesterPays()
public Boolean requesterPays()Returns a Boolean with either true, false, and in a specific case
null.
Case 1: true the field com.google.cloud.storage.Storage.BucketField#BILLING
is selected in a Storage#get(String, Storage.BucketGetOption...) and requester pays for
the bucket is enabled.
Case 2: false the field com.google.cloud.storage.Storage.BucketField#BILLING
in a Storage#get(String, Storage.BucketGetOption...) is selected and requester pays for
the bucket is disable.
Case 3: null the field com.google.cloud.storage.Storage.BucketField#BILLING
in a Storage#get(String, Storage.BucketGetOption...) is not selected, the value is
unknown.
| Type | Description |
| Boolean |
retentionPolicyIsLocked()
public Boolean retentionPolicyIsLocked()Returns a Boolean with either true or null.
Case 1: true the field com.google.cloud.storage.Storage.BucketField#RETENTION_POLICY is selected in a Storage#get(String, Storage.BucketGetOption...) and retention policy for the bucket is locked.
Case 2.1: null the field com.google.cloud.storage.Storage.BucketField#RETENTION_POLICY is selected in a Storage#get(String, Storage.BucketGetOption...), but retention policy for the bucket is not
locked. This case can be considered implicitly false.
Case 2.2: null the field com.google.cloud.storage.Storage.BucketField#RETENTION_POLICY is not selected in a Storage#get(String, Storage.BucketGetOption...), and the state for this field is unknown.
| Type | Description |
| Boolean |
toBuilder()
public BucketInfo.Builder toBuilder()Returns a builder for the current bucket.
| Type | Description |
| BucketInfo.Builder |
toString()
public String toString()| Type | Description |
| String |
versioningEnabled()
public Boolean versioningEnabled()Returns a Boolean with either true, null and in certain cases
false.
Case 1: true the field com.google.cloud.storage.Storage.BucketField#VERSIONING is selected in a Storage#get(String, Storage.BucketGetOption...) and versions for the bucket is enabled.
Case 2.1: null the field com.google.cloud.storage.Storage.BucketField#VERSIONING is selected in a Storage#get(String, Storage.BucketGetOption...), but versions for the bucket is not enabled.
This case can be considered implicitly false.
Case 2.2: null the field com.google.cloud.storage.Storage.BucketField#VERSIONING is not selected in a Storage#get(String, Storage.BucketGetOption...), and the state for this field is unknown.
Case 3: false versions is explicitly set to false client side for a follow-up
request for example Storage#update(BucketInfo, Storage.BucketTargetOption...) in which
case the value of versions will remain false for for the given instance.
| Type | Description |
| Boolean |