From 81cf9040321278088f684b9f5dd5d3cd5d396a0c Mon Sep 17 00:00:00 2001 From: Google APIs Date: Fri, 14 Jun 2019 00:37:43 +0000 Subject: [PATCH] Autogenerated update (2019-06-14) Update: - bigquery_v2 - cloudasset_v1 - cloudasset_v1beta1 - cloudscheduler_v1 - cloudshell_v1 - cloudshell_v1alpha1 - logging_v2 - pubsub_v1 - remotebuildexecution_v1 - remotebuildexecution_v1alpha - remotebuildexecution_v2 - toolresults_v1beta3 --- generated/google/apis/bigquery_v2.rb | 2 +- generated/google/apis/bigquery_v2/classes.rb | 172 +++++++++++++++ .../apis/bigquery_v2/representations.rb | 57 +++++ generated/google/apis/bigquery_v2/service.rb | 206 ++++++++++++++++++ generated/google/apis/cloudasset_v1.rb | 2 +- .../google/apis/cloudasset_v1/classes.rb | 2 +- generated/google/apis/cloudasset_v1beta1.rb | 2 +- .../google/apis/cloudasset_v1beta1/classes.rb | 2 +- generated/google/apis/cloudscheduler_v1.rb | 2 +- .../google/apis/cloudscheduler_v1/classes.rb | 104 ++------- generated/google/apis/cloudshell_v1.rb | 2 +- .../google/apis/cloudshell_v1/classes.rb | 82 +------ generated/google/apis/cloudshell_v1alpha1.rb | 2 +- .../apis/cloudshell_v1alpha1/classes.rb | 82 +------ generated/google/apis/logging_v2.rb | 2 +- generated/google/apis/pubsub_v1.rb | 2 +- generated/google/apis/pubsub_v1/classes.rb | 43 ++++ .../google/apis/pubsub_v1/representations.rb | 16 ++ .../google/apis/remotebuildexecution_v1.rb | 2 +- .../apis/remotebuildexecution_v1/classes.rb | 116 +++++++--- .../representations.rb | 3 + .../apis/remotebuildexecution_v1alpha.rb | 2 +- .../remotebuildexecution_v1alpha/classes.rb | 116 +++++++--- .../representations.rb | 3 + .../remotebuildexecution_v1alpha/service.rb | 17 +- .../google/apis/remotebuildexecution_v2.rb | 2 +- .../apis/remotebuildexecution_v2/classes.rb | 134 +++++++++--- .../representations.rb | 3 + .../apis/remotebuildexecution_v2/service.rb | 31 ++- generated/google/apis/toolresults_v1beta3.rb | 2 +- 30 files changed, 882 insertions(+), 331 deletions(-) diff --git a/generated/google/apis/bigquery_v2.rb b/generated/google/apis/bigquery_v2.rb index 3a132b1204e..4c7c42f8e6a 100644 --- a/generated/google/apis/bigquery_v2.rb +++ b/generated/google/apis/bigquery_v2.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/bigquery/ module BigqueryV2 VERSION = 'V2' - REVISION = '20190530' + REVISION = '20190609' # View and manage your data in Google BigQuery AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery' diff --git a/generated/google/apis/bigquery_v2/classes.rb b/generated/google/apis/bigquery_v2/classes.rb index a934c379775..faaef3896a4 100644 --- a/generated/google/apis/bigquery_v2/classes.rb +++ b/generated/google/apis/bigquery_v2/classes.rb @@ -91,6 +91,54 @@ def update!(**args) end end + # Input/output argument of a function or a stored procedure. + class Argument + include Google::Apis::Core::Hashable + + # Optional. Defaults to FIXED_TYPE. + # Corresponds to the JSON property `argumentKind` + # @return [String] + attr_accessor :argument_kind + + # The type of a variable, e.g., a function argument. + # Examples: + # INT64: `type_kind="INT64"` + # ARRAY: `type_kind="ARRAY", array_element_type="STRING"` + # STRUCT>: + # `type_kind="STRUCT", + # struct_type=`fields=[ + # `name="x", type=`type_kind="STRING"``, + # `name="y", type=`type_kind="ARRAY", array_element_type="DATE"`` + # ]`` + # Corresponds to the JSON property `dataType` + # @return [Google::Apis::BigqueryV2::StandardSqlDataType] + attr_accessor :data_type + + # Optional. Specifies whether the argument is input or output. + # Can be set for procedures only. + # Corresponds to the JSON property `mode` + # @return [String] + attr_accessor :mode + + # Optional. The name of this argument. Can be absent for function return + # argument. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @argument_kind = args[:argument_kind] if args.key?(:argument_kind) + @data_type = args[:data_type] if args.key?(:data_type) + @mode = args[:mode] if args.key?(:mode) + @name = args[:name] if args.key?(:name) + end + end + # class BigQueryModelTraining include Google::Apis::Core::Hashable @@ -3113,6 +3161,33 @@ def update!(**args) end end + # + class ListRoutinesResponse + include Google::Apis::Core::Hashable + + # A token to request the next page of results. + # Corresponds to the JSON property `nextPageToken` + # @return [String] + attr_accessor :next_page_token + + # Routines in the requested dataset. Only the following fields are populated: + # etag, project_id, dataset_id, routine_id, routine_type, creation_time, + # last_modified_time, language. + # Corresponds to the JSON property `routines` + # @return [Array] + attr_accessor :routines + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @next_page_token = args[:next_page_token] if args.key?(:next_page_token) + @routines = args[:routines] if args.key?(:routines) + end + end + # BigQuery-specific metadata about a location. This will be set on # google.cloud.location.Location.metadata in Cloud Location API # responses. @@ -3977,6 +4052,103 @@ def update!(**args) end end + # A user-defined function or a stored procedure. + class Routine + include Google::Apis::Core::Hashable + + # Optional. + # Corresponds to the JSON property `arguments` + # @return [Array] + attr_accessor :arguments + + # Output only. The time when this routine was created, in milliseconds since + # the epoch. + # Corresponds to the JSON property `creationTime` + # @return [Fixnum] + attr_accessor :creation_time + + # Required. The body of the routine. + # For functions, this is the expression in the AS clause. + # If language=SQL, it is the substring inside (but excluding) the + # parentheses. For example, for the function created with the following + # statement + # create function JoinLines(x string, y string) as (concat(x, "\n", y)) + # definition_body = r'concat(x, "\n", y)' (\n is not replaced with + # linebreak). + # If language=JAVASCRIPT, it is the evaluated string in the AS clause. + # For example, for the function created with the following statement + # CREATE FUNCTION f() RETURNS STRING LANGUAGE js AS 'return "\n";\n' + # definition_body = 'return "\n";\n' (both \n are replaced with + # linebreaks). + # Corresponds to the JSON property `definitionBody` + # @return [String] + attr_accessor :definition_body + + # Output only. A hash of this resource. + # Corresponds to the JSON property `etag` + # @return [String] + attr_accessor :etag + + # Optional. If language = "JAVASCRIPT", this field stores the path of the + # imported JAVASCRIPT libraries. + # Corresponds to the JSON property `importedLibraries` + # @return [Array] + attr_accessor :imported_libraries + + # Optional. Defaults to "SQL". + # Corresponds to the JSON property `language` + # @return [String] + attr_accessor :language + + # Output only. The time when this routine was last modified, in milliseconds + # since the epoch. + # Corresponds to the JSON property `lastModifiedTime` + # @return [Fixnum] + attr_accessor :last_modified_time + + # The type of a variable, e.g., a function argument. + # Examples: + # INT64: `type_kind="INT64"` + # ARRAY: `type_kind="ARRAY", array_element_type="STRING"` + # STRUCT>: + # `type_kind="STRUCT", + # struct_type=`fields=[ + # `name="x", type=`type_kind="STRING"``, + # `name="y", type=`type_kind="ARRAY", array_element_type="DATE"`` + # ]`` + # Corresponds to the JSON property `returnType` + # @return [Google::Apis::BigqueryV2::StandardSqlDataType] + attr_accessor :return_type + + # Required. Reference describing the ID of this routine. + # Corresponds to the JSON property `routineReference` + # @return [Google::Apis::BigqueryV2::RoutineReference] + attr_accessor :routine_reference + + # Required. + # Corresponds to the JSON property `routineType` + # @return [String] + attr_accessor :routine_type + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @arguments = args[:arguments] if args.key?(:arguments) + @creation_time = args[:creation_time] if args.key?(:creation_time) + @definition_body = args[:definition_body] if args.key?(:definition_body) + @etag = args[:etag] if args.key?(:etag) + @imported_libraries = args[:imported_libraries] if args.key?(:imported_libraries) + @language = args[:language] if args.key?(:language) + @last_modified_time = args[:last_modified_time] if args.key?(:last_modified_time) + @return_type = args[:return_type] if args.key?(:return_type) + @routine_reference = args[:routine_reference] if args.key?(:routine_reference) + @routine_type = args[:routine_type] if args.key?(:routine_type) + end + end + # class RoutineReference include Google::Apis::Core::Hashable diff --git a/generated/google/apis/bigquery_v2/representations.rb b/generated/google/apis/bigquery_v2/representations.rb index 841190f77d9..c20b5f96362 100644 --- a/generated/google/apis/bigquery_v2/representations.rb +++ b/generated/google/apis/bigquery_v2/representations.rb @@ -28,6 +28,12 @@ class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end + class Argument + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class BigQueryModelTraining class Representation < Google::Apis::Core::JsonRepresentation; end @@ -322,6 +328,12 @@ class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end + class ListRoutinesResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class LocationMetadata class Representation < Google::Apis::Core::JsonRepresentation; end @@ -442,6 +454,12 @@ class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end + class Routine + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class RoutineReference class Representation < Google::Apis::Core::JsonRepresentation; end @@ -611,6 +629,17 @@ class Representation < Google::Apis::Core::JsonRepresentation end end + class Argument + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :argument_kind, as: 'argumentKind' + property :data_type, as: 'dataType', class: Google::Apis::BigqueryV2::StandardSqlDataType, decorator: Google::Apis::BigqueryV2::StandardSqlDataType::Representation + + property :mode, as: 'mode' + property :name, as: 'name' + end + end + class BigQueryModelTraining # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -1302,6 +1331,15 @@ class Representation < Google::Apis::Core::JsonRepresentation end end + class ListRoutinesResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :next_page_token, as: 'nextPageToken' + collection :routines, as: 'routines', class: Google::Apis::BigqueryV2::Routine, decorator: Google::Apis::BigqueryV2::Routine::Representation + + end + end + class LocationMetadata # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -1533,6 +1571,25 @@ class Representation < Google::Apis::Core::JsonRepresentation end end + class Routine + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :arguments, as: 'arguments', class: Google::Apis::BigqueryV2::Argument, decorator: Google::Apis::BigqueryV2::Argument::Representation + + property :creation_time, :numeric_string => true, as: 'creationTime' + property :definition_body, as: 'definitionBody' + property :etag, as: 'etag' + collection :imported_libraries, as: 'importedLibraries' + property :language, as: 'language' + property :last_modified_time, :numeric_string => true, as: 'lastModifiedTime' + property :return_type, as: 'returnType', class: Google::Apis::BigqueryV2::StandardSqlDataType, decorator: Google::Apis::BigqueryV2::StandardSqlDataType::Representation + + property :routine_reference, as: 'routineReference', class: Google::Apis::BigqueryV2::RoutineReference, decorator: Google::Apis::BigqueryV2::RoutineReference::Representation + + property :routine_type, as: 'routineType' + end + end + class RoutineReference # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/bigquery_v2/service.rb b/generated/google/apis/bigquery_v2/service.rb index 4dd43c9cbba..7c6309e41c6 100644 --- a/generated/google/apis/bigquery_v2/service.rb +++ b/generated/google/apis/bigquery_v2/service.rb @@ -809,6 +809,212 @@ def list_projects(max_results: nil, page_token: nil, fields: nil, quota_user: ni execute_or_queue_command(command, &block) end + # Deletes the routine specified by routineId from the dataset. + # @param [String] project_id + # Project ID of the routine to delete + # @param [String] dataset_id + # Dataset ID of the routine to delete + # @param [String] routine_id + # Routine ID of the routine to delete + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # An opaque string that represents a user for quota purposes. Must not exceed 40 + # characters. + # @param [String] user_ip + # Deprecated. Please use quotaUser instead. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [NilClass] No result returned for this method + # @yieldparam err [StandardError] error object if request failed + # + # @return [void] + # + # @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 delete_routine(project_id, dataset_id, routine_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) + command = make_simple_command(:delete, 'projects/{+projectId}/datasets/{+datasetId}/routines/{+routineId}', options) + command.params['projectId'] = project_id unless project_id.nil? + command.params['datasetId'] = dataset_id unless dataset_id.nil? + command.params['routineId'] = routine_id unless routine_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + command.query['userIp'] = user_ip unless user_ip.nil? + execute_or_queue_command(command, &block) + end + + # Gets the specified routine resource by routine ID. + # @param [String] project_id + # Project ID of the requested routine + # @param [String] dataset_id + # Dataset ID of the requested routine + # @param [String] routine_id + # Routine ID of the requested routine + # @param [String] field_mask + # If set, only the Routine fields in the field mask are returned in the + # response. If unset, all Routine fields are returned. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # An opaque string that represents a user for quota purposes. Must not exceed 40 + # characters. + # @param [String] user_ip + # Deprecated. Please use quotaUser instead. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::BigqueryV2::Routine] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::BigqueryV2::Routine] + # + # @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 get_routine(project_id, dataset_id, routine_id, field_mask: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) + command = make_simple_command(:get, 'projects/{+projectId}/datasets/{+datasetId}/routines/{+routineId}', options) + command.response_representation = Google::Apis::BigqueryV2::Routine::Representation + command.response_class = Google::Apis::BigqueryV2::Routine + command.params['projectId'] = project_id unless project_id.nil? + command.params['datasetId'] = dataset_id unless dataset_id.nil? + command.params['routineId'] = routine_id unless routine_id.nil? + command.query['fieldMask'] = field_mask unless field_mask.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + command.query['userIp'] = user_ip unless user_ip.nil? + execute_or_queue_command(command, &block) + end + + # Creates a new routine in the dataset. + # @param [String] project_id + # Project ID of the new routine + # @param [String] dataset_id + # Dataset ID of the new routine + # @param [Google::Apis::BigqueryV2::Routine] routine_object + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # An opaque string that represents a user for quota purposes. Must not exceed 40 + # characters. + # @param [String] user_ip + # Deprecated. Please use quotaUser instead. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::BigqueryV2::Routine] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::BigqueryV2::Routine] + # + # @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 insert_routine(project_id, dataset_id, routine_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) + command = make_simple_command(:post, 'projects/{+projectId}/datasets/{+datasetId}/routines', options) + command.request_representation = Google::Apis::BigqueryV2::Routine::Representation + command.request_object = routine_object + command.response_representation = Google::Apis::BigqueryV2::Routine::Representation + command.response_class = Google::Apis::BigqueryV2::Routine + command.params['projectId'] = project_id unless project_id.nil? + command.params['datasetId'] = dataset_id unless dataset_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + command.query['userIp'] = user_ip unless user_ip.nil? + execute_or_queue_command(command, &block) + end + + # Lists all routines in the specified dataset. Requires the READER dataset + # role. + # @param [String] project_id + # Project ID of the routines to list + # @param [String] dataset_id + # Dataset ID of the routines to list + # @param [Fixnum] max_results + # The maximum number of results per page. + # @param [String] page_token + # Page token, returned by a previous call, to request the next page of + # results + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # An opaque string that represents a user for quota purposes. Must not exceed 40 + # characters. + # @param [String] user_ip + # Deprecated. Please use quotaUser instead. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::BigqueryV2::ListRoutinesResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::BigqueryV2::ListRoutinesResponse] + # + # @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_routines(project_id, dataset_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) + command = make_simple_command(:get, 'projects/{+projectId}/datasets/{+datasetId}/routines', options) + command.response_representation = Google::Apis::BigqueryV2::ListRoutinesResponse::Representation + command.response_class = Google::Apis::BigqueryV2::ListRoutinesResponse + command.params['projectId'] = project_id unless project_id.nil? + command.params['datasetId'] = dataset_id unless dataset_id.nil? + command.query['maxResults'] = max_results unless max_results.nil? + command.query['pageToken'] = page_token unless page_token.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + command.query['userIp'] = user_ip unless user_ip.nil? + execute_or_queue_command(command, &block) + end + + # Updates information in an existing routine. The update method replaces the + # entire Routine resource. + # @param [String] project_id + # Project ID of the routine to update + # @param [String] dataset_id + # Dataset ID of the routine to update + # @param [String] routine_id + # Routine ID of the routine to update + # @param [Google::Apis::BigqueryV2::Routine] routine_object + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # An opaque string that represents a user for quota purposes. Must not exceed 40 + # characters. + # @param [String] user_ip + # Deprecated. Please use quotaUser instead. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::BigqueryV2::Routine] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::BigqueryV2::Routine] + # + # @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 update_routine(project_id, dataset_id, routine_id, routine_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) + command = make_simple_command(:put, 'projects/{+projectId}/datasets/{+datasetId}/routines/{+routineId}', options) + command.request_representation = Google::Apis::BigqueryV2::Routine::Representation + command.request_object = routine_object + command.response_representation = Google::Apis::BigqueryV2::Routine::Representation + command.response_class = Google::Apis::BigqueryV2::Routine + command.params['projectId'] = project_id unless project_id.nil? + command.params['datasetId'] = dataset_id unless dataset_id.nil? + command.params['routineId'] = routine_id unless routine_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + command.query['userIp'] = user_ip unless user_ip.nil? + execute_or_queue_command(command, &block) + end + # Streams data into BigQuery one record at a time without needing to run a load # job. Requires the WRITER dataset role. # @param [String] project_id diff --git a/generated/google/apis/cloudasset_v1.rb b/generated/google/apis/cloudasset_v1.rb index b0c8b8b2e25..353c0e3325d 100644 --- a/generated/google/apis/cloudasset_v1.rb +++ b/generated/google/apis/cloudasset_v1.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/quickstart-cloud-asset-inventory module CloudassetV1 VERSION = 'V1' - REVISION = '20190521' + REVISION = '20190612' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudasset_v1/classes.rb b/generated/google/apis/cloudasset_v1/classes.rb index a238d445676..dd66f58e4c1 100644 --- a/generated/google/apis/cloudasset_v1/classes.rb +++ b/generated/google/apis/cloudasset_v1/classes.rb @@ -481,7 +481,7 @@ class Operation # The server-assigned name, which is only unique within the same service that # originally returns it. If you use the default HTTP mapping, the - # `name` should be a resource name ending with `operations/`unique_id``. + # `name` should have the format of `operations/some/unique/name`. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name diff --git a/generated/google/apis/cloudasset_v1beta1.rb b/generated/google/apis/cloudasset_v1beta1.rb index f81fdb562c8..3e23bb7e907 100644 --- a/generated/google/apis/cloudasset_v1beta1.rb +++ b/generated/google/apis/cloudasset_v1beta1.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/quickstart-cloud-asset-inventory module CloudassetV1beta1 VERSION = 'V1beta1' - REVISION = '20190521' + REVISION = '20190612' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudasset_v1beta1/classes.rb b/generated/google/apis/cloudasset_v1beta1/classes.rb index e6a5aa89c16..083efd8f651 100644 --- a/generated/google/apis/cloudasset_v1beta1/classes.rb +++ b/generated/google/apis/cloudasset_v1beta1/classes.rb @@ -480,7 +480,7 @@ class Operation # The server-assigned name, which is only unique within the same service that # originally returns it. If you use the default HTTP mapping, the - # `name` should be a resource name ending with `operations/`unique_id``. + # `name` should have the format of `operations/some/unique/name`. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name diff --git a/generated/google/apis/cloudscheduler_v1.rb b/generated/google/apis/cloudscheduler_v1.rb index 1d858aa851b..506580bb52b 100644 --- a/generated/google/apis/cloudscheduler_v1.rb +++ b/generated/google/apis/cloudscheduler_v1.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/scheduler/ module CloudschedulerV1 VERSION = 'V1' - REVISION = '20190429' + REVISION = '20190604' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudscheduler_v1/classes.rb b/generated/google/apis/cloudscheduler_v1/classes.rb index 51b4222b81f..ce0bf5c578a 100644 --- a/generated/google/apis/cloudscheduler_v1/classes.rb +++ b/generated/google/apis/cloudscheduler_v1/classes.rb @@ -287,17 +287,18 @@ class HttpTarget # Contains information needed for generating an # [OAuth token](https://developers.google.com/identity/protocols/OAuth2). - # This type of authorization should be used when sending requests to a GCP - # endpoint. + # This type of authorization should generally only be used when calling Google + # APIs hosted on *.googleapis.com. # Corresponds to the JSON property `oauthToken` # @return [Google::Apis::CloudschedulerV1::OAuthToken] attr_accessor :oauth_token # Contains information needed for generating an # [OpenID Connect - # token](https://developers.google.com/identity/protocols/OpenIDConnect). This - # type of authorization should be used when sending requests to third party - # endpoints or Cloud Run. + # token](https://developers.google.com/identity/protocols/OpenIDConnect). + # This type of authorization can be used for many scenarios, including + # calling Cloud Run, or endpoints where you intend to validate the token + # yourself. # Corresponds to the JSON property `oidcToken` # @return [Google::Apis::CloudschedulerV1::OidcToken] attr_accessor :oidc_token @@ -453,43 +454,10 @@ class Job # The `Status` type defines a logical error model that is suitable for # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). The error model is designed to be: - # - Simple to use and understand for most users - # - Flexible enough to meet unexpected needs - # # Overview - # The `Status` message contains three pieces of data: error code, error - # message, and error details. The error code should be an enum value of - # google.rpc.Code, but it may accept additional error codes if needed. The - # error message should be a developer-facing English message that helps - # developers *understand* and *resolve* the error. If a localized user-facing - # error message is needed, put the localized message in the error details or - # localize it in the client. The optional error details may contain arbitrary - # information about the error. There is a predefined set of error detail types - # in the package `google.rpc` that can be used for common error conditions. - # # Language mapping - # The `Status` message is the logical representation of the error model, but it - # is not necessarily the actual wire format. When the `Status` message is - # exposed in different client libraries and different wire protocols, it can be - # mapped differently. For example, it will likely be mapped to some exceptions - # in Java, but more likely mapped to some error codes in C. - # # Other uses - # The error model and the `Status` message can be used in a variety of - # environments, either with or without APIs, to provide a - # consistent developer experience across different environments. - # Example uses of this error model include: - # - Partial errors. If a service needs to return partial errors to the client, - # it may embed the `Status` in the normal response to indicate the partial - # errors. - # - Workflow errors. A typical workflow has multiple steps. Each step may - # have a `Status` message for error reporting. - # - Batch operations. If a client uses batch request and batch response, the - # `Status` message should be used directly inside batch response, one for - # each error sub-response. - # - Asynchronous operations. If an API call embeds asynchronous operation - # results in its response, the status of those operations should be - # represented directly using the `Status` message. - # - Logging. If some API errors are stored in logs, the message `Status` could - # be used directly after any stripping needed for security/privacy reasons. + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). # Corresponds to the JSON property `status` # @return [Google::Apis::CloudschedulerV1::Status] attr_accessor :status @@ -638,8 +606,8 @@ def update!(**args) # Contains information needed for generating an # [OAuth token](https://developers.google.com/identity/protocols/OAuth2). - # This type of authorization should be used when sending requests to a GCP - # endpoint. + # This type of authorization should generally only be used when calling Google + # APIs hosted on *.googleapis.com. class OAuthToken include Google::Apis::Core::Hashable @@ -671,9 +639,10 @@ def update!(**args) # Contains information needed for generating an # [OpenID Connect - # token](https://developers.google.com/identity/protocols/OpenIDConnect). This - # type of authorization should be used when sending requests to third party - # endpoints or Cloud Run. + # token](https://developers.google.com/identity/protocols/OpenIDConnect). + # This type of authorization can be used for many scenarios, including + # calling Cloud Run, or endpoints where you intend to validate the token + # yourself. class OidcToken include Google::Apis::Core::Hashable @@ -920,43 +889,10 @@ def update!(**args) # The `Status` type defines a logical error model that is suitable for # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). The error model is designed to be: - # - Simple to use and understand for most users - # - Flexible enough to meet unexpected needs - # # Overview - # The `Status` message contains three pieces of data: error code, error - # message, and error details. The error code should be an enum value of - # google.rpc.Code, but it may accept additional error codes if needed. The - # error message should be a developer-facing English message that helps - # developers *understand* and *resolve* the error. If a localized user-facing - # error message is needed, put the localized message in the error details or - # localize it in the client. The optional error details may contain arbitrary - # information about the error. There is a predefined set of error detail types - # in the package `google.rpc` that can be used for common error conditions. - # # Language mapping - # The `Status` message is the logical representation of the error model, but it - # is not necessarily the actual wire format. When the `Status` message is - # exposed in different client libraries and different wire protocols, it can be - # mapped differently. For example, it will likely be mapped to some exceptions - # in Java, but more likely mapped to some error codes in C. - # # Other uses - # The error model and the `Status` message can be used in a variety of - # environments, either with or without APIs, to provide a - # consistent developer experience across different environments. - # Example uses of this error model include: - # - Partial errors. If a service needs to return partial errors to the client, - # it may embed the `Status` in the normal response to indicate the partial - # errors. - # - Workflow errors. A typical workflow has multiple steps. Each step may - # have a `Status` message for error reporting. - # - Batch operations. If a client uses batch request and batch response, the - # `Status` message should be used directly inside batch response, one for - # each error sub-response. - # - Asynchronous operations. If an API call embeds asynchronous operation - # results in its response, the status of those operations should be - # represented directly using the `Status` message. - # - Logging. If some API errors are stored in logs, the message `Status` could - # be used directly after any stripping needed for security/privacy reasons. + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). class Status include Google::Apis::Core::Hashable diff --git a/generated/google/apis/cloudshell_v1.rb b/generated/google/apis/cloudshell_v1.rb index 22bd5f4c52c..3f12325c1cb 100644 --- a/generated/google/apis/cloudshell_v1.rb +++ b/generated/google/apis/cloudshell_v1.rb @@ -26,7 +26,7 @@ module Apis # @see https://cloud.google.com/shell/docs/ module CloudshellV1 VERSION = 'V1' - REVISION = '20190511' + REVISION = '20190610' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudshell_v1/classes.rb b/generated/google/apis/cloudshell_v1/classes.rb index 3f90655ad28..15d65f9d9b9 100644 --- a/generated/google/apis/cloudshell_v1/classes.rb +++ b/generated/google/apis/cloudshell_v1/classes.rb @@ -170,43 +170,10 @@ class Operation # The `Status` type defines a logical error model that is suitable for # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). The error model is designed to be: - # - Simple to use and understand for most users - # - Flexible enough to meet unexpected needs - # # Overview - # The `Status` message contains three pieces of data: error code, error - # message, and error details. The error code should be an enum value of - # google.rpc.Code, but it may accept additional error codes if needed. The - # error message should be a developer-facing English message that helps - # developers *understand* and *resolve* the error. If a localized user-facing - # error message is needed, put the localized message in the error details or - # localize it in the client. The optional error details may contain arbitrary - # information about the error. There is a predefined set of error detail types - # in the package `google.rpc` that can be used for common error conditions. - # # Language mapping - # The `Status` message is the logical representation of the error model, but it - # is not necessarily the actual wire format. When the `Status` message is - # exposed in different client libraries and different wire protocols, it can be - # mapped differently. For example, it will likely be mapped to some exceptions - # in Java, but more likely mapped to some error codes in C. - # # Other uses - # The error model and the `Status` message can be used in a variety of - # environments, either with or without APIs, to provide a - # consistent developer experience across different environments. - # Example uses of this error model include: - # - Partial errors. If a service needs to return partial errors to the client, - # it may embed the `Status` in the normal response to indicate the partial - # errors. - # - Workflow errors. A typical workflow has multiple steps. Each step may - # have a `Status` message for error reporting. - # - Batch operations. If a client uses batch request and batch response, the - # `Status` message should be used directly inside batch response, one for - # each error sub-response. - # - Asynchronous operations. If an API call embeds asynchronous operation - # results in its response, the status of those operations should be - # represented directly using the `Status` message. - # - Logging. If some API errors are stored in logs, the message `Status` could - # be used directly after any stripping needed for security/privacy reasons. + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). # Corresponds to the JSON property `error` # @return [Google::Apis::CloudshellV1::Status] attr_accessor :error @@ -335,43 +302,10 @@ def update!(**args) # The `Status` type defines a logical error model that is suitable for # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). The error model is designed to be: - # - Simple to use and understand for most users - # - Flexible enough to meet unexpected needs - # # Overview - # The `Status` message contains three pieces of data: error code, error - # message, and error details. The error code should be an enum value of - # google.rpc.Code, but it may accept additional error codes if needed. The - # error message should be a developer-facing English message that helps - # developers *understand* and *resolve* the error. If a localized user-facing - # error message is needed, put the localized message in the error details or - # localize it in the client. The optional error details may contain arbitrary - # information about the error. There is a predefined set of error detail types - # in the package `google.rpc` that can be used for common error conditions. - # # Language mapping - # The `Status` message is the logical representation of the error model, but it - # is not necessarily the actual wire format. When the `Status` message is - # exposed in different client libraries and different wire protocols, it can be - # mapped differently. For example, it will likely be mapped to some exceptions - # in Java, but more likely mapped to some error codes in C. - # # Other uses - # The error model and the `Status` message can be used in a variety of - # environments, either with or without APIs, to provide a - # consistent developer experience across different environments. - # Example uses of this error model include: - # - Partial errors. If a service needs to return partial errors to the client, - # it may embed the `Status` in the normal response to indicate the partial - # errors. - # - Workflow errors. A typical workflow has multiple steps. Each step may - # have a `Status` message for error reporting. - # - Batch operations. If a client uses batch request and batch response, the - # `Status` message should be used directly inside batch response, one for - # each error sub-response. - # - Asynchronous operations. If an API call embeds asynchronous operation - # results in its response, the status of those operations should be - # represented directly using the `Status` message. - # - Logging. If some API errors are stored in logs, the message `Status` could - # be used directly after any stripping needed for security/privacy reasons. + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). class Status include Google::Apis::Core::Hashable diff --git a/generated/google/apis/cloudshell_v1alpha1.rb b/generated/google/apis/cloudshell_v1alpha1.rb index bf82f5f21eb..ce5678edf69 100644 --- a/generated/google/apis/cloudshell_v1alpha1.rb +++ b/generated/google/apis/cloudshell_v1alpha1.rb @@ -26,7 +26,7 @@ module Apis # @see https://cloud.google.com/shell/docs/ module CloudshellV1alpha1 VERSION = 'V1alpha1' - REVISION = '20190511' + REVISION = '20190610' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudshell_v1alpha1/classes.rb b/generated/google/apis/cloudshell_v1alpha1/classes.rb index 8818e2384df..17d73766033 100644 --- a/generated/google/apis/cloudshell_v1alpha1/classes.rb +++ b/generated/google/apis/cloudshell_v1alpha1/classes.rb @@ -183,43 +183,10 @@ class Operation # The `Status` type defines a logical error model that is suitable for # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). The error model is designed to be: - # - Simple to use and understand for most users - # - Flexible enough to meet unexpected needs - # # Overview - # The `Status` message contains three pieces of data: error code, error - # message, and error details. The error code should be an enum value of - # google.rpc.Code, but it may accept additional error codes if needed. The - # error message should be a developer-facing English message that helps - # developers *understand* and *resolve* the error. If a localized user-facing - # error message is needed, put the localized message in the error details or - # localize it in the client. The optional error details may contain arbitrary - # information about the error. There is a predefined set of error detail types - # in the package `google.rpc` that can be used for common error conditions. - # # Language mapping - # The `Status` message is the logical representation of the error model, but it - # is not necessarily the actual wire format. When the `Status` message is - # exposed in different client libraries and different wire protocols, it can be - # mapped differently. For example, it will likely be mapped to some exceptions - # in Java, but more likely mapped to some error codes in C. - # # Other uses - # The error model and the `Status` message can be used in a variety of - # environments, either with or without APIs, to provide a - # consistent developer experience across different environments. - # Example uses of this error model include: - # - Partial errors. If a service needs to return partial errors to the client, - # it may embed the `Status` in the normal response to indicate the partial - # errors. - # - Workflow errors. A typical workflow has multiple steps. Each step may - # have a `Status` message for error reporting. - # - Batch operations. If a client uses batch request and batch response, the - # `Status` message should be used directly inside batch response, one for - # each error sub-response. - # - Asynchronous operations. If an API call embeds asynchronous operation - # results in its response, the status of those operations should be - # represented directly using the `Status` message. - # - Logging. If some API errors are stored in logs, the message `Status` could - # be used directly after any stripping needed for security/privacy reasons. + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). # Corresponds to the JSON property `error` # @return [Google::Apis::CloudshellV1alpha1::Status] attr_accessor :error @@ -370,43 +337,10 @@ def update!(**args) # The `Status` type defines a logical error model that is suitable for # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). The error model is designed to be: - # - Simple to use and understand for most users - # - Flexible enough to meet unexpected needs - # # Overview - # The `Status` message contains three pieces of data: error code, error - # message, and error details. The error code should be an enum value of - # google.rpc.Code, but it may accept additional error codes if needed. The - # error message should be a developer-facing English message that helps - # developers *understand* and *resolve* the error. If a localized user-facing - # error message is needed, put the localized message in the error details or - # localize it in the client. The optional error details may contain arbitrary - # information about the error. There is a predefined set of error detail types - # in the package `google.rpc` that can be used for common error conditions. - # # Language mapping - # The `Status` message is the logical representation of the error model, but it - # is not necessarily the actual wire format. When the `Status` message is - # exposed in different client libraries and different wire protocols, it can be - # mapped differently. For example, it will likely be mapped to some exceptions - # in Java, but more likely mapped to some error codes in C. - # # Other uses - # The error model and the `Status` message can be used in a variety of - # environments, either with or without APIs, to provide a - # consistent developer experience across different environments. - # Example uses of this error model include: - # - Partial errors. If a service needs to return partial errors to the client, - # it may embed the `Status` in the normal response to indicate the partial - # errors. - # - Workflow errors. A typical workflow has multiple steps. Each step may - # have a `Status` message for error reporting. - # - Batch operations. If a client uses batch request and batch response, the - # `Status` message should be used directly inside batch response, one for - # each error sub-response. - # - Asynchronous operations. If an API call embeds asynchronous operation - # results in its response, the status of those operations should be - # represented directly using the `Status` message. - # - Logging. If some API errors are stored in logs, the message `Status` could - # be used directly after any stripping needed for security/privacy reasons. + # used by [gRPC](https://github.com/grpc). Each `Status` message contains + # three pieces of data: error code, error message, and error details. + # You can find out more about this error model and how to work with it in the + # [API Design Guide](https://cloud.google.com/apis/design/errors). class Status include Google::Apis::Core::Hashable diff --git a/generated/google/apis/logging_v2.rb b/generated/google/apis/logging_v2.rb index 85213e52c07..d093c0ac720 100644 --- a/generated/google/apis/logging_v2.rb +++ b/generated/google/apis/logging_v2.rb @@ -28,7 +28,7 @@ module Apis # @see https://cloud.google.com/logging/docs/ module LoggingV2 VERSION = 'V2' - REVISION = '20190531' + REVISION = '20190608' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/pubsub_v1.rb b/generated/google/apis/pubsub_v1.rb index 8213415e5ca..dbdc3ac0ac3 100644 --- a/generated/google/apis/pubsub_v1.rb +++ b/generated/google/apis/pubsub_v1.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/pubsub/docs module PubsubV1 VERSION = 'V1' - REVISION = '20190429' + REVISION = '20190606' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/pubsub_v1/classes.rb b/generated/google/apis/pubsub_v1/classes.rb index 949744ebe3d..4ef12e6de8d 100644 --- a/generated/google/apis/pubsub_v1/classes.rb +++ b/generated/google/apis/pubsub_v1/classes.rb @@ -348,6 +348,30 @@ def update!(**args) end end + # + class MessageStoragePolicy + include Google::Apis::Core::Hashable + + # The list of GCP region IDs where messages that are published to the topic + # may be persisted in storage. Messages published by publishers running in + # non-allowed GCP regions (or running outside of GCP altogether) will be + # routed for storage in one of the allowed regions. An empty list indicates a + # misconfiguration at the project or organization level, which will result in + # all Publish operations failing. + # Corresponds to the JSON property `allowedPersistenceRegions` + # @return [Array] + attr_accessor :allowed_persistence_regions + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @allowed_persistence_regions = args[:allowed_persistence_regions] if args.key?(:allowed_persistence_regions) + end + end + # Request for the ModifyAckDeadline method. class ModifyAckDeadlineRequest include Google::Apis::Core::Hashable @@ -1038,12 +1062,29 @@ def update!(**args) class Topic include Google::Apis::Core::Hashable + # The resource name of the Cloud KMS CryptoKey to be used to protect access + # to messages published on this topic. + # The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`. + # Corresponds to the JSON property `kmsKeyName` + # @return [String] + attr_accessor :kms_key_name + # See Creating and # managing labels. # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels + # Policy constraining how messages published to the topic may be stored. It + # is determined when the topic is created based on the policy configured at + # the project level. It must not be set by the caller in the request to + # CreateTopic or to UpdateTopic. This field will be populated in the + # responses for GetTopic, CreateTopic, and UpdateTopic: if not present in the + # response, then no constraints are in effect. + # Corresponds to the JSON property `messageStoragePolicy` + # @return [Google::Apis::PubsubV1::MessageStoragePolicy] + attr_accessor :message_storage_policy + # The name of the topic. It must have the format # `"projects/`project`/topics/`topic`"`. ``topic`` must start with a letter, # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), @@ -1060,7 +1101,9 @@ def initialize(**args) # Update properties of this object def update!(**args) + @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name) @labels = args[:labels] if args.key?(:labels) + @message_storage_policy = args[:message_storage_policy] if args.key?(:message_storage_policy) @name = args[:name] if args.key?(:name) end end diff --git a/generated/google/apis/pubsub_v1/representations.rb b/generated/google/apis/pubsub_v1/representations.rb index db56eede89a..cf73b8571b7 100644 --- a/generated/google/apis/pubsub_v1/representations.rb +++ b/generated/google/apis/pubsub_v1/representations.rb @@ -88,6 +88,12 @@ class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end + class MessageStoragePolicy + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ModifyAckDeadlineRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -311,6 +317,13 @@ class Representation < Google::Apis::Core::JsonRepresentation end end + class MessageStoragePolicy + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :allowed_persistence_regions, as: 'allowedPersistenceRegions' + end + end + class ModifyAckDeadlineRequest # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -470,7 +483,10 @@ class Representation < Google::Apis::Core::JsonRepresentation class Topic # @private class Representation < Google::Apis::Core::JsonRepresentation + property :kms_key_name, as: 'kmsKeyName' hash :labels, as: 'labels' + property :message_storage_policy, as: 'messageStoragePolicy', class: Google::Apis::PubsubV1::MessageStoragePolicy, decorator: Google::Apis::PubsubV1::MessageStoragePolicy::Representation + property :name, as: 'name' end end diff --git a/generated/google/apis/remotebuildexecution_v1.rb b/generated/google/apis/remotebuildexecution_v1.rb index b556cbc66e2..1fa7cfca122 100644 --- a/generated/google/apis/remotebuildexecution_v1.rb +++ b/generated/google/apis/remotebuildexecution_v1.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/remote-build-execution/docs/ module RemotebuildexecutionV1 VERSION = 'V1' - REVISION = '20190604' + REVISION = '20190612' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/remotebuildexecution_v1/classes.rb b/generated/google/apis/remotebuildexecution_v1/classes.rb index 8ada66471a0..f3e75ef6144 100644 --- a/generated/google/apis/remotebuildexecution_v1/classes.rb +++ b/generated/google/apis/remotebuildexecution_v1/classes.rb @@ -75,7 +75,8 @@ class BuildBazelRemoteExecutionV2Action # @return [Google::Apis::RemotebuildexecutionV1::BuildBazelRemoteExecutionV2Digest] attr_accessor :command_digest - # If true, then the `Action`'s result cannot be cached. + # If true, then the `Action`'s result cannot be cached, and in-flight + # requests for the same `Action` may not be merged. # Corresponds to the JSON property `doNotCache` # @return [Boolean] attr_accessor :do_not_cache @@ -216,6 +217,8 @@ class BuildBazelRemoteExecutionV2ActionResult # ` # ` # ``` + # If an output of the same name was found, but was not a directory, the + # server will return a FAILED_PRECONDITION. # Corresponds to the JSON property `outputDirectories` # @return [Array] attr_accessor :output_directories @@ -226,11 +229,12 @@ class BuildBazelRemoteExecutionV2ActionResult # if the server supports # SymlinkAbsolutePathStrategy.ALLOWED. # For each output directory requested in the `output_directories` field of - # the Action, if the directory file existed after - # the action completed, a single entry will be present either in this field, - # or in the `output_directories` field, if the directory was not a symbolic link. - # If the action does not produce the requested output, or produces a - # file where a directory is expected or vice versa, then that output + # the Action, if the directory existed after the action completed, a + # single entry will be present either in this field, or in the + # `output_directories` field, if the directory was not a symbolic link. + # If an output of the same name was found, but was a symbolic link to a file + # instead of a directory, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputDirectorySymlinks` @@ -245,8 +249,9 @@ class BuildBazelRemoteExecutionV2ActionResult # if the corresponding file existed after # the action completed, a single entry will be present either in this field, # or in the `output_files` field, if the file was not a symbolic link. - # If the action does not produce the requested output, or produces a - # directory where a regular file is expected or vice versa, then that output + # If an output symbolic link of the same name was found, but its target + # type was not a regular file, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputFileSymlinks` @@ -256,10 +261,11 @@ class BuildBazelRemoteExecutionV2ActionResult # The output files of the action. For each output file requested in the # `output_files` field of the Action, if the corresponding file existed after # the action completed, a single entry will be present either in this field, - # or in the output_file_symlinks field, if the file was a symbolic link to + # or the `output_file_symlinks` field if the file was a symbolic link to # another file. - # If the action does not produce the requested output, or produces a - # directory where a regular file is expected or vice versa, then that output + # If an output of the same name was found, but was a directory rather + # than a regular file, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputFiles` @@ -297,12 +303,12 @@ class BuildBazelRemoteExecutionV2ActionResult # @return [Google::Apis::RemotebuildexecutionV1::BuildBazelRemoteExecutionV2Digest] attr_accessor :stderr_digest - # The standard error buffer of the action. The server will determine, based - # on the size of the buffer, whether to return it in raw form or to return - # a digest in `stderr_digest` that points to the buffer. If neither is set, - # then the buffer is empty. The client SHOULD NOT assume it will get one of - # the raw buffer or a digest on any given request and should be prepared to - # handle either. + # The standard error buffer of the action. The server SHOULD NOT inline + # stderr unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. # Corresponds to the JSON property `stderrRaw` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -339,12 +345,12 @@ class BuildBazelRemoteExecutionV2ActionResult # @return [Google::Apis::RemotebuildexecutionV1::BuildBazelRemoteExecutionV2Digest] attr_accessor :stdout_digest - # The standard output buffer of the action. The server will determine, based - # on the size of the buffer, whether to return it in raw form or to return - # a digest in `stdout_digest` that points to the buffer. If neither is set, - # then the buffer is empty. The client SHOULD NOT assume it will get one of - # the raw buffer or a digest on any given request and should be prepared to - # handle either. + # The standard output buffer of the action. The server SHOULD NOT inline + # stdout unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. # Corresponds to the JSON property `stdoutRaw` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -414,7 +420,8 @@ class BuildBazelRemoteExecutionV2Command # MUST be sorted lexicographically by code point (or, equivalently, by UTF-8 # bytes). # An output directory cannot be duplicated or have the same path as any of - # the listed output files. + # the listed output files. An output directory is allowed to be a parent of + # another output directory. # Directories leading up to the output directories (but not the output # directories themselves) are created by the worker prior to execution, even # if they are not explicitly part of the input root. @@ -565,6 +572,11 @@ def update!(**args) # * Every child in the directory must have a path of exactly one segment. # Multiple levels of directory hierarchy may not be collapsed. # * Each child in the directory must have a unique path segment (file name). + # Note that while the API itself is case-sensitive, the environment where + # the Action is executed may or may not be case-sensitive. That is, it is + # legal to call the API with a Directory that has both "Foo" and "foo" as + # children, but the Action may be rejected by the remote system upon + # execution. # * The files, directories and symlinks in the directory must each be sorted # in lexicographical order by path. The path strings must be sorted by code # point, equivalently, by UTF-8 bytes. @@ -730,7 +742,7 @@ class BuildBazelRemoteExecutionV2ExecuteOperationMetadata # @return [Google::Apis::RemotebuildexecutionV1::BuildBazelRemoteExecutionV2Digest] attr_accessor :action_digest - # + # The current stage of execution. # Corresponds to the JSON property `stage` # @return [String] attr_accessor :stage @@ -1069,10 +1081,21 @@ def update!(**args) # FileNode, but it is used as an # output in an `ActionResult`. It allows a full file path rather than # only a name. - # `OutputFile` is binary-compatible with `FileNode`. class BuildBazelRemoteExecutionV2OutputFile include Google::Apis::Core::Hashable + # The contents of the file if inlining was requested. The server SHOULD NOT + # inline + # file contents unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. + # Corresponds to the JSON property `contents` + # NOTE: Values are automatically base64 encoded/decoded in the client library. + # @return [String] + attr_accessor :contents + # A content digest. A digest for a given blob consists of the size of the blob # and its hash. The hash algorithm to use is defined by the server, but servers # SHOULD use SHA-256. @@ -1123,6 +1146,7 @@ def initialize(**args) # Update properties of this object def update!(**args) + @contents = args[:contents] if args.key?(:contents) @digest = args[:digest] if args.key?(:digest) @is_executable = args[:is_executable] if args.key?(:is_executable) @path = args[:path] if args.key?(:path) @@ -1235,6 +1259,12 @@ def update!(**args) # canonical proto serialization: # * name: `build.bazel.remote.execution.v2.requestmetadata-bin` # * contents: the base64 encoded binary `RequestMetadata` message. + # Note: the gRPC library serializes binary headers encoded in base 64 by + # default (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md# + # requests). + # Therefore, if the gRPC library is used to pass/retrieve this + # metadata, the user may ignore the base64 encoding and assume it is simply + # serialized as a binary message. class BuildBazelRemoteExecutionV2RequestMetadata include Google::Apis::Core::Hashable @@ -1357,6 +1387,11 @@ class BuildBazelRemoteExecutionV2Tree # * Every child in the directory must have a path of exactly one segment. # Multiple levels of directory hierarchy may not be collapsed. # * Each child in the directory must have a unique path segment (file name). + # Note that while the API itself is case-sensitive, the environment where + # the Action is executed may or may not be case-sensitive. That is, it is + # legal to call the API with a Directory that has both "Foo" and "foo" as + # children, but the Action may be rejected by the remote system upon + # execution. # * The files, directories and symlinks in the directory must each be sorted # in lexicographical order by path. The path strings must be sorted by code # point, equivalently, by UTF-8 bytes. @@ -1807,6 +1842,23 @@ def update!(**args) class GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest include Google::Apis::Core::Hashable + # Optional. A filter to constrain the pools returned. Filters have the form: + # [[AND|OR] ]... + # is the path for a field or map key in the Pool proto message. + # e.g. "configuration.disk_size_gb" or "configuration.labels.key". + # can be one of "<", "<=", ">=", ">", "=", "!=", ":". + # ":" is a HAS operation for strings and repeated primitive fields. + # is the value to test, case-insensitive for strings. "*" stands for + # any value and can be used to test for key presence. + # Parenthesis determine AND/OR precedence. In space separated restrictions, + # AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x = y". + # Example filter: + # configuration.labels.key1 = * AND (state = RUNNING OR state = UPDATING) + # This field is currently ignored in all requests. + # Corresponds to the JSON property `filter` + # @return [String] + attr_accessor :filter + # Resource name of the instance. # Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. # Corresponds to the JSON property `parent` @@ -1819,6 +1871,7 @@ def initialize(**args) # Update properties of this object def update!(**args) + @filter = args[:filter] if args.key?(:filter) @parent = args[:parent] if args.key?(:parent) end end @@ -1893,6 +1946,16 @@ class GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig # @return [String] attr_accessor :disk_type + # Labels associated with the workers. + # Label keys and values can be no longer than 63 characters, can only contain + # lowercase letters, numeric characters, underscores and dashes. + # International letters are permitted. Keys must start with a letter but + # values are optional. + # This field is currently ignored in all requests. + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + # Required. Machine type of the worker, such as `n1-standard-2`. # See https://cloud.google.com/compute/docs/machine-types for a list of # supported machine types. Note that `f1-micro` and `g1-small` are not yet @@ -1924,6 +1987,7 @@ def initialize(**args) def update!(**args) @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb) @disk_type = args[:disk_type] if args.key?(:disk_type) + @labels = args[:labels] if args.key?(:labels) @machine_type = args[:machine_type] if args.key?(:machine_type) @min_cpu_platform = args[:min_cpu_platform] if args.key?(:min_cpu_platform) @reserved = args[:reserved] if args.key?(:reserved) diff --git a/generated/google/apis/remotebuildexecution_v1/representations.rb b/generated/google/apis/remotebuildexecution_v1/representations.rb index 7befcbd8b95..0fa2f484dc5 100644 --- a/generated/google/apis/remotebuildexecution_v1/representations.rb +++ b/generated/google/apis/remotebuildexecution_v1/representations.rb @@ -630,6 +630,7 @@ class Representation < Google::Apis::Core::JsonRepresentation class BuildBazelRemoteExecutionV2OutputFile # @private class Representation < Google::Apis::Core::JsonRepresentation + property :contents, :base64 => true, as: 'contents' property :digest, as: 'digest', class: Google::Apis::RemotebuildexecutionV1::BuildBazelRemoteExecutionV2Digest, decorator: Google::Apis::RemotebuildexecutionV1::BuildBazelRemoteExecutionV2Digest::Representation property :is_executable, as: 'isExecutable' @@ -812,6 +813,7 @@ class Representation < Google::Apis::Core::JsonRepresentation class GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest # @private class Representation < Google::Apis::Core::JsonRepresentation + property :filter, as: 'filter' property :parent, as: 'parent' end end @@ -838,6 +840,7 @@ class GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig class Representation < Google::Apis::Core::JsonRepresentation property :disk_size_gb, :numeric_string => true, as: 'diskSizeGb' property :disk_type, as: 'diskType' + hash :labels, as: 'labels' property :machine_type, as: 'machineType' property :min_cpu_platform, as: 'minCpuPlatform' property :reserved, as: 'reserved' diff --git a/generated/google/apis/remotebuildexecution_v1alpha.rb b/generated/google/apis/remotebuildexecution_v1alpha.rb index df9da999726..52c846067bf 100644 --- a/generated/google/apis/remotebuildexecution_v1alpha.rb +++ b/generated/google/apis/remotebuildexecution_v1alpha.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/remote-build-execution/docs/ module RemotebuildexecutionV1alpha VERSION = 'V1alpha' - REVISION = '20190604' + REVISION = '20190612' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/remotebuildexecution_v1alpha/classes.rb b/generated/google/apis/remotebuildexecution_v1alpha/classes.rb index ac6d358280c..a7ce3c0898e 100644 --- a/generated/google/apis/remotebuildexecution_v1alpha/classes.rb +++ b/generated/google/apis/remotebuildexecution_v1alpha/classes.rb @@ -75,7 +75,8 @@ class BuildBazelRemoteExecutionV2Action # @return [Google::Apis::RemotebuildexecutionV1alpha::BuildBazelRemoteExecutionV2Digest] attr_accessor :command_digest - # If true, then the `Action`'s result cannot be cached. + # If true, then the `Action`'s result cannot be cached, and in-flight + # requests for the same `Action` may not be merged. # Corresponds to the JSON property `doNotCache` # @return [Boolean] attr_accessor :do_not_cache @@ -216,6 +217,8 @@ class BuildBazelRemoteExecutionV2ActionResult # ` # ` # ``` + # If an output of the same name was found, but was not a directory, the + # server will return a FAILED_PRECONDITION. # Corresponds to the JSON property `outputDirectories` # @return [Array] attr_accessor :output_directories @@ -226,11 +229,12 @@ class BuildBazelRemoteExecutionV2ActionResult # if the server supports # SymlinkAbsolutePathStrategy.ALLOWED. # For each output directory requested in the `output_directories` field of - # the Action, if the directory file existed after - # the action completed, a single entry will be present either in this field, - # or in the `output_directories` field, if the directory was not a symbolic link. - # If the action does not produce the requested output, or produces a - # file where a directory is expected or vice versa, then that output + # the Action, if the directory existed after the action completed, a + # single entry will be present either in this field, or in the + # `output_directories` field, if the directory was not a symbolic link. + # If an output of the same name was found, but was a symbolic link to a file + # instead of a directory, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputDirectorySymlinks` @@ -245,8 +249,9 @@ class BuildBazelRemoteExecutionV2ActionResult # if the corresponding file existed after # the action completed, a single entry will be present either in this field, # or in the `output_files` field, if the file was not a symbolic link. - # If the action does not produce the requested output, or produces a - # directory where a regular file is expected or vice versa, then that output + # If an output symbolic link of the same name was found, but its target + # type was not a regular file, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputFileSymlinks` @@ -256,10 +261,11 @@ class BuildBazelRemoteExecutionV2ActionResult # The output files of the action. For each output file requested in the # `output_files` field of the Action, if the corresponding file existed after # the action completed, a single entry will be present either in this field, - # or in the output_file_symlinks field, if the file was a symbolic link to + # or the `output_file_symlinks` field if the file was a symbolic link to # another file. - # If the action does not produce the requested output, or produces a - # directory where a regular file is expected or vice versa, then that output + # If an output of the same name was found, but was a directory rather + # than a regular file, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputFiles` @@ -297,12 +303,12 @@ class BuildBazelRemoteExecutionV2ActionResult # @return [Google::Apis::RemotebuildexecutionV1alpha::BuildBazelRemoteExecutionV2Digest] attr_accessor :stderr_digest - # The standard error buffer of the action. The server will determine, based - # on the size of the buffer, whether to return it in raw form or to return - # a digest in `stderr_digest` that points to the buffer. If neither is set, - # then the buffer is empty. The client SHOULD NOT assume it will get one of - # the raw buffer or a digest on any given request and should be prepared to - # handle either. + # The standard error buffer of the action. The server SHOULD NOT inline + # stderr unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. # Corresponds to the JSON property `stderrRaw` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -339,12 +345,12 @@ class BuildBazelRemoteExecutionV2ActionResult # @return [Google::Apis::RemotebuildexecutionV1alpha::BuildBazelRemoteExecutionV2Digest] attr_accessor :stdout_digest - # The standard output buffer of the action. The server will determine, based - # on the size of the buffer, whether to return it in raw form or to return - # a digest in `stdout_digest` that points to the buffer. If neither is set, - # then the buffer is empty. The client SHOULD NOT assume it will get one of - # the raw buffer or a digest on any given request and should be prepared to - # handle either. + # The standard output buffer of the action. The server SHOULD NOT inline + # stdout unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. # Corresponds to the JSON property `stdoutRaw` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -414,7 +420,8 @@ class BuildBazelRemoteExecutionV2Command # MUST be sorted lexicographically by code point (or, equivalently, by UTF-8 # bytes). # An output directory cannot be duplicated or have the same path as any of - # the listed output files. + # the listed output files. An output directory is allowed to be a parent of + # another output directory. # Directories leading up to the output directories (but not the output # directories themselves) are created by the worker prior to execution, even # if they are not explicitly part of the input root. @@ -565,6 +572,11 @@ def update!(**args) # * Every child in the directory must have a path of exactly one segment. # Multiple levels of directory hierarchy may not be collapsed. # * Each child in the directory must have a unique path segment (file name). + # Note that while the API itself is case-sensitive, the environment where + # the Action is executed may or may not be case-sensitive. That is, it is + # legal to call the API with a Directory that has both "Foo" and "foo" as + # children, but the Action may be rejected by the remote system upon + # execution. # * The files, directories and symlinks in the directory must each be sorted # in lexicographical order by path. The path strings must be sorted by code # point, equivalently, by UTF-8 bytes. @@ -730,7 +742,7 @@ class BuildBazelRemoteExecutionV2ExecuteOperationMetadata # @return [Google::Apis::RemotebuildexecutionV1alpha::BuildBazelRemoteExecutionV2Digest] attr_accessor :action_digest - # + # The current stage of execution. # Corresponds to the JSON property `stage` # @return [String] attr_accessor :stage @@ -1069,10 +1081,21 @@ def update!(**args) # FileNode, but it is used as an # output in an `ActionResult`. It allows a full file path rather than # only a name. - # `OutputFile` is binary-compatible with `FileNode`. class BuildBazelRemoteExecutionV2OutputFile include Google::Apis::Core::Hashable + # The contents of the file if inlining was requested. The server SHOULD NOT + # inline + # file contents unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. + # Corresponds to the JSON property `contents` + # NOTE: Values are automatically base64 encoded/decoded in the client library. + # @return [String] + attr_accessor :contents + # A content digest. A digest for a given blob consists of the size of the blob # and its hash. The hash algorithm to use is defined by the server, but servers # SHOULD use SHA-256. @@ -1123,6 +1146,7 @@ def initialize(**args) # Update properties of this object def update!(**args) + @contents = args[:contents] if args.key?(:contents) @digest = args[:digest] if args.key?(:digest) @is_executable = args[:is_executable] if args.key?(:is_executable) @path = args[:path] if args.key?(:path) @@ -1235,6 +1259,12 @@ def update!(**args) # canonical proto serialization: # * name: `build.bazel.remote.execution.v2.requestmetadata-bin` # * contents: the base64 encoded binary `RequestMetadata` message. + # Note: the gRPC library serializes binary headers encoded in base 64 by + # default (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md# + # requests). + # Therefore, if the gRPC library is used to pass/retrieve this + # metadata, the user may ignore the base64 encoding and assume it is simply + # serialized as a binary message. class BuildBazelRemoteExecutionV2RequestMetadata include Google::Apis::Core::Hashable @@ -1357,6 +1387,11 @@ class BuildBazelRemoteExecutionV2Tree # * Every child in the directory must have a path of exactly one segment. # Multiple levels of directory hierarchy may not be collapsed. # * Each child in the directory must have a unique path segment (file name). + # Note that while the API itself is case-sensitive, the environment where + # the Action is executed may or may not be case-sensitive. That is, it is + # legal to call the API with a Directory that has both "Foo" and "foo" as + # children, but the Action may be rejected by the remote system upon + # execution. # * The files, directories and symlinks in the directory must each be sorted # in lexicographical order by path. The path strings must be sorted by code # point, equivalently, by UTF-8 bytes. @@ -1788,6 +1823,23 @@ def update!(**args) class GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest include Google::Apis::Core::Hashable + # Optional. A filter to constrain the pools returned. Filters have the form: + # [[AND|OR] ]... + # is the path for a field or map key in the Pool proto message. + # e.g. "configuration.disk_size_gb" or "configuration.labels.key". + # can be one of "<", "<=", ">=", ">", "=", "!=", ":". + # ":" is a HAS operation for strings and repeated primitive fields. + # is the value to test, case-insensitive for strings. "*" stands for + # any value and can be used to test for key presence. + # Parenthesis determine AND/OR precedence. In space separated restrictions, + # AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x = y". + # Example filter: + # configuration.labels.key1 = * AND (state = RUNNING OR state = UPDATING) + # This field is currently ignored in all requests. + # Corresponds to the JSON property `filter` + # @return [String] + attr_accessor :filter + # Resource name of the instance. # Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. # Corresponds to the JSON property `parent` @@ -1800,6 +1852,7 @@ def initialize(**args) # Update properties of this object def update!(**args) + @filter = args[:filter] if args.key?(:filter) @parent = args[:parent] if args.key?(:parent) end end @@ -1874,6 +1927,16 @@ class GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig # @return [String] attr_accessor :disk_type + # Labels associated with the workers. + # Label keys and values can be no longer than 63 characters, can only contain + # lowercase letters, numeric characters, underscores and dashes. + # International letters are permitted. Keys must start with a letter but + # values are optional. + # This field is currently ignored in all requests. + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + # Required. Machine type of the worker, such as `n1-standard-2`. # See https://cloud.google.com/compute/docs/machine-types for a list of # supported machine types. Note that `f1-micro` and `g1-small` are not yet @@ -1905,6 +1968,7 @@ def initialize(**args) def update!(**args) @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb) @disk_type = args[:disk_type] if args.key?(:disk_type) + @labels = args[:labels] if args.key?(:labels) @machine_type = args[:machine_type] if args.key?(:machine_type) @min_cpu_platform = args[:min_cpu_platform] if args.key?(:min_cpu_platform) @reserved = args[:reserved] if args.key?(:reserved) diff --git a/generated/google/apis/remotebuildexecution_v1alpha/representations.rb b/generated/google/apis/remotebuildexecution_v1alpha/representations.rb index 19cc4fd2a34..0ddede6c8a1 100644 --- a/generated/google/apis/remotebuildexecution_v1alpha/representations.rb +++ b/generated/google/apis/remotebuildexecution_v1alpha/representations.rb @@ -594,6 +594,7 @@ class Representation < Google::Apis::Core::JsonRepresentation class BuildBazelRemoteExecutionV2OutputFile # @private class Representation < Google::Apis::Core::JsonRepresentation + property :contents, :base64 => true, as: 'contents' property :digest, as: 'digest', class: Google::Apis::RemotebuildexecutionV1alpha::BuildBazelRemoteExecutionV2Digest, decorator: Google::Apis::RemotebuildexecutionV1alpha::BuildBazelRemoteExecutionV2Digest::Representation property :is_executable, as: 'isExecutable' @@ -769,6 +770,7 @@ class Representation < Google::Apis::Core::JsonRepresentation class GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest # @private class Representation < Google::Apis::Core::JsonRepresentation + property :filter, as: 'filter' property :parent, as: 'parent' end end @@ -795,6 +797,7 @@ class GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig class Representation < Google::Apis::Core::JsonRepresentation property :disk_size_gb, :numeric_string => true, as: 'diskSizeGb' property :disk_type, as: 'diskType' + hash :labels, as: 'labels' property :machine_type, as: 'machineType' property :min_cpu_platform, as: 'minCpuPlatform' property :reserved, as: 'reserved' diff --git a/generated/google/apis/remotebuildexecution_v1alpha/service.rb b/generated/google/apis/remotebuildexecution_v1alpha/service.rb index 1e4f60a1a12..01c47e90e5e 100644 --- a/generated/google/apis/remotebuildexecution_v1alpha/service.rb +++ b/generated/google/apis/remotebuildexecution_v1alpha/service.rb @@ -290,6 +290,20 @@ def get_project_instance_workerpool(name, fields: nil, quota_user: nil, options: # @param [String] parent # Resource name of the instance. # Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. + # @param [String] filter + # Optional. A filter to constrain the pools returned. Filters have the form: + # [[AND|OR] ]... + # is the path for a field or map key in the Pool proto message. + # e.g. "configuration.disk_size_gb" or "configuration.labels.key". + # can be one of "<", "<=", ">=", ">", "=", "!=", ":". + # ":" is a HAS operation for strings and repeated primitive fields. + # is the value to test, case-insensitive for strings. "*" stands for + # any value and can be used to test for key presence. + # Parenthesis determine AND/OR precedence. In space separated restrictions, + # AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x = y". + # Example filter: + # configuration.labels.key1 = * AND (state = RUNNING OR state = UPDATING) + # This field is currently ignored in all requests. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -307,11 +321,12 @@ def get_project_instance_workerpool(name, fields: nil, quota_user: nil, options: # @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_project_instance_workerpools(parent, fields: nil, quota_user: nil, options: nil, &block) + def list_project_instance_workerpools(parent, filter: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1alpha/{+parent}/workerpools', options) command.response_representation = Google::Apis::RemotebuildexecutionV1alpha::GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsResponse::Representation command.response_class = Google::Apis::RemotebuildexecutionV1alpha::GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsResponse command.params['parent'] = parent unless parent.nil? + command.query['filter'] = filter unless filter.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) diff --git a/generated/google/apis/remotebuildexecution_v2.rb b/generated/google/apis/remotebuildexecution_v2.rb index 0806d970249..fdb3de2c187 100644 --- a/generated/google/apis/remotebuildexecution_v2.rb +++ b/generated/google/apis/remotebuildexecution_v2.rb @@ -25,7 +25,7 @@ module Apis # @see https://cloud.google.com/remote-build-execution/docs/ module RemotebuildexecutionV2 VERSION = 'V2' - REVISION = '20190604' + REVISION = '20190612' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/remotebuildexecution_v2/classes.rb b/generated/google/apis/remotebuildexecution_v2/classes.rb index 0805c19fd82..cce71659906 100644 --- a/generated/google/apis/remotebuildexecution_v2/classes.rb +++ b/generated/google/apis/remotebuildexecution_v2/classes.rb @@ -75,7 +75,8 @@ class BuildBazelRemoteExecutionV2Action # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest] attr_accessor :command_digest - # If true, then the `Action`'s result cannot be cached. + # If true, then the `Action`'s result cannot be cached, and in-flight + # requests for the same `Action` may not be merged. # Corresponds to the JSON property `doNotCache` # @return [Boolean] attr_accessor :do_not_cache @@ -236,6 +237,8 @@ class BuildBazelRemoteExecutionV2ActionResult # ` # ` # ``` + # If an output of the same name was found, but was not a directory, the + # server will return a FAILED_PRECONDITION. # Corresponds to the JSON property `outputDirectories` # @return [Array] attr_accessor :output_directories @@ -246,11 +249,12 @@ class BuildBazelRemoteExecutionV2ActionResult # if the server supports # SymlinkAbsolutePathStrategy.ALLOWED. # For each output directory requested in the `output_directories` field of - # the Action, if the directory file existed after - # the action completed, a single entry will be present either in this field, - # or in the `output_directories` field, if the directory was not a symbolic link. - # If the action does not produce the requested output, or produces a - # file where a directory is expected or vice versa, then that output + # the Action, if the directory existed after the action completed, a + # single entry will be present either in this field, or in the + # `output_directories` field, if the directory was not a symbolic link. + # If an output of the same name was found, but was a symbolic link to a file + # instead of a directory, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputDirectorySymlinks` @@ -265,8 +269,9 @@ class BuildBazelRemoteExecutionV2ActionResult # if the corresponding file existed after # the action completed, a single entry will be present either in this field, # or in the `output_files` field, if the file was not a symbolic link. - # If the action does not produce the requested output, or produces a - # directory where a regular file is expected or vice versa, then that output + # If an output symbolic link of the same name was found, but its target + # type was not a regular file, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputFileSymlinks` @@ -276,10 +281,11 @@ class BuildBazelRemoteExecutionV2ActionResult # The output files of the action. For each output file requested in the # `output_files` field of the Action, if the corresponding file existed after # the action completed, a single entry will be present either in this field, - # or in the output_file_symlinks field, if the file was a symbolic link to + # or the `output_file_symlinks` field if the file was a symbolic link to # another file. - # If the action does not produce the requested output, or produces a - # directory where a regular file is expected or vice versa, then that output + # If an output of the same name was found, but was a directory rather + # than a regular file, the server will return a FAILED_PRECONDITION. + # If the action does not produce the requested output, then that output # will be omitted from the list. The server is free to arrange the output # list as desired; clients MUST NOT assume that the output list is sorted. # Corresponds to the JSON property `outputFiles` @@ -317,12 +323,12 @@ class BuildBazelRemoteExecutionV2ActionResult # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest] attr_accessor :stderr_digest - # The standard error buffer of the action. The server will determine, based - # on the size of the buffer, whether to return it in raw form or to return - # a digest in `stderr_digest` that points to the buffer. If neither is set, - # then the buffer is empty. The client SHOULD NOT assume it will get one of - # the raw buffer or a digest on any given request and should be prepared to - # handle either. + # The standard error buffer of the action. The server SHOULD NOT inline + # stderr unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. # Corresponds to the JSON property `stderrRaw` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -359,12 +365,12 @@ class BuildBazelRemoteExecutionV2ActionResult # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest] attr_accessor :stdout_digest - # The standard output buffer of the action. The server will determine, based - # on the size of the buffer, whether to return it in raw form or to return - # a digest in `stdout_digest` that points to the buffer. If neither is set, - # then the buffer is empty. The client SHOULD NOT assume it will get one of - # the raw buffer or a digest on any given request and should be prepared to - # handle either. + # The standard output buffer of the action. The server SHOULD NOT inline + # stdout unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. # Corresponds to the JSON property `stdoutRaw` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -429,7 +435,7 @@ def update!(**args) end end - # A response corresponding to a single blob that the client tried to upload. + # A response corresponding to a single blob that the client tried to download. class BuildBazelRemoteExecutionV2BatchReadBlobsResponseResponse include Google::Apis::Core::Hashable @@ -734,7 +740,8 @@ class BuildBazelRemoteExecutionV2Command # MUST be sorted lexicographically by code point (or, equivalently, by UTF-8 # bytes). # An output directory cannot be duplicated or have the same path as any of - # the listed output files. + # the listed output files. An output directory is allowed to be a parent of + # another output directory. # Directories leading up to the output directories (but not the output # directories themselves) are created by the worker prior to execution, even # if they are not explicitly part of the input root. @@ -885,6 +892,11 @@ def update!(**args) # * Every child in the directory must have a path of exactly one segment. # Multiple levels of directory hierarchy may not be collapsed. # * Each child in the directory must have a unique path segment (file name). + # Note that while the API itself is case-sensitive, the environment where + # the Action is executed may or may not be case-sensitive. That is, it is + # legal to call the API with a Directory that has both "Foo" and "foo" as + # children, but the Action may be rejected by the remote system upon + # execution. # * The files, directories and symlinks in the directory must each be sorted # in lexicographical order by path. The path strings must be sorted by code # point, equivalently, by UTF-8 bytes. @@ -1050,7 +1062,7 @@ class BuildBazelRemoteExecutionV2ExecuteOperationMetadata # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest] attr_accessor :action_digest - # + # The current stage of execution. # Corresponds to the JSON property `stage` # @return [String] attr_accessor :stage @@ -1129,9 +1141,19 @@ class BuildBazelRemoteExecutionV2ExecuteRequest # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ResultsCachePolicy] attr_accessor :results_cache_policy - # If true, the action will be executed anew even if its result was already - # present in the cache. If false, the result may be served from the - # ActionCache. + # If true, the action will be executed even if its result is already + # present in the ActionCache. + # The execution is still allowed to be merged with other in-flight executions + # of the same action, however - semantically, the service MUST only guarantee + # that the results of an execution with this field set were not visible + # before the corresponding execution request was sent. + # Note that actions from execution requests setting this field set are still + # eligible to be entered into the action cache upon completion, and services + # SHOULD overwrite any existing entries that may exist. This allows + # skip_cache_lookup requests to be used as a mechanism for replacing action + # cache entries that reference outputs no longer available or that are + # poisoned in any way. + # If false, the result may be served from the action cache. # Corresponds to the JSON property `skipCacheLookup` # @return [Boolean] attr_accessor :skip_cache_lookup @@ -1587,10 +1609,21 @@ def update!(**args) # FileNode, but it is used as an # output in an `ActionResult`. It allows a full file path rather than # only a name. - # `OutputFile` is binary-compatible with `FileNode`. class BuildBazelRemoteExecutionV2OutputFile include Google::Apis::Core::Hashable + # The contents of the file if inlining was requested. The server SHOULD NOT + # inline + # file contents unless requested by the client in the + # GetActionResultRequest + # message. The server MAY omit inlining, even if requested, and MUST do so if + # inlining + # would cause the response to exceed message size limits. + # Corresponds to the JSON property `contents` + # NOTE: Values are automatically base64 encoded/decoded in the client library. + # @return [String] + attr_accessor :contents + # A content digest. A digest for a given blob consists of the size of the blob # and its hash. The hash algorithm to use is defined by the server, but servers # SHOULD use SHA-256. @@ -1641,6 +1674,7 @@ def initialize(**args) # Update properties of this object def update!(**args) + @contents = args[:contents] if args.key?(:contents) @digest = args[:digest] if args.key?(:digest) @is_executable = args[:is_executable] if args.key?(:is_executable) @path = args[:path] if args.key?(:path) @@ -1799,6 +1833,12 @@ def update!(**args) # canonical proto serialization: # * name: `build.bazel.remote.execution.v2.requestmetadata-bin` # * contents: the base64 encoded binary `RequestMetadata` message. + # Note: the gRPC library serializes binary headers encoded in base 64 by + # default (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md# + # requests). + # Therefore, if the gRPC library is used to pass/retrieve this + # metadata, the user may ignore the base64 encoding and assume it is simply + # serialized as a binary message. class BuildBazelRemoteExecutionV2RequestMetadata include Google::Apis::Core::Hashable @@ -1991,6 +2031,11 @@ class BuildBazelRemoteExecutionV2Tree # * Every child in the directory must have a path of exactly one segment. # Multiple levels of directory hierarchy may not be collapsed. # * Each child in the directory must have a unique path segment (file name). + # Note that while the API itself is case-sensitive, the environment where + # the Action is executed may or may not be case-sensitive. That is, it is + # legal to call the API with a Directory that has both "Foo" and "foo" as + # children, but the Action may be rejected by the remote system upon + # execution. # * The files, directories and symlinks in the directory must each be sorted # in lexicographical order by path. The path strings must be sorted by code # point, equivalently, by UTF-8 bytes. @@ -2475,6 +2520,23 @@ def update!(**args) class GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest include Google::Apis::Core::Hashable + # Optional. A filter to constrain the pools returned. Filters have the form: + # [[AND|OR] ]... + # is the path for a field or map key in the Pool proto message. + # e.g. "configuration.disk_size_gb" or "configuration.labels.key". + # can be one of "<", "<=", ">=", ">", "=", "!=", ":". + # ":" is a HAS operation for strings and repeated primitive fields. + # is the value to test, case-insensitive for strings. "*" stands for + # any value and can be used to test for key presence. + # Parenthesis determine AND/OR precedence. In space separated restrictions, + # AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x = y". + # Example filter: + # configuration.labels.key1 = * AND (state = RUNNING OR state = UPDATING) + # This field is currently ignored in all requests. + # Corresponds to the JSON property `filter` + # @return [String] + attr_accessor :filter + # Resource name of the instance. # Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. # Corresponds to the JSON property `parent` @@ -2487,6 +2549,7 @@ def initialize(**args) # Update properties of this object def update!(**args) + @filter = args[:filter] if args.key?(:filter) @parent = args[:parent] if args.key?(:parent) end end @@ -2561,6 +2624,16 @@ class GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig # @return [String] attr_accessor :disk_type + # Labels associated with the workers. + # Label keys and values can be no longer than 63 characters, can only contain + # lowercase letters, numeric characters, underscores and dashes. + # International letters are permitted. Keys must start with a letter but + # values are optional. + # This field is currently ignored in all requests. + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + # Required. Machine type of the worker, such as `n1-standard-2`. # See https://cloud.google.com/compute/docs/machine-types for a list of # supported machine types. Note that `f1-micro` and `g1-small` are not yet @@ -2592,6 +2665,7 @@ def initialize(**args) def update!(**args) @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb) @disk_type = args[:disk_type] if args.key?(:disk_type) + @labels = args[:labels] if args.key?(:labels) @machine_type = args[:machine_type] if args.key?(:machine_type) @min_cpu_platform = args[:min_cpu_platform] if args.key?(:min_cpu_platform) @reserved = args[:reserved] if args.key?(:reserved) diff --git a/generated/google/apis/remotebuildexecution_v2/representations.rb b/generated/google/apis/remotebuildexecution_v2/representations.rb index 16e7629611a..86da8fb66f0 100644 --- a/generated/google/apis/remotebuildexecution_v2/representations.rb +++ b/generated/google/apis/remotebuildexecution_v2/representations.rb @@ -857,6 +857,7 @@ class Representation < Google::Apis::Core::JsonRepresentation class BuildBazelRemoteExecutionV2OutputFile # @private class Representation < Google::Apis::Core::JsonRepresentation + property :contents, :base64 => true, as: 'contents' property :digest, as: 'digest', class: Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest, decorator: Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2Digest::Representation property :is_executable, as: 'isExecutable' @@ -1087,6 +1088,7 @@ class Representation < Google::Apis::Core::JsonRepresentation class GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest # @private class Representation < Google::Apis::Core::JsonRepresentation + property :filter, as: 'filter' property :parent, as: 'parent' end end @@ -1113,6 +1115,7 @@ class GoogleDevtoolsRemotebuildexecutionAdminV1alphaWorkerConfig class Representation < Google::Apis::Core::JsonRepresentation property :disk_size_gb, :numeric_string => true, as: 'diskSizeGb' property :disk_type, as: 'diskType' + hash :labels, as: 'labels' property :machine_type, as: 'machineType' property :min_cpu_platform, as: 'minCpuPlatform' property :reserved, as: 'reserved' diff --git a/generated/google/apis/remotebuildexecution_v2/service.rb b/generated/google/apis/remotebuildexecution_v2/service.rb index ab8c5822188..ba261d9ece0 100644 --- a/generated/google/apis/remotebuildexecution_v2/service.rb +++ b/generated/google/apis/remotebuildexecution_v2/service.rb @@ -48,6 +48,13 @@ def initialize end # Retrieve a cached execution result. + # Implementations SHOULD ensure that any blobs referenced from the + # ContentAddressableStorage + # are available at the time of returning the + # ActionResult and will be + # for some period of time afterwards. The TTLs of the referenced blobs SHOULD be + # increased + # if necessary and applicable. # Errors: # * `NOT_FOUND`: The requested `ActionResult` is not in the cache. # @param [String] instance_name @@ -61,6 +68,16 @@ def initialize # exactly 64 characters long. # @param [Fixnum] size_bytes # The size of the blob, in bytes. + # @param [Array, String] inline_output_files + # A hint to the server to inline the contents of the listed output files. + # Each path needs to exactly match one path in `output_files` in the + # Command message. + # @param [Boolean] inline_stderr + # A hint to the server to request inlining stderr in the + # ActionResult message. + # @param [Boolean] inline_stdout + # A hint to the server to request inlining stdout in the + # ActionResult message. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -78,13 +95,16 @@ def initialize # @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 get_action_result(instance_name, hash_, size_bytes, fields: nil, quota_user: nil, options: nil, &block) + def get_action_result(instance_name, hash_, size_bytes, inline_output_files: nil, inline_stderr: nil, inline_stdout: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v2/{+instanceName}/actionResults/{hash}/{sizeBytes}', options) command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult::Representation command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult command.params['instanceName'] = instance_name unless instance_name.nil? command.params['hash'] = hash_ unless hash_.nil? command.params['sizeBytes'] = size_bytes unless size_bytes.nil? + command.query['inlineOutputFiles'] = inline_output_files unless inline_output_files.nil? + command.query['inlineStderr'] = inline_stderr unless inline_stderr.nil? + command.query['inlineStdout'] = inline_stdout unless inline_stdout.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) @@ -497,7 +517,14 @@ def wait_operation_execution(name, build_bazel_remote_execution_v2_wait_executio execute_or_queue_command(command, &block) end - # GetCapabilities returns the server capabilities configuration. + # GetCapabilities returns the server capabilities configuration of the + # remote endpoint. + # Only the capabilities of the services supported by the endpoint will + # be returned: + # * Execution + CAS + Action Cache endpoints should return both + # CacheCapabilities and ExecutionCapabilities. + # * Execution only endpoints should return ExecutionCapabilities. + # * CAS + Action Cache only endpoints should return CacheCapabilities. # @param [String] instance_name # The instance of the execution system to operate against. A server may # support multiple instances of the execution system (with their own workers, diff --git a/generated/google/apis/toolresults_v1beta3.rb b/generated/google/apis/toolresults_v1beta3.rb index 30ee0d4aca0..c52158fd137 100644 --- a/generated/google/apis/toolresults_v1beta3.rb +++ b/generated/google/apis/toolresults_v1beta3.rb @@ -25,7 +25,7 @@ module Apis # @see https://firebase.google.com/docs/test-lab/ module ToolresultsV1beta3 VERSION = 'V1beta3' - REVISION = '20190529' + REVISION = '20190612' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'