google-apis-storage_v1 0.29.0 → 0.54.0

data/lib/google/apis/storage_v1/classes.rb

@@ -22,6 +22,155 @@ module Google
   module Apis
     module StorageV1
       
+      # An AdvanceRelocateBucketOperation request.
+      class AdvanceRelocateBucketOperationRequest
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the time when the relocation will revert to the sync stage if the
+        # relocation hasn't succeeded.
+        # Corresponds to the JSON property `expireTime`
+        # @return [DateTime]
+        attr_accessor :expire_time
+      
+        # Specifies the duration after which the relocation will revert to the sync
+        # stage if the relocation hasn't succeeded. Optional, if not supplied, a default
+        # value of 12h will be used.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
+      # An Anywhere Cache instance.
+      class AnywhereCache
+        include Google::Apis::Core::Hashable
+      
+        # The cache-level entry admission policy.
+        # Corresponds to the JSON property `admissionPolicy`
+        # @return [String]
+        attr_accessor :admission_policy
+      
+        # The ID of the Anywhere cache instance.
+        # Corresponds to the JSON property `anywhereCacheId`
+        # @return [String]
+        attr_accessor :anywhere_cache_id
+      
+        # The name of the bucket containing this cache instance.
+        # Corresponds to the JSON property `bucket`
+        # @return [String]
+        attr_accessor :bucket
+      
+        # The creation time of the cache instance in RFC 3339 format.
+        # Corresponds to the JSON property `createTime`
+        # @return [DateTime]
+        attr_accessor :create_time
+      
+        # The ID of the resource, including the project number, bucket name and anywhere
+        # cache ID.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # The kind of item this is. For Anywhere Cache, this is always storage#
+        # anywhereCache.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # True if the cache instance has an active Update long-running operation.
+        # Corresponds to the JSON property `pendingUpdate`
+        # @return [Boolean]
+        attr_accessor :pending_update
+        alias_method :pending_update?, :pending_update
+      
+        # The link to this cache instance.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
+        # The current state of the cache instance.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # The TTL of all cache entries in whole seconds. e.g., "7200s".
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        # The modification time of the cache instance metadata in RFC 3339 format.
+        # Corresponds to the JSON property `updateTime`
+        # @return [DateTime]
+        attr_accessor :update_time
+      
+        # The zone in which the cache instance is running. For example, us-central1-a.
+        # Corresponds to the JSON property `zone`
+        # @return [String]
+        attr_accessor :zone
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @admission_policy = args[:admission_policy] if args.key?(:admission_policy)
+          @anywhere_cache_id = args[:anywhere_cache_id] if args.key?(:anywhere_cache_id)
+          @bucket = args[:bucket] if args.key?(:bucket)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @id = args[:id] if args.key?(:id)
+          @kind = args[:kind] if args.key?(:kind)
+          @pending_update = args[:pending_update] if args.key?(:pending_update)
+          @self_link = args[:self_link] if args.key?(:self_link)
+          @state = args[:state] if args.key?(:state)
+          @ttl = args[:ttl] if args.key?(:ttl)
+          @update_time = args[:update_time] if args.key?(:update_time)
+          @zone = args[:zone] if args.key?(:zone)
+        end
+      end
+      
+      # A list of Anywhere Caches.
+      class AnywhereCaches
+        include Google::Apis::Core::Hashable
+      
+        # The list of items.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::StorageV1::AnywhereCache>]
+        attr_accessor :items
+      
+        # The kind of item this is. For lists of Anywhere Caches, this is always storage#
+        # anywhereCaches.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The continuation token, used to page through large result sets. Provide this
+        # value in a subsequent request to return the next page of results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # A bucket.
       class Bucket
         include Google::Apis::Core::Hashable
@@ -83,6 +232,21 @@ module Google
         # @return [String]
         attr_accessor :etag
       
+        # The generation of this bucket.
+        # Corresponds to the JSON property `generation`
+        # @return [Fixnum]
+        attr_accessor :generation
+      
+        # The hard delete time of the bucket in RFC 3339 format.
+        # Corresponds to the JSON property `hardDeleteTime`
+        # @return [DateTime]
+        attr_accessor :hard_delete_time
+      
+        # The bucket's hierarchical namespace configuration.
+        # Corresponds to the JSON property `hierarchicalNamespace`
+        # @return [Google::Apis::StorageV1::Bucket::HierarchicalNamespace]
+        attr_accessor :hierarchical_namespace
+      
         # The bucket's IAM configuration.
         # Corresponds to the JSON property `iamConfiguration`
         # @return [Google::Apis::StorageV1::Bucket::IamConfiguration]
