google-api-client 0.37.3 → 0.38.0

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 = '20191127'
+      REVISION = '20200326'
 
       # 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

@@ -188,6 +188,22 @@ module Google
         # @return [Google::Apis::StorageV1::Bucket::Website]
         attr_accessor :website
       
+        # The zone or zones from which the bucket is intended to use zonal quota.
+        # Requests for data from outside the specified affinities are still allowed but
+        # won't be able to use zonal quota. The zone or zones need to be within the
+        # bucket location otherwise the requests will fail with a 400 Bad Request
+        # response.
+        # Corresponds to the JSON property `zoneAffinity`
+        # @return [Array<String>]
+        attr_accessor :zone_affinity
+      
+        # If set, objects placed in this bucket are required to be separated by disaster
+        # domain.
+        # Corresponds to the JSON property `zoneSeparation`
+        # @return [Boolean]
+        attr_accessor :zone_separation
+        alias_method :zone_separation?, :zone_separation
+      
         def initialize(**args)
            update!(**args)
         end
@@ -220,6 +236,8 @@ module Google
           @updated = args[:updated] if args.key?(:updated)
           @versioning = args[:versioning] if args.key?(:versioning)
           @website = args[:website] if args.key?(:website)
+          @zone_affinity = args[:zone_affinity] if args.key?(:zone_affinity)
+          @zone_separation = args[:zone_separation] if args.key?(:zone_separation)
         end
         
         # The bucket's billing configuration.

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

@@ -317,6 +317,8 @@ module Google
       
           property :website, as: 'website', class: Google::Apis::StorageV1::Bucket::Website, decorator: Google::Apis::StorageV1::Bucket::Website::Representation
       
+          collection :zone_affinity, as: 'zoneAffinity'
+          property :zone_separation, as: 'zoneSeparation'
         end
         
         class Billing

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

@@ -1678,6 +1678,10 @@ module Google
         #   Name of the new object. Required when the object metadata is not otherwise
         #   provided. Overrides the object metadata's name value, if any.
         # @param [Google::Apis::StorageV1::Object] object_object
+        # @param [String] destination_kms_key_name
+        #   Resource name of the Cloud KMS key, of the form projects/my-project/locations/
+        #   global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
+        #   object. Overrides the object metadata's kms_key_name value, if any.
         # @param [String] destination_predefined_acl
         #   Apply a predefined set of access controls to the destination object.
         # @param [Fixnum] if_generation_match
