google-api-client 0.9.8 → 0.10.2

data/generated/google/apis/storage_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/storage/docs/json_api/
     module StorageV1
       VERSION = 'V1'
-      REVISION = '20160504'
+      REVISION = '20170308'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -46,7 +46,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # The ID of the bucket.
+        # The ID of the bucket. For buckets, the id and name properities are the same.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -100,10 +100,12 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # The bucket's storage class. This defines how objects in the bucket are stored
-        # and determines the SLA and the cost of storage. Values include STANDARD,
-        # NEARLINE and DURABLE_REDUCED_AVAILABILITY. Defaults to STANDARD. For more
-        # information, see storage classes.
+        # 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`
         # @return [String]
         attr_accessor :storage_class
@@ -123,7 +125,9 @@ module Google
         # @return [Google::Apis::StorageV1::Bucket::Versioning]
         attr_accessor :versioning
       
-        # The bucket's website configuration.
+        # 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`
         # @return [Google::Apis::StorageV1::Bucket::Website]
         attr_accessor :website
@@ -245,7 +249,12 @@ module Google
             class Action
               include Google::Apis::Core::Hashable
             
-              # Type of the action. Currently, only Delete is supported.
+              # Target storage class. Required iff the type of the action is SetStorageClass.
+              # Corresponds to the JSON property `storageClass`
+              # @return [String]
+              attr_accessor :storage_class
+            
+              # Type of the action. Currently, only Delete and SetStorageClass are supported.
               # Corresponds to the JSON property `type`
               # @return [String]
               attr_accessor :type
@@ -256,6 +265,7 @@ module Google
             
               # Update properties of this object
               def update!(**args)
+                @storage_class = args[:storage_class] if args.key?(:storage_class)
                 @type = args[:type] if args.key?(:type)
               end
             end
@@ -284,6 +294,13 @@ module Google
               attr_accessor :is_live
               alias_method :is_live?, :is_live
             
+              # Objects having any of the storage classes specified by this condition will be
+              # matched. Values include MULTI_REGIONAL, REGIONAL, NEARLINE, COLDLINE, STANDARD,
+              # and DURABLE_REDUCED_AVAILABILITY.
+              # Corresponds to the JSON property `matchesStorageClass`
+              # @return [Array<String>]
+              attr_accessor :matches_storage_class
+            
               # Relevant only for versioned objects. If the value is N, this condition is
               # satisfied when there are at least N versions (including the live version)
               # newer than this version of the object.
@@ -300,6 +317,7 @@ module Google
                 @age = args[:age] if args.key?(:age)
                 @created_before = args[:created_before] if args.key?(:created_before)
                 @is_live = args[:is_live] if args.key?(:is_live)
+                @matches_storage_class = args[:matches_storage_class] if args.key?(:matches_storage_class)
                 @num_newer_versions = args[:num_newer_versions] if args.key?(:num_newer_versions)
               end
             end
@@ -377,17 +395,23 @@ module Google
           end
         end
         
-        # The bucket's website configuration.
+        # 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.
         class Website
           include Google::Apis::Core::Hashable
         
-          # Behaves as the bucket's directory index where missing objects are treated as
-          # potential directories.
+          # If the requested object path is missing, the service will ensure the path has
+          # a trailing '/', append this suffix, and attempt to retrieve the resulting
+          # object. This allows the creation of index.html objects to represent directory
+          # pages.
           # Corresponds to the JSON property `mainPageSuffix`
           # @return [String]
           attr_accessor :main_page_suffix
         
-          # The custom object to return when a requested resource is not found.
+          # If the requested object path is missing, and any mainPageSuffix object is
+          # missing, if applicable, the service will return the named object from this
+          # bucket as the content for a 404 Not Found result.
           # Corresponds to the JSON property `notFoundPage`
           # @return [String]
           attr_accessor :not_found_page
@@ -466,7 +490,7 @@ module Google
         # @return [Google::Apis::StorageV1::BucketAccessControl::ProjectTeam]
         attr_accessor :project_team
       
-        # The access permission for the entity. Can be READER, WRITER, or OWNER.
+        # The access permission for the entity.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -504,7 +528,7 @@ module Google
           # @return [String]
           attr_accessor :project_number
         
-          # The team. Can be owners, editors, or viewers.
+          # The team.
           # Corresponds to the JSON property `team`
           # @return [String]
           attr_accessor :team
