service.rb in google-api-client-0.37.0

- old
+ new

@@ -382,10 +382,16 @@
           execute_or_queue_command(command, &block)
         end
         
         # Partially updates a resource containing information about a database inside
         # a Cloud SQL instance. This method supports patch semantics.
+        # <aside
+        # class="caution"><strong>Caution:</strong> This is not a partial update, so
+        # you must include values for all the settings that you want to retain. For
+        # partial updates, use <a
+        # href="/sql/docs/db_path/admin-api/rest/v1beta4/instances/update">update</a>.</
+        # aside>
         # @param [String] project
         #   Project ID of the project that contains the instance.
         # @param [String] instance
         #   Database instance ID. This does not include the project ID.
         # @param [String] database
@@ -865,17 +871,26 @@
         
         # Lists instances under a given project.
         # @param [String] project
         #   Project ID of the project for which to list Cloud SQL instances.
         # @param [String] filter
-        #   An expression for filtering the results of the request, such as by name or
-        #   label.
+        #   A filter expression that filters resources listed in the response.
+        #   The expression is in the form of field:value. For example,
+        #   'instanceType:CLOUD_SQL_INSTANCE'. Fields can be nested as needed as per
+        #   their JSON representation, such as 'settings.userLabels.auto_start:true'.
+        #   Multiple filter queries are space-separated. For example.
+        #   'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. By default, each
+        #   expression is an AND expression. However, you can include AND and OR
+        #   expressions explicitly.
         # @param [Fixnum] max_results
         #   The maximum number of results to return per response.
         # @param [String] page_token
         #   A previously-returned page token representing part of the larger set of
         #   results to view.
+        # @param [String] parent
+        #   The parent, which owns this collection of database instances.
+        #   Format: projects/`project`/locations/`location`
         # @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.
@@ -889,18 +904,19 @@
         # @return [Google::Apis::SqlV1beta4::InstancesListResponse]
         #
         # @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_instances(project, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_instances(project, filter: nil, max_results: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'sql/v1beta4/projects/{project}/instances', options)
           command.response_representation = Google::Apis::SqlV1beta4::InstancesListResponse::Representation
           command.response_class = Google::Apis::SqlV1beta4::InstancesListResponse
           command.params['project'] = project unless project.nil?
           command.query['filter'] = filter unless filter.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -1294,16 +1310,11 @@
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Updates settings of a Cloud SQL instance. <aside
-        # class="caution"><strong>Caution:</strong> This is not a partial update, so
-        # you must include values for all the settings that you want to retain. For
-        # partial updates, use <a
-        # href="/sql/docs/db_path/admin-api/rest/v1beta4/instances/patch">patch</a>.</
-        # aside>
+        # Updates settings of a Cloud SQL instance.
         # @param [String] project
         #   Project ID of the project that contains the instance.
         # @param [String] instance
         #   Cloud SQL instance ID. This does not include the project ID.
         # @param [Google::Apis::SqlV1beta4::DatabaseInstance] database_instance_object