@@ -93,6 +257,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
+        # The bucket's IP filter configuration. Specifies the network sources that are
+        # allowed to access the operations on the bucket, as well as its underlying
+        # objects. Only enforced when the mode is set to 'Enabled'.
+        # Corresponds to the JSON property `ipFilter`
+        # @return [Google::Apis::StorageV1::Bucket::IpFilter]
+        attr_accessor :ip_filter
+      
         # The kind of item this is. For buckets, this is always storage#bucket.
         # Corresponds to the JSON property `kind`
         # @return [String]
@@ -103,15 +274,16 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The bucket's lifecycle configuration. See lifecycle management for more
-        # information.
+        # The bucket's lifecycle configuration. See [Lifecycle Management](https://cloud.
+        # google.com/storage/docs/lifecycle) for more information.
         # Corresponds to the JSON property `lifecycle`
         # @return [Google::Apis::StorageV1::Bucket::Lifecycle]
         attr_accessor :lifecycle
       
         # 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.
+        # physical storage within this region. Defaults to US. See the [Developer's
+        # Guide](https://cloud.google.com/storage/docs/locations) for the authoritative
+        # list.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -171,6 +343,12 @@ module Google
         # @return [String]
         attr_accessor :rpo
       
+        # Reserved for future use.
+        # Corresponds to the JSON property `satisfiesPZI`
+        # @return [Boolean]
+        attr_accessor :satisfies_pzi
+        alias_method :satisfies_pzi?, :satisfies_pzi
+      
         # Reserved for future use.
         # Corresponds to the JSON property `satisfiesPZS`
         # @return [Boolean]
@@ -188,13 +366,18 @@ module Google
         # @return [Google::Apis::StorageV1::Bucket::SoftDeletePolicy]
         attr_accessor :soft_delete_policy
       
+        # The soft delete time of the bucket in RFC 3339 format.
+        # Corresponds to the JSON property `softDeleteTime`
+        # @return [DateTime]
+        attr_accessor :soft_delete_time
+      
         # 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, ARCHIVE, 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.
+        # is created, it will default to STANDARD. For more information, see [Storage
+        # Classes](https://cloud.google.com/storage/docs/storage-classes).
         # Corresponds to the JSON property `storageClass`
         # @return [String]
         attr_accessor :storage_class
@@ -215,8 +398,8 @@ module Google
         attr_accessor :versioning
       
         # 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.
+        # accessing bucket contents as a web site. See the [Static Website Examples](
+        # https://cloud.google.com/storage/docs/static-website) for more information.
         # Corresponds to the JSON property `website`
         # @return [Google::Apis::StorageV1::Bucket::Website]
         attr_accessor :website
@@ -236,8 +419,12 @@ module Google
           @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)
+          @generation = args[:generation] if args.key?(:generation)
+          @hard_delete_time = args[:hard_delete_time] if args.key?(:hard_delete_time)
+          @hierarchical_namespace = args[:hierarchical_namespace] if args.key?(:hierarchical_namespace)
           @iam_configuration = args[:iam_configuration] if args.key?(:iam_configuration)
           @id = args[:id] if args.key?(:id)
+          @ip_filter = args[:ip_filter] if args.key?(:ip_filter)
           @kind = args[:kind] if args.key?(:kind)
           @labels = args[:labels] if args.key?(:labels)
           @lifecycle = args[:lifecycle] if args.key?(:lifecycle)
@@ -251,9 +438,11 @@ module Google
           @project_number = args[:project_number] if args.key?(:project_number)
           @retention_policy = args[:retention_policy] if args.key?(:retention_policy)
           @rpo = args[:rpo] if args.key?(:rpo)
+          @satisfies_pzi = args[:satisfies_pzi] if args.key?(:satisfies_pzi)
           @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
           @self_link = args[:self_link] if args.key?(:self_link)
           @soft_delete_policy = args[:soft_delete_policy] if args.key?(:soft_delete_policy)
+          @soft_delete_time = args[:soft_delete_time] if args.key?(:soft_delete_time)
           @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)
@@ -404,6 +593,26 @@ module Google
           end
         end
         
