google-apis-logging_v2 0.31.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d53f8f817fbc567ac024243249234366101bb89220b77ebe27727683480cb4ca
-  data.tar.gz: eb7ca0cff4ab8367f223147810b7128024aea6458fd899c773f3117bd2af5200
+  metadata.gz: 99ba6fd954235989ea74de5b22d16434c6d9538cebb982c26074152139195766
+  data.tar.gz: ea10f19638e262078e398e8a6bad4b08d2646b3fa435bbd8500be37ba952a007
 SHA512:
-  metadata.gz: 341905c7359385c15ccc195ce842b2b783730d0483d8de9f594026fbe8e9e7653ec15e9c8f97d41ac69c5f49eb372d5a535986c5ffcd415186ff9110ab9cb304
-  data.tar.gz: 356bf57b558ee66dde57dd67b380d4d6a818cdd5f74c7a96148cb576fbe3c9ded77bf516282ad18e1ea775b01a23c34b5b6b288683a58155ddbcf3bf5c58276f
+  metadata.gz: 7da61cfc89bcca1a23ae0f6f0300ea21a098969196a043b8faba7b7f597591e26c397c1ab8cde48a3521c0ddba2966f38bfdbe279f32d8744eb5b2671d4151ec
+  data.tar.gz: 7c252f0cc68f2e4795c79017cb4f5cbafd164522b6e380bd1187d4c4527ca765f22ed8d4817ba1dd369a8743763ba39c61ef47c3e8c74a6b40eebb7945a1017b

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Release history for google-apis-logging_v2
 
+### v0.34.0 (2022-08-13)
+
+* Regenerated from discovery document revision 20220805
+
+### v0.33.0 (2022-07-23)
+
+* Regenerated from discovery document revision 20220714
+* Regenerated using generator version 0.9.0
+
+### v0.32.0 (2022-07-03)
+
+* Regenerated from discovery document revision 20220624
+* Regenerated using generator version 0.8.0
+
 ### v0.31.0 (2022-06-18)
 
 * Regenerated using generator version 0.7.0

data/lib/google/apis/logging_v2/classes.rb

@@ -1207,9 +1207,24 @@ module Google
         # @return [Google::Apis::LoggingV2::LogEntrySourceLocation]
         attr_accessor :source_location
       
-        # Optional. The span ID within the trace associated with the log entry.For Trace
-        # spans, this is the same format that the Trace API v2 uses: a 16-character
-        # hexadecimal encoding of an 8-byte array, such as 000000000000004a.
+        # Optional. The ID of the Cloud Trace (https://cloud.google.com/trace) span
+        # associated with the current operation in which the log is being written. For
+        # example, if a span has the REST resource name of "projects/some-project/traces/
+        # some-trace/spans/some-span-id", then the span_id field is "some-span-id".A
+        # Span (https://cloud.google.com/trace/docs/reference/v2/rest/v2/projects.traces/
+        # batchWrite#Span) represents a single operation within a trace. Whereas a trace
+        # may involve multiple different microservices running on multiple different
+        # machines, a span generally corresponds to a single logical operation being
+        # performed in a single instance of a microservice on one specific machine.
+        # Spans are the nodes within the tree that is a trace.Applications that are
+        # instrumented for tracing (https://cloud.google.com/trace/docs/setup) will
+        # generally assign a new, unique span ID on each incoming request. It is also
+        # common to create and record additional spans corresponding to internal
+        # processing elements as well as issuing requests to dependencies.The span ID is
+        # expected to be a 16-character, hexadecimal encoding of an 8-byte array and
+        # should not be zero. It should be unique within the trace and should, ideally,
+        # be generated in a manner that is uniformly random.Example values:
+        # 000000000000004a 7a2190356c3fc94b 0000f00300090021 d39223e101960076
         # Corresponds to the JSON property `spanId`
         # @return [String]
         attr_accessor :span_id
@@ -1239,10 +1254,13 @@ module Google
         # @return [String]
         attr_accessor :timestamp
       