@@ -1464,10 +1475,95 @@
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
+        # Start External master migration.
+        # @param [String] project
+        #   ID of the project that contains the first generation instance.
+        # @param [String] instance
+        #   Cloud SQL instance ID. This does not include the project ID.
+        # @param [String] parent
+        #   The parent resource where Cloud SQL starts this database instance
+        #   external sync. Format:
+        #   projects/`project`/locations/`location`/instances/`instance`
+        # @param [String] sync_mode
+        #   External sync mode
+        # @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::SqlV1beta4::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqlV1beta4::Operation]
+        #
+        # @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 start_project_instance_external_sync(project, instance, parent: nil, sync_mode: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'sql/v1beta4/projects/{project}/instances/{instance}/startExternalSync', options)
+          command.response_representation = Google::Apis::SqlV1beta4::Operation::Representation
+          command.response_class = Google::Apis::SqlV1beta4::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['instance'] = instance unless instance.nil?
+          command.query['parent'] = parent unless parent.nil?
+          command.query['syncMode'] = sync_mode unless sync_mode.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Verify External master external sync settings.
+        # @param [String] project
+        #   Project ID of the project that contains the instance.
+        # @param [String] instance
+        #   Cloud SQL instance ID. This does not include the project ID.
+        # @param [String] parent
+        #   The parent resource where Cloud SQL verifies this database instance
+        #   external sync settings. Format:
+        #   projects/`project`/locations/`location`/instances/`instance`
+        # @param [String] sync_mode
+        #   External sync mode
+        # @param [Boolean] verify_connection_only
+        #   Flag to enable verifying connection only
+        # @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::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse]
+        #
+        # @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 verify_project_instance_external_sync_settings(project, instance, parent: nil, sync_mode: nil, verify_connection_only: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'sql/v1beta4/projects/{project}/instances/{instance}/verifyExternalSyncSettings', options)
+          command.response_representation = Google::Apis::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse::Representation
+          command.response_class = Google::Apis::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse
+          command.params['project'] = project unless project.nil?
+          command.params['instance'] = instance unless instance.nil?
+          command.query['parent'] = parent unless parent.nil?
+          command.query['syncMode'] = sync_mode unless sync_mode.nil?
+          command.query['verifyConnectionOnly'] = verify_connection_only unless verify_connection_only.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Reschedules the maintenance on the given instance.
         # @param [String] parent
         #   The parent resource where Cloud SQL reshedule this database instance's
         #   maintenance. Format:
         #   projects/`project`/locations/`location`/instances/`instance`
@@ -1500,9 +1596,94 @@
           command.response_representation = Google::Apis::SqlV1beta4::Operation::Representation
           command.response_class = Google::Apis::SqlV1beta4::Operation
           command.params['parent'] = parent unless parent.nil?
           command.query['instance'] = instance unless instance.nil?
           command.query['project'] = project unless project.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Start External master migration.
+        # @param [String] parent
+        #   The parent resource where Cloud SQL starts this database instance
+        #   external sync. Format:
+        #   projects/`project`/locations/`location`/instances/`instance`
+        # @param [String] instance
+        #   Cloud SQL instance ID. This does not include the project ID.
+        # @param [String] project
+        #   ID of the project that contains the first generation instance.
+        # @param [String] sync_mode
+        #   External sync mode
+        # @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::SqlV1beta4::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqlV1beta4::Operation]
+        #
+        # @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 start_project_location_instance_external_sync(parent, instance: nil, project: nil, sync_mode: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'sql/v1beta4/{+parent}/startExternalSync', options)
+          command.response_representation = Google::Apis::SqlV1beta4::Operation::Representation
+          command.response_class = Google::Apis::SqlV1beta4::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['instance'] = instance unless instance.nil?
+          command.query['project'] = project unless project.nil?
+          command.query['syncMode'] = sync_mode unless sync_mode.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Verify External master external sync settings.
+        # @param [String] parent
+        #   The parent resource where Cloud SQL verifies this database instance
+        #   external sync settings. Format:
+        #   projects/`project`/locations/`location`/instances/`instance`
+        # @param [String] instance
+        #   Cloud SQL instance ID. This does not include the project ID.
+        # @param [String] project
+        #   Project ID of the project that contains the instance.
+        # @param [String] sync_mode
+        #   External sync mode
+        # @param [Boolean] verify_connection_only
+        #   Flag to enable verifying connection only
+        # @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::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse]
+        #
+        # @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 verify_project_location_instance_external_sync_settings(parent, instance: nil, project: nil, sync_mode: nil, verify_connection_only: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'sql/v1beta4/{+parent}/verifyExternalSyncSettings', options)
+          command.response_representation = Google::Apis::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse::Representation
+          command.response_class = Google::Apis::SqlV1beta4::SqlInstancesVerifyExternalSyncSettingsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['instance'] = instance unless instance.nil?
+          command.query['project'] = project unless project.nil?
+          command.query['syncMode'] = sync_mode unless sync_mode.nil?
+          command.query['verifyConnectionOnly'] = verify_connection_only unless verify_connection_only.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         