+        # The bucket's hierarchical namespace configuration.
+        class HierarchicalNamespace
+          include Google::Apis::Core::Hashable
+        
+          # When set to true, hierarchical namespace is enabled for this bucket.
+          # Corresponds to the JSON property `enabled`
+          # @return [Boolean]
+          attr_accessor :enabled
+          alias_method :enabled?, :enabled
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @enabled = args[:enabled] if args.key?(:enabled)
+          end
+        end
+        
         # The bucket's IAM configuration.
         class IamConfiguration
           include Google::Apis::Core::Hashable
@@ -502,8 +711,104 @@ module Google
           end
         end
         
-        # The bucket's lifecycle configuration. See lifecycle management for more
-        # information.
+        # The bucket's IP filter configuration. Specifies the network sources that are
+        # allowed to access the operations on the bucket, as well as its underlying
+        # objects. Only enforced when the mode is set to 'Enabled'.
+        class IpFilter
+          include Google::Apis::Core::Hashable
+        
+          # Whether to allow all service agents to access the bucket regardless of the IP
+          # filter configuration.
+          # Corresponds to the JSON property `allowAllServiceAgentAccess`
+          # @return [Boolean]
+          attr_accessor :allow_all_service_agent_access
+          alias_method :allow_all_service_agent_access?, :allow_all_service_agent_access
+        
+          # Whether to allow cross-org VPCs in the bucket's IP filter configuration.
+          # Corresponds to the JSON property `allowCrossOrgVpcs`
+          # @return [Boolean]
+          attr_accessor :allow_cross_org_vpcs
+          alias_method :allow_cross_org_vpcs?, :allow_cross_org_vpcs
+        
+          # The mode of the IP filter. Valid values are 'Enabled' and 'Disabled'.
+          # Corresponds to the JSON property `mode`
+          # @return [String]
+          attr_accessor :mode
+        
+          # The public network source of the bucket's IP filter.
+          # Corresponds to the JSON property `publicNetworkSource`
+          # @return [Google::Apis::StorageV1::Bucket::IpFilter::PublicNetworkSource]
+          attr_accessor :public_network_source
+        
+          # The list of [VPC network](https://cloud.google.com/vpc/docs/vpc) sources of
+          # the bucket's IP filter.
+          # Corresponds to the JSON property `vpcNetworkSources`
+          # @return [Array<Google::Apis::StorageV1::Bucket::IpFilter::VpcNetworkSource>]
+          attr_accessor :vpc_network_sources
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @allow_all_service_agent_access = args[:allow_all_service_agent_access] if args.key?(:allow_all_service_agent_access)
+            @allow_cross_org_vpcs = args[:allow_cross_org_vpcs] if args.key?(:allow_cross_org_vpcs)
+            @mode = args[:mode] if args.key?(:mode)
+            @public_network_source = args[:public_network_source] if args.key?(:public_network_source)
+            @vpc_network_sources = args[:vpc_network_sources] if args.key?(:vpc_network_sources)
+          end
+          
+          # The public network source of the bucket's IP filter.
+          class PublicNetworkSource
+            include Google::Apis::Core::Hashable
+          
+            # The list of public IPv4, IPv6 cidr ranges that are allowed to access the
+            # bucket.
+            # Corresponds to the JSON property `allowedIpCidrRanges`
+            # @return [Array<String>]
+            attr_accessor :allowed_ip_cidr_ranges
+          
+            def initialize(**args)
+               update!(**args)
+            end
+          
+            # Update properties of this object
+            def update!(**args)
+              @allowed_ip_cidr_ranges = args[:allowed_ip_cidr_ranges] if args.key?(:allowed_ip_cidr_ranges)
+            end
+          end
+          
+          # 
+          class VpcNetworkSource
+            include Google::Apis::Core::Hashable
+          
+            # The list of IPv4, IPv6 cidr ranges subnetworks that are allowed to access the
+            # bucket.
+            # Corresponds to the JSON property `allowedIpCidrRanges`
+            # @return [Array<String>]
+            attr_accessor :allowed_ip_cidr_ranges
+          
+            # Name of the network. Format: projects/`PROJECT_ID`/global/networks/`
+            # NETWORK_NAME`
+            # Corresponds to the JSON property `network`
+            # @return [String]
+            attr_accessor :network
+          
+            def initialize(**args)
+               update!(**args)
+            end
+          
+            # Update properties of this object
+            def update!(**args)
+              @allowed_ip_cidr_ranges = args[:allowed_ip_cidr_ranges] if args.key?(:allowed_ip_cidr_ranges)
+              @network = args[:network] if args.key?(:network)
+            end
+          end
+        end
+        
+        # The bucket's lifecycle configuration. See [Lifecycle Management](https://cloud.
+        # google.com/storage/docs/lifecycle) for more information.
         class Lifecycle
           include Google::Apis::Core::Hashable
         