-        # Optional. Resource name of the trace associated with the log entry, if any. If
-        # it contains a relative resource name, the name is assumed to be relative to //
-        # tracing.googleapis.com. Example: projects/my-projectid/traces/
-        # 06796866738c859f2f19b7cfb3214824
+        # Optional. The REST resource name of the trace being written to Cloud Trace (
+        # https://cloud.google.com/trace) in association with this log entry. For
+        # example, if your trace data is stored in the Cloud project "my-trace-project"
+        # and if the service that is creating the log entry receives a trace header that
+        # includes the trace ID "12345", then the service should use "projects/my-
+        # tracing-project/traces/12345".The trace field provides the link between logs
+        # and traces. By using this field, you can navigate from a log entry to a trace.
         # Corresponds to the JSON property `trace`
         # @return [String]
         attr_accessor :trace
@@ -1477,6 +1495,14 @@ module Google
       class LogMetric
         include Google::Apis::Core::Hashable
       
+        # Optional. The resource name of the Log Bucket that owns the Log Metric. Only
+        # Log Buckets in projects are supported. The bucket has to be in the same
+        # project as the metric.For example:projects/my-project/locations/global/buckets/
+        # my-bucketIf empty, then the Log Metric is considered a non-Bucket Log Metric.
+        # Corresponds to the JSON property `bucketName`
+        # @return [String]
+        attr_accessor :bucket_name
+      
         # BucketOptions describes the bucket boundaries used to create a histogram for
         # the distribution. The buckets can be in a linear sequence, an exponential
         # sequence, or each bucket can be specified explicitly. BucketOptions does not
@@ -1526,11 +1552,11 @@ module Google
         # Each label key specified in the LabelDescriptor must have an associated
         # extractor expression in this map. The syntax of the extractor expression is
         # the same as for the value_extractor field.The extracted value is converted to
-        # the type defined in the label descriptor. If the either the extraction or the
-        # type conversion fails, the label will have a default value. The default value
-        # for a string label is an empty string, for an integer label its 0, and for a
-        # boolean label its false.Note that there are upper bounds on the maximum number
-        # of labels and the number of active time series that are allowed in a project.
+        # the type defined in the label descriptor. If either the extraction or the type
+        # conversion fails, the label will have a default value. The default value for a
+        # string label is an empty string, for an integer label its 0, and for a boolean
+        # label its false.Note that there are upper bounds on the maximum number of
+        # labels and the number of active time series that are allowed in a project.
         # Corresponds to the JSON property `labelExtractors`
         # @return [Hash<String,String>]
         attr_accessor :label_extractors
@@ -1590,6 +1616,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @bucket_name = args[:bucket_name] if args.key?(:bucket_name)
           @bucket_options = args[:bucket_options] if args.key?(:bucket_options)
           @create_time = args[:create_time] if args.key?(:create_time)
           @description = args[:description] if args.key?(:description)
@@ -1700,16 +1727,16 @@ module Google
       
         # Output only. An IAM identity—a service account or group—under which Cloud
         # Logging writes the exported log entries to the sink's destination. This field
-        # is set by sinks.create and sinks.update based on the value of
-        # unique_writer_identity in those methods.Until you grant this identity write-
-        # access to the destination, log entry exports from this sink will fail. For
-        # more information, see Granting Access for a Resource (https://cloud.google.com/
-        # iam/docs/granting-roles-to-service-accounts#
-        # granting_access_to_a_service_account_for_a_resource). Consult the destination
-        # service's documentation to determine the appropriate IAM roles to assign to
-        # the identity.Sinks that have a destination that is a log bucket in the same
-        # project as the sink do not have a writer_identity and no additional
-        # permissions are required.
+        # is either set by specifying custom_writer_identity or set automatically by
+        # sinks.create and sinks.update based on the value of unique_writer_identity in
+        # those methods.Until you grant this identity write-access to the destination,
+        # log entry exports from this sink will fail. For more information, see Granting
+        # Access for a Resource (https://cloud.google.com/iam/docs/granting-roles-to-
+        # service-accounts#granting_access_to_a_service_account_for_a_resource). Consult
+        # the destination service's documentation to determine the appropriate IAM roles
+        # to assign to the identity.Sinks that have a destination that is a log bucket
+        # in the same project as the sink cannot have a writer_identity and no
+        # additional permissions are required.
         # Corresponds to the JSON property `writerIdentity`
         # @return [String]
         attr_accessor :writer_identity
@@ -2777,9 +2804,10 @@ module Google
         # Optional. Whether a batch's valid entries should be written even if some other
         # entry failed due to a permanent error such as INVALID_ARGUMENT or
         # PERMISSION_DENIED. If any entry failed, then the response status is the
