google-api-client 0.19.8 → 0.20.0

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

@@ -149,6 +149,83 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Exports a copy of all or a subset of entities from Google Cloud Datastore
+        # to another storage system, such as Google Cloud Storage. Recent updates to
+        # entities may not be reflected in the export. The export occurs in the
+        # background and its progress can be monitored and managed via the
+        # Operation resource that is created. The output of an export may only be
+        # used once the associated operation is done. If an export operation is
+        # cancelled before completion it may leave partial data behind in Google
+        # Cloud Storage.
+        # @param [String] project_id
+        #   Project ID against which to make the request.
+        # @param [Google::Apis::DatastoreV1::GoogleDatastoreAdminV1ExportEntitiesRequest] google_datastore_admin_v1_export_entities_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DatastoreV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DatastoreV1::GoogleLongrunningOperation]
+        #
+        # @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 export_project(project_id, google_datastore_admin_v1_export_entities_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/projects/{projectId}:export', options)
+          command.request_representation = Google::Apis::DatastoreV1::GoogleDatastoreAdminV1ExportEntitiesRequest::Representation
+          command.request_object = google_datastore_admin_v1_export_entities_request_object
+          command.response_representation = Google::Apis::DatastoreV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DatastoreV1::GoogleLongrunningOperation
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Imports entities into Google Cloud Datastore. Existing entities with the
+        # same key are overwritten. The import occurs in the background and its
+        # progress can be monitored and managed via the Operation resource that is
+        # created. If an ImportEntities operation is cancelled, it is possible
+        # that a subset of the data has already been imported to Cloud Datastore.
+        # @param [String] project_id
+        #   Project ID against which to make the request.
+        # @param [Google::Apis::DatastoreV1::GoogleDatastoreAdminV1ImportEntitiesRequest] google_datastore_admin_v1_import_entities_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DatastoreV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DatastoreV1::GoogleLongrunningOperation]
+        #
+        # @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 import_project(project_id, google_datastore_admin_v1_import_entities_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/projects/{projectId}:import', options)
+          command.request_representation = Google::Apis::DatastoreV1::GoogleDatastoreAdminV1ImportEntitiesRequest::Representation
+          command.request_object = google_datastore_admin_v1_import_entities_request_object
+          command.response_representation = Google::Apis::DatastoreV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DatastoreV1::GoogleLongrunningOperation
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Looks up entities by key.
         # @param [String] project_id
         #   The ID of the project against which to make the request.

data/generated/google/apis/datastore_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/datastore/
     module DatastoreV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20170904'
+      REVISION = '20180321'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,6 +22,261 @@ module Google
   module Apis
     module DatastoreV1beta1
       