@@ -809,7 +1114,7 @@ module Google
           # @return [DateTime]
           attr_accessor :effective_time
         
-          # The period of time in seconds, that soft-deleted objects in the bucket will be
+          # The duration in seconds that soft-deleted objects in the bucket will be
           # retained and cannot be permanently deleted.
           # Corresponds to the JSON property `retentionDurationSeconds`
           # @return [Fixnum]
@@ -847,8 +1152,8 @@ module Google
         end
         
         # 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.
+        # accessing bucket contents as a web site. See the [Static Website Examples](
+        # https://cloud.google.com/storage/docs/static-website) for more information.
         class Website
           include Google::Apis::Core::Hashable
         
@@ -1022,6 +1327,95 @@ module Google
         end
       end
       
+      # The storage layout configuration of a bucket.
+      class BucketStorageLayout
+        include Google::Apis::Core::Hashable
+      
+        # The name of the bucket.
+        # Corresponds to the JSON property `bucket`
+        # @return [String]
+        attr_accessor :bucket
+      
+        # The bucket's custom placement configuration for Custom Dual Regions.
+        # Corresponds to the JSON property `customPlacementConfig`
+        # @return [Google::Apis::StorageV1::BucketStorageLayout::CustomPlacementConfig]
+        attr_accessor :custom_placement_config
+      
+        # The bucket's hierarchical namespace configuration.
+        # Corresponds to the JSON property `hierarchicalNamespace`
+        # @return [Google::Apis::StorageV1::BucketStorageLayout::HierarchicalNamespace]
+        attr_accessor :hierarchical_namespace
+      
+        # The kind of item this is. For storage layout, this is always storage#
+        # storageLayout.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The location of the bucket.
+        # Corresponds to the JSON property `location`
+        # @return [String]
+        attr_accessor :location
+      
+        # The type of the bucket location.
+        # Corresponds to the JSON property `locationType`
+        # @return [String]
+        attr_accessor :location_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bucket = args[:bucket] if args.key?(:bucket)
+          @custom_placement_config = args[:custom_placement_config] if args.key?(:custom_placement_config)
+          @hierarchical_namespace = args[:hierarchical_namespace] if args.key?(:hierarchical_namespace)
+          @kind = args[:kind] if args.key?(:kind)
+          @location = args[:location] if args.key?(:location)
+          @location_type = args[:location_type] if args.key?(:location_type)
+        end
+        
+        # The bucket's custom placement configuration for Custom Dual Regions.
+        class CustomPlacementConfig
+          include Google::Apis::Core::Hashable
+        
+          # The list of regional locations in which data is placed.
+          # Corresponds to the JSON property `dataLocations`
+          # @return [Array<String>]
+          attr_accessor :data_locations
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @data_locations = args[:data_locations] if args.key?(:data_locations)
+          end
+        end
+        
+        # The bucket's hierarchical namespace configuration.
+        class HierarchicalNamespace
+          include Google::Apis::Core::Hashable
+        
+          # When set to true, hierarchical namespace is enabled for this bucket.
+          # Corresponds to the JSON property `enabled`
+          # @return [Boolean]
+          attr_accessor :enabled
+          alias_method :enabled?, :enabled
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @enabled = args[:enabled] if args.key?(:enabled)
+          end
+        end
+      end
+      
       # A list of buckets.
       class Buckets
         include Google::Apis::Core::Hashable
@@ -1312,10 +1706,137 @@ module Google
         end
       end
       