@@ -755,7 +779,8 @@ module Google
         # @return [String]
         attr_accessor :bucket
       
-        # Cache-Control directive for the object data.
+        # Cache-Control directive for the object data. If omitted, and the object is
+        # accessible to all anonymous users, the default will be public, max-age=3600.
         # Corresponds to the JSON property `cacheControl`
         # @return [String]
         attr_accessor :cache_control
@@ -810,7 +835,8 @@ module Google
         # @return [String]
         attr_accessor :generation
       
-        # The ID of the object.
+        # The ID of the object, including the bucket name, object name, and generation
+        # number.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -844,7 +870,7 @@ module Google
         # @return [String]
         attr_accessor :metageneration
       
-        # The name of this object. Required if not specified by URL parameter.
+        # The name of the object. Required if not specified by URL parameter.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -880,6 +906,12 @@ module Google
         # @return [DateTime]
         attr_accessor :time_deleted
       
+        # 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`
+        # @return [DateTime]
+        attr_accessor :time_storage_class_updated
+      
         # The modification time of the object metadata in RFC 3339 format.
         # Corresponds to the JSON property `updated`
         # @return [DateTime]
@@ -916,6 +948,7 @@ module Google
           @storage_class = args[:storage_class] if args.key?(:storage_class)
           @time_created = args[:time_created] if args.key?(:time_created)
           @time_deleted = args[:time_deleted] if args.key?(:time_deleted)
+          @time_storage_class_updated = args[:time_storage_class_updated] if args.key?(:time_storage_class_updated)
           @updated = args[:updated] if args.key?(:updated)
         end
         
@@ -1017,7 +1050,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # The content generation of the object.
+        # The content generation of the object, if applied to an object.
         # Corresponds to the JSON property `generation`
         # @return [String]
         attr_accessor :generation
@@ -1033,7 +1066,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The name of the object.
+        # The name of the object, if applied to an object.
         # Corresponds to the JSON property `object`
         # @return [String]
         attr_accessor :object
@@ -1043,7 +1076,7 @@ module Google
         # @return [Google::Apis::StorageV1::ObjectAccessControl::ProjectTeam]
         attr_accessor :project_team
       
-        # The access permission for the entity. Can be READER or OWNER.
+        # The access permission for the entity.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -1083,7 +1116,7 @@ module Google
           # @return [String]
           attr_accessor :project_number
         
-          # The team. Can be owners, editors, or viewers.
+          # The team.
           # Corresponds to the JSON property `team`
           # @return [String]
           attr_accessor :team
@@ -1106,7 +1139,7 @@ module Google
       
         # The list of items.
         # Corresponds to the JSON property `items`
-        # @return [Array<Object>]
+        # @return [Array<Google::Apis::StorageV1::ObjectAccessControl>]
         attr_accessor :items
       
         # The kind of item this is. For lists of object access control entries, this is
@@ -1165,6 +1198,116 @@ module Google
         end
       end
       
+      # A bucket/object IAM policy.
+      class Policy
+        include Google::Apis::Core::Hashable
+      
+        # An association between a role, which comes with a set of permissions, and
+        # members who may assume that role.
+        # Corresponds to the JSON property `bindings`
+        # @return [Array<Google::Apis::StorageV1::Policy::Binding>]
+        attr_accessor :bindings
+      
+        # HTTP 1.1  Entity tag for the policy.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # The kind of item this is. For policies, this is always storage#policy. This
+        # field is ignored on input.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The ID of the resource to which this policy belongs. Will be of the form
+        # buckets/bucket for buckets, and buckets/bucket/objects/object for objects. A
+        # specific generation may be specified by appending #generationNumber to the end
+        # of the object name, e.g. buckets/my-bucket/objects/data.txt#17. The current
+        # generation can be denoted with #0. This field is ignored on input.
+        # Corresponds to the JSON property `resourceId`
+        # @return [String]
+        attr_accessor :resource_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bindings = args[:bindings] if args.key?(:bindings)
+          @etag = args[:etag] if args.key?(:etag)
+          @kind = args[:kind] if args.key?(:kind)
+          @resource_id = args[:resource_id] if args.key?(:resource_id)
+        end
+        
+        # 
+        class Binding
+          include Google::Apis::Core::Hashable
+        
+          # 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
+          # or without a Google account.
+          # - 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
+          # example, user:alice@gmail.com or user:joe@example.com.
+          # - 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:admins@example.com.
+          # - 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:my-example-project
+          # - projectEditor:projectid — Editors of the given project. For example,
+          # projectEditor:my-example-project
+          # - projectViewer:projectid — Viewers of the given project. For example,
+          # projectViewer:my-example-project
+          # Corresponds to the JSON property `members`
+          # @return [Array<String>]
+          attr_accessor :members
+        
+          # The role to which members belong. Two types of roles are supported: new IAM
+          # roles, which grant permissions that do not map directly to those provided by
+          # 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
+          # objects.
+          # - roles/storage.objectCreator — Access to create objects in Google Cloud
+          # Storage.
+          # - roles/storage.objectAdmin — Full control of Google Cloud Storage objects.
+          # The legacy IAM roles are:
+          # - 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
+          # without listing. Equivalent to an ACL entry on an object with the OWNER role.
+          # - 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
+          # 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
+          # with object listing/creation/deletion. Equivalent to an ACL entry on a bucket
+          # with the OWNER role.
+          # Corresponds to the JSON property `role`
+          # @return [String]
+          attr_accessor :role
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @members = args[:members] if args.key?(:members)
+            @role = args[:role] if args.key?(:role)
+          end
+        end
+      end
+      
       # A rewrite response.
       class RewriteResponse
         include Google::Apis::Core::Hashable
@@ -1218,6 +1361,47 @@ module Google
           @total_bytes_rewritten = args[:total_bytes_rewritten] if args.key?(:total_bytes_rewritten)
         end
       end
+      
+      # A storage.(buckets|objects).testIamPermissions response.
+      class TestIamPermissionsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The kind of item this is.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The permissions held by the caller. Permissions are always of the format
+        # storage.resource.capability, where resource is one of buckets or objects. 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.
+        # Corresponds to the JSON property `permissions`
+        # @return [Array<String>]
+        attr_accessor :permissions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @permissions = args[:permissions] if args.key?(:permissions)
+        end
+      end
     end
   end
 end

data/generated/google/apis/storage_v1/representations.rb

@@ -172,12 +172,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Policy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+        class Binding
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RewriteResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TestIamPermissionsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Bucket
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -241,6 +259,7 @@ module Google
             class Action
               # @private
               class Representation < Google::Apis::Core::JsonRepresentation
+                property :storage_class, as: 'storageClass'
                 property :type, as: 'type'
               end
             end
@@ -252,6 +271,7 @@ module Google
                 property :created_before, as: 'createdBefore', type: Date
             
                 property :is_live, as: 'isLive'
+                collection :matches_storage_class, as: 'matchesStorageClass'
                 property :num_newer_versions, as: 'numNewerVersions'
               end
             end
@@ -412,6 +432,8 @@ module Google
       
           property :time_deleted, as: 'timeDeleted', type: DateTime
       
+          property :time_storage_class_updated, as: 'timeStorageClassUpdated', type: DateTime
+      
           property :updated, as: 'updated', type: DateTime
       
         end
@@ -464,7 +486,8 @@ module Google
       class ObjectAccessControls
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :items, as: 'items'
+          collection :items, as: 'items', class: Google::Apis::StorageV1::ObjectAccessControl, decorator: Google::Apis::StorageV1::ObjectAccessControl::Representation
+      
           property :kind, as: 'kind'
         end
       end
@@ -480,6 +503,25 @@ module Google
         end
       end
       
+      class Policy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :bindings, as: 'bindings', class: Google::Apis::StorageV1::Policy::Binding, decorator: Google::Apis::StorageV1::Policy::Binding::Representation
+      
+          property :etag, :base64 => true, as: 'etag'
+          property :kind, as: 'kind'
+          property :resource_id, as: 'resourceId'
+        end
+        
+        class Binding
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            collection :members, as: 'members'
+            property :role, as: 'role'
+          end
+        end
+      end
+      
       class RewriteResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -492,6 +534,14 @@ module Google
           property :total_bytes_rewritten, as: 'totalBytesRewritten'
         end
       end
+      
+      class TestIamPermissionsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kind, as: 'kind'
+          collection :permissions, as: 'permissions'
+        end
+      end
     end
   end
 end