+      # Metadata common to all Datastore Admin operations.
+      class GoogleDatastoreAdminV1CommonMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The time the operation ended, either successfully or otherwise.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The client-assigned labels which were provided when the operation was
+        # created. May also include additional labels.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        # The type of the operation. Can be used as a filter in
+        # ListOperationsRequest.
+        # Corresponds to the JSON property `operationType`
+        # @return [String]
+        attr_accessor :operation_type
+      
+        # The time that work began on the operation.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # The current state of the Operation.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @labels = args[:labels] if args.key?(:labels)
+          @operation_type = args[:operation_type] if args.key?(:operation_type)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Identifies a subset of entities in a project. This is specified as
+      # combinations of kinds and namespaces (either or both of which may be all, as
+      # described in the following examples).
+      # Example usage:
+      # Entire project:
+      # kinds=[], namespace_ids=[]
+      # Kinds Foo and Bar in all namespaces:
+      # kinds=['Foo', 'Bar'], namespace_ids=[]
+      # Kinds Foo and Bar only in the default namespace:
+      # kinds=['Foo', 'Bar'], namespace_ids=['']
+      # Kinds Foo and Bar in both the default and Baz namespaces:
+      # kinds=['Foo', 'Bar'], namespace_ids=['', 'Baz']
+      # The entire Baz namespace:
+      # kinds=[], namespace_ids=['Baz']
+      class GoogleDatastoreAdminV1EntityFilter
+        include Google::Apis::Core::Hashable
+      
+        # If empty, then this represents all kinds.
+        # Corresponds to the JSON property `kinds`
+        # @return [Array<String>]
+        attr_accessor :kinds
+      
+        # An empty list represents all namespaces. This is the preferred
+        # usage for projects that don't use namespaces.
+        # An empty string element represents the default namespace. This should be
+        # used if the project has data in non-default namespaces, but doesn't want to
+        # include them.
+        # Each namespace in this list must be unique.
+        # Corresponds to the JSON property `namespaceIds`
+        # @return [Array<String>]
+        attr_accessor :namespace_ids
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kinds = args[:kinds] if args.key?(:kinds)
+          @namespace_ids = args[:namespace_ids] if args.key?(:namespace_ids)
+        end
+      end
+      
+      # Metadata for ExportEntities operations.
+      class GoogleDatastoreAdminV1ExportEntitiesMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Metadata common to all Datastore Admin operations.
+        # Corresponds to the JSON property `common`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1CommonMetadata]
+        attr_accessor :common
+      
+        # Identifies a subset of entities in a project. This is specified as
+        # combinations of kinds and namespaces (either or both of which may be all, as
+        # described in the following examples).
+        # Example usage:
+        # Entire project:
+        # kinds=[], namespace_ids=[]
+        # Kinds Foo and Bar in all namespaces:
+        # kinds=['Foo', 'Bar'], namespace_ids=[]
+        # Kinds Foo and Bar only in the default namespace:
+        # kinds=['Foo', 'Bar'], namespace_ids=['']
+        # Kinds Foo and Bar in both the default and Baz namespaces:
+        # kinds=['Foo', 'Bar'], namespace_ids=['', 'Baz']
+        # The entire Baz namespace:
+        # kinds=[], namespace_ids=['Baz']
+        # Corresponds to the JSON property `entityFilter`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1EntityFilter]
+        attr_accessor :entity_filter
+      
+        # Location for the export metadata and data files. This will be the same
+        # value as the
+        # google.datastore.admin.v1.ExportEntitiesRequest.output_url_prefix
+        # field. The final output location is provided in
+        # google.datastore.admin.v1.ExportEntitiesResponse.output_url.
+        # Corresponds to the JSON property `outputUrlPrefix`
+        # @return [String]
+        attr_accessor :output_url_prefix
+      
+        # Measures the progress of a particular metric.
+        # Corresponds to the JSON property `progressBytes`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress]
+        attr_accessor :progress_bytes
+      
+        # Measures the progress of a particular metric.
+        # Corresponds to the JSON property `progressEntities`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress]
+        attr_accessor :progress_entities
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @common = args[:common] if args.key?(:common)
+          @entity_filter = args[:entity_filter] if args.key?(:entity_filter)
+          @output_url_prefix = args[:output_url_prefix] if args.key?(:output_url_prefix)
+          @progress_bytes = args[:progress_bytes] if args.key?(:progress_bytes)
+          @progress_entities = args[:progress_entities] if args.key?(:progress_entities)
+        end
+      end
+      
+      # The response for
+      # google.datastore.admin.v1.DatastoreAdmin.ExportEntities.
+      class GoogleDatastoreAdminV1ExportEntitiesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Location of the output metadata file. This can be used to begin an import
+        # into Cloud Datastore (this project or another project). See
+        # google.datastore.admin.v1.ImportEntitiesRequest.input_url.
+        # Only present if the operation completed successfully.
+        # Corresponds to the JSON property `outputUrl`
+        # @return [String]
+        attr_accessor :output_url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @output_url = args[:output_url] if args.key?(:output_url)
+        end
+      end
+      
+      # Metadata for ImportEntities operations.
+      class GoogleDatastoreAdminV1ImportEntitiesMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Metadata common to all Datastore Admin operations.
+        # Corresponds to the JSON property `common`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1CommonMetadata]
+        attr_accessor :common
+      
+        # Identifies a subset of entities in a project. This is specified as
+        # combinations of kinds and namespaces (either or both of which may be all, as
+        # described in the following examples).
+        # Example usage:
+        # Entire project:
+        # kinds=[], namespace_ids=[]
+        # Kinds Foo and Bar in all namespaces:
+        # kinds=['Foo', 'Bar'], namespace_ids=[]
+        # Kinds Foo and Bar only in the default namespace:
+        # kinds=['Foo', 'Bar'], namespace_ids=['']
+        # Kinds Foo and Bar in both the default and Baz namespaces:
+        # kinds=['Foo', 'Bar'], namespace_ids=['', 'Baz']
+        # The entire Baz namespace:
+        # kinds=[], namespace_ids=['Baz']
+        # Corresponds to the JSON property `entityFilter`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1EntityFilter]
+        attr_accessor :entity_filter
+      
+        # The location of the import metadata file. This will be the same value as
+        # the google.datastore.admin.v1.ExportEntitiesResponse.output_url field.
+        # Corresponds to the JSON property `inputUrl`
+        # @return [String]
+        attr_accessor :input_url
+      
+        # Measures the progress of a particular metric.
+        # Corresponds to the JSON property `progressBytes`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress]
+        attr_accessor :progress_bytes
+      
+        # Measures the progress of a particular metric.
+        # Corresponds to the JSON property `progressEntities`
+        # @return [Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress]
+        attr_accessor :progress_entities
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @common = args[:common] if args.key?(:common)
+          @entity_filter = args[:entity_filter] if args.key?(:entity_filter)
+          @input_url = args[:input_url] if args.key?(:input_url)
+          @progress_bytes = args[:progress_bytes] if args.key?(:progress_bytes)
+          @progress_entities = args[:progress_entities] if args.key?(:progress_entities)
+        end
+      end
+      
+      # Measures the progress of a particular metric.
+      class GoogleDatastoreAdminV1Progress
+        include Google::Apis::Core::Hashable
+      
+        # The amount of work that has been completed. Note that this may be greater
+        # than work_estimated.
+        # Corresponds to the JSON property `workCompleted`
+        # @return [Fixnum]
+        attr_accessor :work_completed
+      
+        # An estimate of how much work needs to be performed. May be zero if the
+        # work estimate is unavailable.
+        # Corresponds to the JSON property `workEstimated`
+        # @return [Fixnum]
+        attr_accessor :work_estimated
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @work_completed = args[:work_completed] if args.key?(:work_completed)
+          @work_estimated = args[:work_estimated] if args.key?(:work_estimated)
+        end
+      end
+      
       # Metadata common to all Datastore Admin operations.
       class GoogleDatastoreAdminV1beta1CommonMetadata
         include Google::Apis::Core::Hashable

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