+      # A folder. Only available in buckets with hierarchical namespace enabled.
+      class Folder
+        include Google::Apis::Core::Hashable
+      
+        # The name of the bucket containing this folder.
+        # Corresponds to the JSON property `bucket`
+        # @return [String]
+        attr_accessor :bucket
+      
+        # The creation time of the folder in RFC 3339 format.
+        # Corresponds to the JSON property `createTime`
+        # @return [DateTime]
+        attr_accessor :create_time
+      
+        # The ID of the folder, including the bucket name, folder name.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # The kind of item this is. For folders, this is always storage#folder.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The version of the metadata for this folder. Used for preconditions and for
+        # detecting changes in metadata.
+        # Corresponds to the JSON property `metageneration`
+        # @return [Fixnum]
+        attr_accessor :metageneration
+      
+        # The name of the folder. Required if not specified by URL parameter.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Only present if the folder is part of an ongoing rename folder operation.
+        # Contains information which can be used to query the operation status.
+        # Corresponds to the JSON property `pendingRenameInfo`
+        # @return [Google::Apis::StorageV1::Folder::PendingRenameInfo]
+        attr_accessor :pending_rename_info
+      
+        # The link to this folder.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
+        # The modification time of the folder metadata in RFC 3339 format.
+        # Corresponds to the JSON property `updateTime`
+        # @return [DateTime]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bucket = args[:bucket] if args.key?(:bucket)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @id = args[:id] if args.key?(:id)
+          @kind = args[:kind] if args.key?(:kind)
+          @metageneration = args[:metageneration] if args.key?(:metageneration)
+          @name = args[:name] if args.key?(:name)
+          @pending_rename_info = args[:pending_rename_info] if args.key?(:pending_rename_info)
+          @self_link = args[:self_link] if args.key?(:self_link)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+        
+        # Only present if the folder is part of an ongoing rename folder operation.
+        # Contains information which can be used to query the operation status.
+        class PendingRenameInfo
+          include Google::Apis::Core::Hashable
+        
+          # The ID of the rename folder operation.
+          # Corresponds to the JSON property `operationId`
+          # @return [String]
+          attr_accessor :operation_id
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @operation_id = args[:operation_id] if args.key?(:operation_id)
+          end
+        end
+      end
+      
+      # A list of folders.
+      class Folders
+        include Google::Apis::Core::Hashable
+      
+        # The list of items.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::StorageV1::Folder>]
+        attr_accessor :items
+      
+        # The kind of item this is. For lists of folders, this is always storage#folders.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The continuation token, used to page through large result sets. Provide this
+        # value in a subsequent request to return the next page of results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The response message for storage.buckets.operations.list.
       class GoogleLongrunningListOperationsResponse
         include Google::Apis::Core::Hashable
       
+        # The kind of item this is. For lists of operations, this is always storage#
+        # operations.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
         # The continuation token, used to page through large result sets. Provide this
         # value in a subsequent request to return the next page of results.
         # Corresponds to the JSON property `nextPageToken`
@@ -1333,6 +1854,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
           @operations = args[:operations] if args.key?(:operations)
         end
@@ -1360,6 +1882,11 @@ module Google
         # @return [Google::Apis::StorageV1::GoogleRpcStatus]
         attr_accessor :error
       
+        # The kind of item this is. For operations, this is always storage#operation.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
         # Service-specific metadata associated with the operation. It typically contains
         # progress information and common metadata such as create time. Some services
         # might not provide such metadata. Any method that returns a long-running
@@ -1386,6 +1913,11 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :response
       
+        # The link to this long running operation.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1394,9 +1926,11 @@ module Google
         def update!(**args)
           @done = args[:done] if args.key?(:done)
           @error = args[:error] if args.key?(:error)
+          @kind = args[:kind] if args.key?(:kind)
           @metadata = args[:metadata] if args.key?(:metadata)
           @name = args[:name] if args.key?(:name)
           @response = args[:response] if args.key?(:response)
+          @self_link = args[:self_link] if args.key?(:self_link)
         end
       end
       
@@ -1817,9 +2351,17 @@ module Google
         # @return [String]
         attr_accessor :content_type
       
+        # User-defined or system-defined object contexts. Each object context is a key-
+        # payload pair, where the key provides the identification and the payload holds
+        # the associated value and additional metadata.
+        # Corresponds to the JSON property `contexts`
+        # @return [Google::Apis::StorageV1::Object::Contexts]
+        attr_accessor :contexts
+      
         # CRC32c checksum, as described in RFC 4960, Appendix B; encoded using base64 in
         # big-endian byte order. For more information about using the CRC32c checksum,