@@ -1737,7 +1741,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def copy_object(source_bucket, source_object, destination_bucket, destination_object, object_object = nil, destination_predefined_acl: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, if_source_generation_match: nil, if_source_generation_not_match: nil, if_source_metageneration_match: nil, if_source_metageneration_not_match: nil, projection: nil, provisional_user_project: nil, source_generation: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def copy_object(source_bucket, source_object, destination_bucket, destination_object, object_object = nil, destination_kms_key_name: nil, destination_predefined_acl: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, if_source_generation_match: nil, if_source_generation_not_match: nil, if_source_metageneration_match: nil, if_source_metageneration_not_match: nil, projection: nil, provisional_user_project: nil, source_generation: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'b/{sourceBucket}/o/{sourceObject}/copyTo/b/{destinationBucket}/o/{destinationObject}', options)
           command.request_representation = Google::Apis::StorageV1::Object::Representation
           command.request_object = object_object
@@ -1747,6 +1751,7 @@ module Google
           command.params['sourceObject'] = source_object unless source_object.nil?
           command.params['destinationBucket'] = destination_bucket unless destination_bucket.nil?
           command.params['destinationObject'] = destination_object unless destination_object.nil?
+          command.query['destinationKmsKeyName'] = destination_kms_key_name unless destination_kms_key_name.nil?
           command.query['destinationPredefinedAcl'] = destination_predefined_acl unless destination_predefined_acl.nil?
           command.query['ifGenerationMatch'] = if_generation_match unless if_generation_match.nil?
           command.query['ifGenerationNotMatch'] = if_generation_not_match unless if_generation_not_match.nil?
@@ -2063,6 +2068,10 @@ module Google
         #   names, aside from the prefix, contain delimiter will have their name,
         #   truncated after the delimiter, returned in prefixes. Duplicate prefixes are
         #   omitted.
+        # @param [String] end_offset
+        #   Filter results to objects whose names are lexicographically before endOffset.
+        #   If startOffset is also set, the objects listed will have names between
+        #   startOffset (inclusive) and endOffset (exclusive).
         # @param [Boolean] include_trailing_delimiter
         #   If true, objects that end in exactly one instance of delimiter will have their
         #   metadata included in items in addition to prefixes.
@@ -2081,6 +2090,10 @@ module Google
         # @param [String] provisional_user_project
         #   The project to be billed for this request if the target bucket is requester-
         #   pays bucket.
+        # @param [String] start_offset
+        #   Filter results to objects whose names are lexicographically equal to or after
+        #   startOffset. If endOffset is also set, the objects listed will have names
+        #   between startOffset (inclusive) and endOffset (exclusive).
         # @param [String] user_project
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [Boolean] versions
@@ -2105,18 +2118,20 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_objects(bucket, delimiter: nil, include_trailing_delimiter: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, provisional_user_project: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_objects(bucket, delimiter: nil, end_offset: nil, include_trailing_delimiter: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, provisional_user_project: nil, start_offset: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, 'b/{bucket}/o', options)
           command.response_representation = Google::Apis::StorageV1::Objects::Representation
           command.response_class = Google::Apis::StorageV1::Objects
           command.params['bucket'] = bucket unless bucket.nil?
           command.query['delimiter'] = delimiter unless delimiter.nil?
+          command.query['endOffset'] = end_offset unless end_offset.nil?
           command.query['includeTrailingDelimiter'] = include_trailing_delimiter unless include_trailing_delimiter.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['prefix'] = prefix unless prefix.nil?
           command.query['projection'] = projection unless projection.nil?
           command.query['provisionalUserProject'] = provisional_user_project unless provisional_user_project.nil?
+          command.query['startOffset'] = start_offset unless start_offset.nil?
           command.query['userProject'] = user_project unless user_project.nil?
           command.query['versions'] = versions unless versions.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -2514,6 +2529,10 @@ module Google
         #   names, aside from the prefix, contain delimiter will have their name,
         #   truncated after the delimiter, returned in prefixes. Duplicate prefixes are
         #   omitted.
+        # @param [String] end_offset
+        #   Filter results to objects whose names are lexicographically before endOffset.
+        #   If startOffset is also set, the objects listed will have names between
+        #   startOffset (inclusive) and endOffset (exclusive).
         # @param [Boolean] include_trailing_delimiter
         #   If true, objects that end in exactly one instance of delimiter will have their
         #   metadata included in items in addition to prefixes.
@@ -2532,6 +2551,10 @@ module Google
         # @param [String] provisional_user_project
         #   The project to be billed for this request if the target bucket is requester-
         #   pays bucket.
+        # @param [String] start_offset
+        #   Filter results to objects whose names are lexicographically equal to or after
+        #   startOffset. If endOffset is also set, the objects listed will have names
+        #   between startOffset (inclusive) and endOffset (exclusive).
         # @param [String] user_project
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [Boolean] versions
@@ -2556,7 +2579,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def watch_all_objects(bucket, channel_object = nil, delimiter: nil, include_trailing_delimiter: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, provisional_user_project: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def watch_all_objects(bucket, channel_object = nil, delimiter: nil, end_offset: nil, include_trailing_delimiter: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, provisional_user_project: nil, start_offset: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'b/{bucket}/o/watch', options)
           command.request_representation = Google::Apis::StorageV1::Channel::Representation
           command.request_object = channel_object
@@ -2564,12 +2587,14 @@ module Google
           command.response_class = Google::Apis::StorageV1::Channel
           command.params['bucket'] = bucket unless bucket.nil?
           command.query['delimiter'] = delimiter unless delimiter.nil?
+          command.query['endOffset'] = end_offset unless end_offset.nil?
           command.query['includeTrailingDelimiter'] = include_trailing_delimiter unless include_trailing_delimiter.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['prefix'] = prefix unless prefix.nil?
           command.query['projection'] = projection unless projection.nil?
           command.query['provisionalUserProject'] = provisional_user_project unless provisional_user_project.nil?
+          command.query['startOffset'] = start_offset unless start_offset.nil?
           command.query['userProject'] = user_project unless user_project.nil?
           command.query['versions'] = versions unless versions.nil?
           command.query['fields'] = fields unless fields.nil?

data/generated/google/apis/storagetransfer_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/storage-transfer/docs
     module StoragetransferV1
       VERSION = 'V1'
-      REVISION = '20200215'
+      REVISION = '20200316'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -83,6 +83,68 @@ module Google
         end
       end
       
+      # An AzureBlobStorageData resource can be a data source, but not a data sink.
+      # An AzureBlobStorageData resource represents one Azure container. The storage
+      # account determines the [Azure
+      # endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-
+      # storage-account#storage-account-endpoints).
+      # In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob
+      # Storage blob's key
+      # name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-
+      # referencing-containers--blobs--and-metadata#blob-names).
+      class AzureBlobStorageData
+        include Google::Apis::Core::Hashable
+      
+        # Azure credentials
+        # Corresponds to the JSON property `azureCredentials`
+        # @return [Google::Apis::StoragetransferV1::AzureCredentials]
+        attr_accessor :azure_credentials
+      
+        # Required. The container to transfer from the Azure Storage account.
+        # Corresponds to the JSON property `container`
+        # @return [String]
+        attr_accessor :container
+      
+        # Required. The name of the Azure Storage account.
+        # Corresponds to the JSON property `storageAccount`
+        # @return [String]
+        attr_accessor :storage_account
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @azure_credentials = args[:azure_credentials] if args.key?(:azure_credentials)
+          @container = args[:container] if args.key?(:container)
+          @storage_account = args[:storage_account] if args.key?(:storage_account)
+        end
+      end
+      
+      # Azure credentials
+      class AzureCredentials
+        include Google::Apis::Core::Hashable
+      
+        # Required. Azure shared access signature. (see
+        # [Grant limited access to Azure Storage resources using shared access
+        # signatures
+        # (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-
+        # overview)).
+        # Corresponds to the JSON property `sasToken`
+        # @return [String]
+        attr_accessor :sas_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sas_token = args[:sas_token] if args.key?(:sas_token)
+        end
+      end
+      
       # Represents a whole or partial calendar date, e.g. a birthday. The time of day
       # and time zone are either specified elsewhere or are not significant. The date
       # is relative to the Proleptic Gregorian Calendar. This can represent:
@@ -348,6 +410,54 @@ module Google
         end
       end
       
+      # Specification to configure notifications published to Cloud Pub/Sub.
+      # Notifications will be published to the customer-provided topic using the
+      # following `PubsubMessage.attributes`:
+      # * `"eventType"`: one of the EventType values
+      # * `"payloadFormat"`: one of the PayloadFormat values
+      # * `"projectId"`: the project_id of the
+      # `TransferOperation`
+      # * `"transferJobName"`: the
+      # transfer_job_name of the
+      # `TransferOperation`
+      # * `"transferOperationName"`: the name of the
+      # `TransferOperation`
+      # The `PubsubMessage.data` will contain a TransferOperation resource
+      # formatted according to the specified `PayloadFormat`.
+      class NotificationConfig
+        include Google::Apis::Core::Hashable
+      
+        # Event types for which a notification is desired. If empty, send
+        # notifications for all event types.
+        # Corresponds to the JSON property `eventTypes`
+        # @return [Array<String>]
+        attr_accessor :event_types
+      
+        # Required. The desired format of the notification message payloads.
+        # Corresponds to the JSON property `payloadFormat`
+        # @return [String]
+        attr_accessor :payload_format
+      
+        # Required. The `Topic.name` of the Cloud Pub/Sub topic to which to publish
+        # notifications. Must be of the format: `projects/`project`/topics/`topic``.
+        # Not matching this format will result in an
+        # INVALID_ARGUMENT error.
+        # Corresponds to the JSON property `pubsubTopic`
+        # @return [String]
+        attr_accessor :pubsub_topic
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @event_types = args[:event_types] if args.key?(:event_types)
+          @payload_format = args[:payload_format] if args.key?(:payload_format)
+          @pubsub_topic = args[:pubsub_topic] if args.key?(:pubsub_topic)
+        end
+      end
+      
       # Conditions that determine which objects will be transferred. Applies only
       # to S3 and Cloud Storage objects.
       # The "last modification time" refers to the time of the
@@ -394,6 +504,26 @@ module Google
         # @return [Array<String>]
         attr_accessor :include_prefixes
       
+        # If specified, only objects with a "last modification time" before this
+        # timestamp and objects that don't have a "last modification time" will be
+        # transferred.
+        # Corresponds to the JSON property `lastModifiedBefore`
+        # @return [String]
+        attr_accessor :last_modified_before
+      
+        # If specified, only objects with a "last modification time" on or after
+        # this timestamp and objects that don't have a "last modification time" are
+        # transferred.
+        # The `last_modified_since` and `last_modified_before` fields can be used
+        # together for chunked data processing. For example, consider a script that
+        # processes each day's worth of data at a time. For that you'd set each
+        # of the fields as follows:
+        # *  `last_modified_since` to the start of the day
+        # *  `last_modified_before` to the end of the day
+        # Corresponds to the JSON property `lastModifiedSince`
+        # @return [String]
+        attr_accessor :last_modified_since
+      
         # If specified, only objects with a "last modification time" on or after
         # `NOW` - `max_time_elapsed_since_last_modification` and objects that don't
         # have a "last modification time" are transferred.
@@ -422,6 +552,8 @@ module Google
         def update!(**args)
           @exclude_prefixes = args[:exclude_prefixes] if args.key?(:exclude_prefixes)
           @include_prefixes = args[:include_prefixes] if args.key?(:include_prefixes)
+          @last_modified_before = args[:last_modified_before] if args.key?(:last_modified_before)
+          @last_modified_since = args[:last_modified_since] if args.key?(:last_modified_since)
           @max_time_elapsed_since_last_modification = args[:max_time_elapsed_since_last_modification] if args.key?(:max_time_elapsed_since_last_modification)
           @min_time_elapsed_since_last_modification = args[:min_time_elapsed_since_last_modification] if args.key?(:min_time_elapsed_since_last_modification)
         end
@@ -785,22 +917,38 @@ module Google
         attr_accessor :last_modification_time
       
         # A unique name (within the transfer project) assigned when the job is
-        # created.
-        # If this field is left empty in a CreateTransferJobRequest, Storage Transfer
-        # Service will assign a unique name. Otherwise, the supplied name is used as
-        # the unique name for this job.
+        # created.  If this field is empty in a CreateTransferJobRequest, Storage
+        # Transfer Service will assign a unique name. Otherwise, the specified name
+        # is used as the unique name for this job.
+        # If the specified name is in use by a job, the creation request fails with
+        # an ALREADY_EXISTS error.
         # This name must start with `"transferJobs/"` prefix and end with a letter or
         # a number, and should be no more than 128 characters.
-        # Example of a valid format : `"transferJobs/[A-Za-z0-9-._~]*[A-Za-z0-9]$"`
-        # **Note:** If the supplied name is already in use, the creation request
-        # results in an ALREADY_EXISTS error and
-        # the transfer job will not be created.  Invalid job names will return an
-        # INVALID_ARGUMENT error and the job will
-        # not be created.
+        # Example: `"transferJobs/[A-Za-z0-9-._~]*[A-Za-z0-9]$"`
+        # Invalid job names will fail with an
+        # INVALID_ARGUMENT error.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
+        # Specification to configure notifications published to Cloud Pub/Sub.
+        # Notifications will be published to the customer-provided topic using the
+        # following `PubsubMessage.attributes`:
+        # * `"eventType"`: one of the EventType values
+        # * `"payloadFormat"`: one of the PayloadFormat values
+        # * `"projectId"`: the project_id of the
+        # `TransferOperation`
+        # * `"transferJobName"`: the
+        # transfer_job_name of the
+        # `TransferOperation`
+        # * `"transferOperationName"`: the name of the
+        # `TransferOperation`
+        # The `PubsubMessage.data` will contain a TransferOperation resource
+        # formatted according to the specified `PayloadFormat`.
+        # Corresponds to the JSON property `notificationConfig`
+        # @return [Google::Apis::StoragetransferV1::NotificationConfig]
+        attr_accessor :notification_config
+      
         # The ID of the Google Cloud Platform Project that owns the job.
         # Corresponds to the JSON property `projectId`
         # @return [String]
@@ -838,6 +986,7 @@ module Google
           @description = args[:description] if args.key?(:description)
           @last_modification_time = args[:last_modification_time] if args.key?(:last_modification_time)
           @name = args[:name] if args.key?(:name)
+          @notification_config = args[:notification_config] if args.key?(:notification_config)
           @project_id = args[:project_id] if args.key?(:project_id)
           @schedule = args[:schedule] if args.key?(:schedule)
           @status = args[:status] if args.key?(:status)
@@ -869,6 +1018,24 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Specification to configure notifications published to Cloud Pub/Sub.
+        # Notifications will be published to the customer-provided topic using the
+        # following `PubsubMessage.attributes`:
+        # * `"eventType"`: one of the EventType values
+        # * `"payloadFormat"`: one of the PayloadFormat values
+        # * `"projectId"`: the project_id of the
+        # `TransferOperation`
+        # * `"transferJobName"`: the
+        # transfer_job_name of the
+        # `TransferOperation`
+        # * `"transferOperationName"`: the name of the
+        # `TransferOperation`
+        # The `PubsubMessage.data` will contain a TransferOperation resource
+        # formatted according to the specified `PayloadFormat`.
+        # Corresponds to the JSON property `notificationConfig`
+        # @return [Google::Apis::StoragetransferV1::NotificationConfig]
+        attr_accessor :notification_config
+      
         # The ID of the Google Cloud Platform Project that owns the operation.
         # Corresponds to the JSON property `projectId`
         # @return [String]
@@ -904,6 +1071,7 @@ module Google
           @end_time = args[:end_time] if args.key?(:end_time)
           @error_breakdowns = args[:error_breakdowns] if args.key?(:error_breakdowns)
           @name = args[:name] if args.key?(:name)
+          @notification_config = args[:notification_config] if args.key?(:notification_config)
           @project_id = args[:project_id] if args.key?(:project_id)
           @start_time = args[:start_time] if args.key?(:start_time)
           @status = args[:status] if args.key?(:status)
@@ -962,6 +1130,19 @@ module Google
         # @return [Google::Apis::StoragetransferV1::AwsS3Data]
         attr_accessor :aws_s3_data_source
       
+        # An AzureBlobStorageData resource can be a data source, but not a data sink.
+        # An AzureBlobStorageData resource represents one Azure container. The storage
+        # account determines the [Azure
+        # endpoint](https://docs.microsoft.com/en-us/azure/storage/common/storage-create-
+        # storage-account#storage-account-endpoints).
+        # In an AzureBlobStorageData resource, a blobs's name is the [Azure Blob
+        # Storage blob's key
+        # name](https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-
+        # referencing-containers--blobs--and-metadata#blob-names).
+        # Corresponds to the JSON property `azureBlobStorageDataSource`
+        # @return [Google::Apis::StoragetransferV1::AzureBlobStorageData]
+        attr_accessor :azure_blob_storage_data_source
+      
         # In a GcsData resource, an object's name is the Cloud Storage object's
         # name and its "last modification time" refers to the object's `updated`
         # property of Cloud Storage objects, which changes when the content or the
@@ -1036,6 +1217,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @aws_s3_data_source = args[:aws_s3_data_source] if args.key?(:aws_s3_data_source)
+          @azure_blob_storage_data_source = args[:azure_blob_storage_data_source] if args.key?(:azure_blob_storage_data_source)
           @gcs_data_sink = args[:gcs_data_sink] if args.key?(:gcs_data_sink)
           @gcs_data_source = args[:gcs_data_source] if args.key?(:gcs_data_source)
           @http_data_source = args[:http_data_source] if args.key?(:http_data_source)
@@ -1063,7 +1245,8 @@ module Google
         # The field mask of the fields in `transferJob` that are to be updated in
         # this request.  Fields in `transferJob` that can be updated are:
         # description,
-        # transfer_spec, and
+        # transfer_spec,
+        # notification_config, and
         # status.  To update the `transfer_spec` of the job, a
         # complete transfer specification must be provided. An incomplete
         # specification missing any required fields will be rejected with the error