-        # response status is the status of one of the failed entries. The response will
-        # include error details keyed by the entries' zero-based index in the entries.
-        # write method.
+        # response status of one of the failed entries. The response will include error
+        # details in WriteLogEntriesPartialErrors.log_entry_errors keyed by the entries'
+        # zero-based index in the entries. Failed requests for which no entries are
+        # written will not include per-entry errors.
         # Corresponds to the JSON property `partialSuccess`
         # @return [Boolean]
         attr_accessor :partial_success

data/lib/google/apis/logging_v2/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module LoggingV2
       # Version of the google-apis-logging_v2 gem
-      GEM_VERSION = "0.31.0"
+      GEM_VERSION = "0.34.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.7.0"
+      GENERATOR_VERSION = "0.9.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220527"
+      REVISION = "20220805"
     end
   end
 end

data/lib/google/apis/logging_v2/representations.rb

@@ -681,6 +681,7 @@ module Google
       class LogMetric
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :bucket_name, as: 'bucketName'
           property :bucket_options, as: 'bucketOptions', class: Google::Apis::LoggingV2::BucketOptions, decorator: Google::Apis::LoggingV2::BucketOptions::Representation
       
           property :create_time, as: 'createTime'

data/lib/google/apis/logging_v2/service.rb

@@ -132,73 +132,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a log bucket.
-        # @param [String] name
-        #   Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
-        #   LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
-        #   LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
-        #   locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
-        #   LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
-        #   global/buckets/my-bucket"
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2::LogBucket] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::LoggingV2::LogBucket]
-        #
-        # @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_billing_account_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+name}', options)
-          command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
-          command.response_class = Google::Apis::LoggingV2::LogBucket
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets a view on a log bucket..
-        # @param [String] name
-        #   Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
-        #   LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
-        #   project/locations/global/buckets/my-bucket/views/my-view"
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::LoggingV2::LogView]
-        #
-        # @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_billing_account_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+name}', options)
-          command.response_representation = Google::Apis::LoggingV2::LogView::Representation
-          command.response_class = Google::Apis::LoggingV2::LogView
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Creates a new exclusion in the _Default sink in a specified parent resource.
         # Only log entries belonging to that resource can be excluded. You can have up
         # to 10 exclusions in a resource.
@@ -544,6 +477,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets a log bucket.
+        # @param [String] name
+        #   Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
+        #   LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
+        #   locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
+        #   LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
+        #   global/buckets/my-bucket"
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::LogBucket] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::LogBucket]
+        #
+        # @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_billing_account_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}', options)
+          command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
+          command.response_class = Google::Apis::LoggingV2::LogBucket
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists log buckets.
         # @param [String] parent
         #   Required. The parent resource whose buckets are to be listed: "projects/[
@@ -753,6 +721,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets a view on a log bucket..
+        # @param [String] name
+        #   Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
+        #   LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
+        #   project/locations/global/buckets/my-bucket/views/my-view"
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::LogView] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::LogView]
+        #
+        # @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_billing_account_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}', options)
+          command.response_representation = Google::Apis::LoggingV2::LogView::Representation
+          command.response_class = Google::Apis::LoggingV2::LogView
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists views on a log bucket.
         # @param [String] parent
         #   Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
@@ -934,6 +934,37 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
+        # @param [String] name
+        #   The name of the operation resource.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_billing_account_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}', options)
+          command.response_representation = Google::Apis::LoggingV2::Operation::Representation
+          command.response_class = Google::Apis::LoggingV2::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists operations that match the specified filter in the request. If the server
         # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
         # allows API services to override the binding to use different resource name
@@ -1072,37 +1103,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation. Clients can use this method
-        # to poll the operation result at intervals as recommended by the API service.
-        # @param [String] name
-        #   The name of the operation resource.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::LoggingV2::Operation]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_billing_account_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v2/{+name}', options)
-          command.response_representation = Google::Apis::LoggingV2::Operation::Representation
-          command.response_class = Google::Apis::LoggingV2::Operation
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Creates a sink that exports specified log entries to a destination. The export
         # of newly-ingested log entries begins immediately, unless the sink's
         # writer_identity is not permitted to write to the destination. A sink can

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-logging_v2
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.34.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-20 00:00:00.000000000 Z
+date: 2022-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-logging_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-logging_v2/v0.31.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-logging_v2/v0.34.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-logging_v2
 post_install_message: 
 rdoc_options: []