-        # see Hashes and ETags: Best Practices.
+        # see [Data Validation and Change Detection](https://cloud.google.com/storage/
+        # docs/data-validation).
         # Corresponds to the JSON property `crc32c`
         # @return [String]
         attr_accessor :crc32c
@@ -1886,7 +2428,8 @@ module Google
         attr_accessor :kms_key_name
       
         # MD5 hash of the data; encoded using base64. For more information about using
-        # the MD5 hash, see Hashes and ETags: Best Practices.
+        # the MD5 hash, see [Data Validation and Change Detection](https://cloud.google.
+        # com/storage/docs/data-validation).
         # Corresponds to the JSON property `md5Hash`
         # @return [String]
         attr_accessor :md5_hash
@@ -1919,6 +2462,13 @@ module Google
         # @return [Google::Apis::StorageV1::Object::Owner]
         attr_accessor :owner
       
+        # Restore token used to differentiate deleted objects with the same name and
+        # generation. This field is only returned for deleted objects in hierarchical
+        # namespace buckets.
+        # Corresponds to the JSON property `restoreToken`
+        # @return [String]
+        attr_accessor :restore_token
+      
         # A collection of object level retention parameters.
         # Corresponds to the JSON property `retention`
         # @return [Google::Apis::StorageV1::Object::Retention]
@@ -1975,6 +2525,11 @@ module Google
         # @return [DateTime]
         attr_accessor :time_deleted
       
+        # The time when the object was finalized.
+        # Corresponds to the JSON property `timeFinalized`
+        # @return [DateTime]
+        attr_accessor :time_finalized
+      
         # The time at which the object's storage class was last changed. When the object
         # is initially created, it will be set to timeCreated.
         # Corresponds to the JSON property `timeStorageClassUpdated`
@@ -2004,6 +2559,7 @@ module Google
           @content_encoding = args[:content_encoding] if args.key?(:content_encoding)
           @content_language = args[:content_language] if args.key?(:content_language)
           @content_type = args[:content_type] if args.key?(:content_type)
+          @contexts = args[:contexts] if args.key?(:contexts)
           @crc32c = args[:crc32c] if args.key?(:crc32c)
           @custom_time = args[:custom_time] if args.key?(:custom_time)
           @customer_encryption = args[:customer_encryption] if args.key?(:customer_encryption)
@@ -2020,6 +2576,7 @@ module Google
           @metageneration = args[:metageneration] if args.key?(:metageneration)
           @name = args[:name] if args.key?(:name)
           @owner = args[:owner] if args.key?(:owner)
+          @restore_token = args[:restore_token] if args.key?(:restore_token)
           @retention = args[:retention] if args.key?(:retention)
           @retention_expiration_time = args[:retention_expiration_time] if args.key?(:retention_expiration_time)
           @self_link = args[:self_link] if args.key?(:self_link)
@@ -2029,10 +2586,32 @@ module Google
           @temporary_hold = args[:temporary_hold] if args.key?(:temporary_hold)
           @time_created = args[:time_created] if args.key?(:time_created)
           @time_deleted = args[:time_deleted] if args.key?(:time_deleted)
+          @time_finalized = args[:time_finalized] if args.key?(:time_finalized)
           @time_storage_class_updated = args[:time_storage_class_updated] if args.key?(:time_storage_class_updated)
           @updated = args[:updated] if args.key?(:updated)
         end
         
+        # User-defined or system-defined object contexts. Each object context is a key-
+        # payload pair, where the key provides the identification and the payload holds
+        # the associated value and additional metadata.
+        class Contexts
+          include Google::Apis::Core::Hashable
+        
+          # User-defined object contexts.
+          # Corresponds to the JSON property `custom`
+          # @return [Hash<String,Google::Apis::StorageV1::ObjectCustomContextPayload>]
+          attr_accessor :custom
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @custom = args[:custom] if args.key?(:custom)
+          end
+        end
+        
         # Metadata of customer-supplied encryption key, if the object is encrypted by
         # such a key.
         class CustomerEncryption
@@ -2265,6 +2844,37 @@ module Google
         end
       end
       
+      # The payload of a single user-defined object context.
+      class ObjectCustomContextPayload
+        include Google::Apis::Core::Hashable
+      
+        # The time at which the object context was created in RFC 3339 format.
+        # Corresponds to the JSON property `createTime`
+        # @return [DateTime]
+        attr_accessor :create_time
+      
+        # The time at which the object context was last updated in RFC 3339 format.
+        # Corresponds to the JSON property `updateTime`
+        # @return [DateTime]
+        attr_accessor :update_time
+      
+        # The value of the object context.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @update_time = args[:update_time] if args.key?(:update_time)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # A list of objects.
       class Objects
         include Google::Apis::Core::Hashable