@@ -22,6 +22,42 @@ module Google
   module Apis
     module DatastoreV1beta1
       
+      class GoogleDatastoreAdminV1CommonMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleDatastoreAdminV1EntityFilter
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleDatastoreAdminV1ExportEntitiesMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleDatastoreAdminV1ExportEntitiesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleDatastoreAdminV1ImportEntitiesMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleDatastoreAdminV1Progress
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleDatastoreAdminV1beta1CommonMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -82,6 +118,70 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleDatastoreAdminV1CommonMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_time, as: 'endTime'
+          hash :labels, as: 'labels'
+          property :operation_type, as: 'operationType'
+          property :start_time, as: 'startTime'
+          property :state, as: 'state'
+        end
+      end
+      
+      class GoogleDatastoreAdminV1EntityFilter
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :kinds, as: 'kinds'
+          collection :namespace_ids, as: 'namespaceIds'
+        end
+      end
+      
+      class GoogleDatastoreAdminV1ExportEntitiesMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :common, as: 'common', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1CommonMetadata, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1CommonMetadata::Representation
+      
+          property :entity_filter, as: 'entityFilter', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1EntityFilter, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1EntityFilter::Representation
+      
+          property :output_url_prefix, as: 'outputUrlPrefix'
+          property :progress_bytes, as: 'progressBytes', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress::Representation
+      
+          property :progress_entities, as: 'progressEntities', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress::Representation
+      
+        end
+      end
+      
+      class GoogleDatastoreAdminV1ExportEntitiesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :output_url, as: 'outputUrl'
+        end
+      end
+      
+      class GoogleDatastoreAdminV1ImportEntitiesMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :common, as: 'common', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1CommonMetadata, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1CommonMetadata::Representation
+      
+          property :entity_filter, as: 'entityFilter', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1EntityFilter, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1EntityFilter::Representation
+      
+          property :input_url, as: 'inputUrl'
+          property :progress_bytes, as: 'progressBytes', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress::Representation
+      
+          property :progress_entities, as: 'progressEntities', class: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress, decorator: Google::Apis::DatastoreV1beta1::GoogleDatastoreAdminV1Progress::Representation
+      
+        end
+      end
+      
+      class GoogleDatastoreAdminV1Progress
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :work_completed, :numeric_string => true, as: 'workCompleted'
+          property :work_estimated, :numeric_string => true, as: 'workEstimated'
+        end
+      end
+      
       class GoogleDatastoreAdminV1beta1CommonMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation