Class: Google::Apis::StorageV1::Bucket
- Inherits:
-
Object
- Object
- Google::Apis::StorageV1::Bucket
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- generated/google/apis/storage_v1/classes.rb,
generated/google/apis/storage_v1/representations.rb,
generated/google/apis/storage_v1/representations.rb
Overview
A bucket.
Defined Under Namespace
Classes: Billing, CorsConfiguration, Encryption, Lifecycle, Logging, Owner, RetentionPolicy, Versioning, Website
Instance Attribute Summary collapse
-
#acl ⇒ Array<Google::Apis::StorageV1::BucketAccessControl>
Access controls on the bucket.
-
#billing ⇒ Google::Apis::StorageV1::Bucket::Billing
The bucket's billing configuration.
-
#cors_configurations ⇒ Array<Google::Apis::StorageV1::Bucket::CorsConfiguration>
The bucket's Cross-Origin Resource Sharing (CORS) configuration.
-
#default_event_based_hold ⇒ Boolean
(also: #default_event_based_hold?)
The default value for event-based hold on newly created objects in this bucket.
-
#default_object_acl ⇒ Array<Google::Apis::StorageV1::ObjectAccessControl>
Default access controls to apply to new objects when no ACL is provided.
-
#encryption ⇒ Google::Apis::StorageV1::Bucket::Encryption
Encryption configuration for a bucket.
-
#etag ⇒ String
HTTP 1.1 Entity tag for the bucket.
-
#id ⇒ String
The ID of the bucket.
-
#kind ⇒ String
The kind of item this is.
-
#labels ⇒ Hash<String,String>
User-provided labels, in key/value pairs.
-
#lifecycle ⇒ Google::Apis::StorageV1::Bucket::Lifecycle
The bucket's lifecycle configuration.
-
#location ⇒ String
The location of the bucket.
-
#logging ⇒ Google::Apis::StorageV1::Bucket::Logging
The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.
-
#metageneration ⇒ Fixnum
The metadata generation of this bucket.
-
#name ⇒ String
The name of the bucket.
-
#owner ⇒ Google::Apis::StorageV1::Bucket::Owner
The owner of the bucket.
-
#project_number ⇒ Fixnum
The project number of the project the bucket belongs to.
-
#retention_policy ⇒ Google::Apis::StorageV1::Bucket::RetentionPolicy
The bucket's retention policy.
-
#self_link ⇒ String
The URI of this bucket.
-
#storage_class ⇒ String
The bucket's default storage class, used whenever no storageClass is specified for a newly-created object.
-
#time_created ⇒ DateTime
The creation time of the bucket in RFC 3339 format.
-
#updated ⇒ DateTime
The modification time of the bucket in RFC 3339 format.
-
#versioning ⇒ Google::Apis::StorageV1::Bucket::Versioning
The bucket's versioning configuration.
-
#website ⇒ Google::Apis::StorageV1::Bucket::Website
The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site.
Instance Method Summary collapse
-
#initialize(**args) ⇒ Bucket
constructor
A new instance of Bucket.
-
#update!(**args) ⇒ Object
Update properties of this object.
Methods included from Core::JsonObjectSupport
Methods included from Core::Hashable
Constructor Details
#initialize(**args) ⇒ Bucket
Returns a new instance of Bucket
180 181 182 |
# File 'generated/google/apis/storage_v1/classes.rb', line 180 def initialize(**args) update!(**args) end |
Instance Attribute Details
#acl ⇒ Array<Google::Apis::StorageV1::BucketAccessControl>
Access controls on the bucket.
Corresponds to the JSON property acl
32 33 34 |
# File 'generated/google/apis/storage_v1/classes.rb', line 32 def acl @acl end |
#billing ⇒ Google::Apis::StorageV1::Bucket::Billing
The bucket's billing configuration.
Corresponds to the JSON property billing
37 38 39 |
# File 'generated/google/apis/storage_v1/classes.rb', line 37 def billing @billing end |
#cors_configurations ⇒ Array<Google::Apis::StorageV1::Bucket::CorsConfiguration>
The bucket's Cross-Origin Resource Sharing (CORS) configuration.
Corresponds to the JSON property cors
42 43 44 |
# File 'generated/google/apis/storage_v1/classes.rb', line 42 def cors_configurations @cors_configurations end |
#default_event_based_hold ⇒ Boolean Also known as: default_event_based_hold?
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.
Corresponds to the JSON property defaultEventBasedHold
58 59 60 |
# File 'generated/google/apis/storage_v1/classes.rb', line 58 def default_event_based_hold @default_event_based_hold end |
#default_object_acl ⇒ Array<Google::Apis::StorageV1::ObjectAccessControl>
Default access controls to apply to new objects when no ACL is provided.
Corresponds to the JSON property defaultObjectAcl
64 65 66 |
# File 'generated/google/apis/storage_v1/classes.rb', line 64 def default_object_acl @default_object_acl end |
#encryption ⇒ Google::Apis::StorageV1::Bucket::Encryption
Encryption configuration for a bucket.
Corresponds to the JSON property encryption
69 70 71 |
# File 'generated/google/apis/storage_v1/classes.rb', line 69 def encryption @encryption end |
#etag ⇒ String
HTTP 1.1 Entity tag for the bucket.
Corresponds to the JSON property etag
74 75 76 |
# File 'generated/google/apis/storage_v1/classes.rb', line 74 def etag @etag end |
#id ⇒ String
The ID of the bucket. For buckets, the id and name properties are the same.
Corresponds to the JSON property id
79 80 81 |
# File 'generated/google/apis/storage_v1/classes.rb', line 79 def id @id end |
#kind ⇒ String
The kind of item this is. For buckets, this is always storage#bucket.
Corresponds to the JSON property kind
84 85 86 |
# File 'generated/google/apis/storage_v1/classes.rb', line 84 def kind @kind end |
#labels ⇒ Hash<String,String>
User-provided labels, in key/value pairs.
Corresponds to the JSON property labels
89 90 91 |
# File 'generated/google/apis/storage_v1/classes.rb', line 89 def labels @labels end |
#lifecycle ⇒ Google::Apis::StorageV1::Bucket::Lifecycle
The bucket's lifecycle configuration. See lifecycle management for more
information.
Corresponds to the JSON property lifecycle
95 96 97 |
# File 'generated/google/apis/storage_v1/classes.rb', line 95 def lifecycle @lifecycle end |
#location ⇒ String
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.
Corresponds to the JSON property location
102 103 104 |
# File 'generated/google/apis/storage_v1/classes.rb', line 102 def location @location end |
#logging ⇒ Google::Apis::StorageV1::Bucket::Logging
The bucket's logging configuration, which defines the destination bucket and
optional name prefix for the current bucket's logs.
Corresponds to the JSON property logging
108 109 110 |
# File 'generated/google/apis/storage_v1/classes.rb', line 108 def logging @logging end |
#metageneration ⇒ Fixnum
The metadata generation of this bucket.
Corresponds to the JSON property metageneration
113 114 115 |
# File 'generated/google/apis/storage_v1/classes.rb', line 113 def @metageneration end |
#name ⇒ String
The name of the bucket.
Corresponds to the JSON property name
118 119 120 |
# File 'generated/google/apis/storage_v1/classes.rb', line 118 def name @name end |
#owner ⇒ Google::Apis::StorageV1::Bucket::Owner
The owner of the bucket. This is always the project team's owner group.
Corresponds to the JSON property owner
123 124 125 |
# File 'generated/google/apis/storage_v1/classes.rb', line 123 def owner @owner end |
#project_number ⇒ Fixnum
The project number of the project the bucket belongs to.
Corresponds to the JSON property projectNumber
128 129 130 |
# File 'generated/google/apis/storage_v1/classes.rb', line 128 def project_number @project_number end |
#retention_policy ⇒ Google::Apis::StorageV1::Bucket::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.
Corresponds to the JSON property retentionPolicy
141 142 143 |
# File 'generated/google/apis/storage_v1/classes.rb', line 141 def retention_policy @retention_policy end |
#self_link ⇒ String
The URI of this bucket.
Corresponds to the JSON property selfLink
146 147 148 |
# File 'generated/google/apis/storage_v1/classes.rb', line 146 def self_link @self_link end |
#storage_class ⇒ String
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.
Corresponds to the JSON property storageClass
156 157 158 |
# File 'generated/google/apis/storage_v1/classes.rb', line 156 def storage_class @storage_class end |
#time_created ⇒ DateTime
The creation time of the bucket in RFC 3339 format.
Corresponds to the JSON property timeCreated
161 162 163 |
# File 'generated/google/apis/storage_v1/classes.rb', line 161 def time_created @time_created end |
#updated ⇒ DateTime
The modification time of the bucket in RFC 3339 format.
Corresponds to the JSON property updated
166 167 168 |
# File 'generated/google/apis/storage_v1/classes.rb', line 166 def updated @updated end |
#versioning ⇒ Google::Apis::StorageV1::Bucket::Versioning
The bucket's versioning configuration.
Corresponds to the JSON property versioning
171 172 173 |
# File 'generated/google/apis/storage_v1/classes.rb', line 171 def versioning @versioning end |
#website ⇒ Google::Apis::StorageV1::Bucket::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.
Corresponds to the JSON property website
178 179 180 |
# File 'generated/google/apis/storage_v1/classes.rb', line 178 def website @website end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 |
# File 'generated/google/apis/storage_v1/classes.rb', line 185 def update!(**args) @acl = args[:acl] if args.key?(:acl) @billing = args[:billing] if args.key?(:billing) @cors_configurations = args[:cors_configurations] if args.key?(:cors_configurations) @default_event_based_hold = args[:default_event_based_hold] if args.key?(:default_event_based_hold) @default_object_acl = args[:default_object_acl] if args.key?(:default_object_acl) @encryption = args[:encryption] if args.key?(:encryption) @etag = args[:etag] if args.key?(:etag) @id = args[:id] if args.key?(:id) @kind = args[:kind] if args.key?(:kind) @labels = args[:labels] if args.key?(:labels) @lifecycle = args[:lifecycle] if args.key?(:lifecycle) @location = args[:location] if args.key?(:location) @logging = args[:logging] if args.key?(:logging) @metageneration = args[:metageneration] if args.key?(:metageneration) @name = args[:name] if args.key?(:name) @owner = args[:owner] if args.key?(:owner) @project_number = args[:project_number] if args.key?(:project_number) @retention_policy = args[:retention_policy] if args.key?(:retention_policy) @self_link = args[:self_link] if args.key?(:self_link) @storage_class = args[:storage_class] if args.key?(:storage_class) @time_created = args[:time_created] if args.key?(:time_created) @updated = args[:updated] if args.key?(:updated) @versioning = args[:versioning] if args.key?(:versioning) @website = args[:website] if args.key?(:website) end |