@@ -2367,23 +2977,23 @@ module Google
         
           # A collection of identifiers for members who may assume the provided role.
           # Recognized identifiers are as follows:
-          # - allUsers — A special identifier that represents anyone on the internet; with
+          # - allUsers - A special identifier that represents anyone on the internet; with
           # or without a Google account.
-          # - allAuthenticatedUsers — A special identifier that represents anyone who is
+          # - allAuthenticatedUsers - A special identifier that represents anyone who is
           # authenticated with a Google account or a service account.
-          # - user:emailid — An email address that represents a specific account. For
+          # - user:emailid - An email address that represents a specific account. For
           # example, user:alice@gmail.com or user:joe@example.com.
-          # - serviceAccount:emailid — An email address that represents a service account.
+          # - serviceAccount:emailid - An email address that represents a service account.
           # For example,  serviceAccount:my-other-app@appspot.gserviceaccount.com .
-          # - group:emailid — An email address that represents a Google group. For example,
+          # - group:emailid - An email address that represents a Google group. For example,
           # group:admins@example.com.
-          # - domain:domain — A Google Apps domain name that represents all the users of
+          # - domain:domain - A Google Apps domain name that represents all the users of
           # that domain. For example, domain:google.com or domain:example.com.
-          # - projectOwner:projectid — Owners of the given project. For example,
+          # - projectOwner:projectid - Owners of the given project. For example,
           # projectOwner:my-example-project
-          # - projectEditor:projectid — Editors of the given project. For example,
+          # - projectEditor:projectid - Editors of the given project. For example,
           # projectEditor:my-example-project
-          # - projectViewer:projectid — Viewers of the given project. For example,
+          # - projectViewer:projectid - Viewers of the given project. For example,
           # projectViewer:my-example-project
           # Corresponds to the JSON property `members`
           # @return [Array<String>]
@@ -2394,23 +3004,23 @@ module Google
           # ACLs, and legacy IAM roles, which do map directly to ACL permissions. All
           # roles are of the format roles/storage.specificRole.
           # The new IAM roles are:
-          # - roles/storage.admin — Full control of Google Cloud Storage resources.
-          # - roles/storage.objectViewer — Read-Only access to Google Cloud Storage
+          # - roles/storage.admin - Full control of Google Cloud Storage resources.
+          # - roles/storage.objectViewer - Read-Only access to Google Cloud Storage
           # objects.
-          # - roles/storage.objectCreator — Access to create objects in Google Cloud
+          # - roles/storage.objectCreator - Access to create objects in Google Cloud
           # Storage.
-          # - roles/storage.objectAdmin — Full control of Google Cloud Storage objects.
+          # - roles/storage.objectAdmin - Full control of Google Cloud Storage objects.
           # The legacy IAM roles are:
-          # - roles/storage.legacyObjectReader — Read-only access to objects without
+          # - roles/storage.legacyObjectReader - Read-only access to objects without
           # listing. Equivalent to an ACL entry on an object with the READER role.
-          # - roles/storage.legacyObjectOwner — Read/write access to existing objects
+          # - roles/storage.legacyObjectOwner - Read/write access to existing objects
           # without listing. Equivalent to an ACL entry on an object with the OWNER role.
-          # - roles/storage.legacyBucketReader — Read access to buckets with object
+          # - roles/storage.legacyBucketReader - Read access to buckets with object
           # listing. Equivalent to an ACL entry on a bucket with the READER role.
-          # - roles/storage.legacyBucketWriter — Read access to buckets with object
+          # - roles/storage.legacyBucketWriter - Read access to buckets with object
           # listing/creation/deletion. Equivalent to an ACL entry on a bucket with the
           # WRITER role.
-          # - roles/storage.legacyBucketOwner — Read and write access to existing buckets
+          # - roles/storage.legacyBucketOwner - Read and write access to existing buckets
           # with object listing/creation/deletion. Equivalent to an ACL entry on a bucket
           # with the OWNER role.
           # Corresponds to the JSON property `role`
@@ -2430,6 +3040,59 @@ module Google
         end
       end
       
+      # A Relocate Bucket request.
+      class RelocateBucketRequest
+        include Google::Apis::Core::Hashable
+      
+        # The bucket's new custom placement configuration if relocating to a Custom Dual
+        # Region.
+        # Corresponds to the JSON property `destinationCustomPlacementConfig`
+        # @return [Google::Apis::StorageV1::RelocateBucketRequest::DestinationCustomPlacementConfig]
+        attr_accessor :destination_custom_placement_config
+      
+        # The new location the bucket will be relocated to.
+        # Corresponds to the JSON property `destinationLocation`
+        # @return [String]
+        attr_accessor :destination_location
+      
+        # If true, validate the operation, but do not actually relocate the bucket.
+        # Corresponds to the JSON property `validateOnly`
+        # @return [Boolean]
+        attr_accessor :validate_only
+        alias_method :validate_only?, :validate_only
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @destination_custom_placement_config = args[:destination_custom_placement_config] if args.key?(:destination_custom_placement_config)
+          @destination_location = args[:destination_location] if args.key?(:destination_location)
+          @validate_only = args[:validate_only] if args.key?(:validate_only)
+        end
+        
+        # The bucket's new custom placement configuration if relocating to a Custom Dual
+        # Region.
+        class DestinationCustomPlacementConfig
+          include Google::Apis::Core::Hashable
+        
+          # The list of regional locations in which data is placed.
+          # Corresponds to the JSON property `dataLocations`
+          # @return [Array<String>]
+          attr_accessor :data_locations
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @data_locations = args[:data_locations] if args.key?(:data_locations)
+          end
+        end
+      end
+      
       # A rewrite response.
       class RewriteResponse
         include Google::Apis::Core::Hashable
@@ -2522,26 +3185,26 @@ module Google
         # The permissions held by the caller. Permissions are always of the format
         # storage.resource.capability, where resource is one of buckets, objects, or
         # managedFolders. The supported permissions are as follows:
-        # - storage.buckets.delete — Delete bucket.
-        # - storage.buckets.get — Read bucket metadata.
-        # - storage.buckets.getIamPolicy — Read bucket IAM policy.
-        # - storage.buckets.create — Create bucket.
-        # - storage.buckets.list — List buckets.
-        # - storage.buckets.setIamPolicy — Update bucket IAM policy.
-        # - storage.buckets.update — Update bucket metadata.
-        # - storage.objects.delete — Delete object.
-        # - storage.objects.get — Read object data and metadata.
-        # - storage.objects.getIamPolicy — Read object IAM policy.
-        # - storage.objects.create — Create object.
-        # - storage.objects.list — List objects.
-        # - storage.objects.setIamPolicy — Update object IAM policy.
-        # - storage.objects.update — Update object metadata.
-        # - storage.managedFolders.delete — Delete managed folder.
-        # - storage.managedFolders.get — Read managed folder metadata.
-        # - storage.managedFolders.getIamPolicy — Read managed folder IAM policy.
-        # - storage.managedFolders.create — Create managed folder.
-        # - storage.managedFolders.list — List managed folders.
-        # - storage.managedFolders.setIamPolicy — Update managed folder IAM policy.
+        # - storage.buckets.delete - Delete bucket.
+        # - storage.buckets.get - Read bucket metadata.
+        # - storage.buckets.getIamPolicy - Read bucket IAM policy.
+        # - storage.buckets.create - Create bucket.
+        # - storage.buckets.list - List buckets.
+        # - storage.buckets.setIamPolicy - Update bucket IAM policy.
+        # - storage.buckets.update - Update bucket metadata.
+        # - storage.objects.delete - Delete object.
+        # - storage.objects.get - Read object data and metadata.
+        # - storage.objects.getIamPolicy - Read object IAM policy.
+        # - storage.objects.create - Create object.
+        # - storage.objects.list - List objects.
+        # - storage.objects.setIamPolicy - Update object IAM policy.
+        # - storage.objects.update - Update object metadata.
+        # - storage.managedFolders.delete - Delete managed folder.
+        # - storage.managedFolders.get - Read managed folder metadata.
+        # - storage.managedFolders.getIamPolicy - Read managed folder IAM policy.
+        # - storage.managedFolders.create - Create managed folder.
+        # - storage.managedFolders.list - List managed folders.
+        # - storage.managedFolders.setIamPolicy - Update managed folder IAM policy.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions