google-apis-logging_v2 0.57.0 → 0.59.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f98e1265b872ebc938765e9d2611347c23156d6ee566bd75d7b82469b4520d4d
-  data.tar.gz: 7fa95faf33fa21f746f330158c21c5fb26b4e2e5fdda493f6d7471670f296290
+  metadata.gz: 1def1b43a67a73d815c132797d4af9836a493a0afc2856b7e2ded9c5426188ac
+  data.tar.gz: 4572eee26037e4c4c10f5a9b91dacce9324fd9acdc9fe57c19c05cf53ba418af
 SHA512:
-  metadata.gz: 317486dbeb674c815e31606bf1d79913e5e4b47a49c572169ac4e53a7e2d93f18b886cabf128680c421b5f6412c8d790549374277daad95c49ef150c571f02da
-  data.tar.gz: 85bea5b792ae64badb4a11e1717e30d5b620cd0109519eaab336fa65ed5e5b5d9c28bb8e784363de9f676d911fb0298b1722110ee6c86158273c92c7772401cd
+  metadata.gz: 4ec75371f8d9f755bf2ae46fa1a297e5589f7a469fd31e56567fd43d93ce07316e0d75d8462ae99f36e4fb5948aa97af0023e66bdeda974497015c430fc2a321
+  data.tar.gz: 99a71832fb672a5b89b429bc490d0750fab30680f9936d74b649b2608b31f4a751e30809f9c67c76c4fe7da66ac1952d2109a260508a1b7ef6654fea6f04f0f2

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-logging_v2
 
+### v0.59.0 (2023-12-10)
+
+* Regenerated from discovery document revision 20231130
+
+### v0.58.0 (2023-11-19)
+
+* Regenerated from discovery document revision 20231110
+
 ### v0.57.0 (2023-11-05)
 
 * Regenerated from discovery document revision 20231026

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

@@ -445,6 +445,47 @@ module Google
         end
       end
       
+      # Describes the custom _Default sink configuration that is used to override the
+      # built-in _Default sink configuration in newly created resource containers,
+      # such as projects or folders.
+      class DefaultSinkConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Specifies the set of exclusions to be added to the _Default sink in
+        # newly created resource containers.
+        # Corresponds to the JSON property `exclusions`
+        # @return [Array<Google::Apis::LoggingV2::LogExclusion>]
+        attr_accessor :exclusions
+      
+        # Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/
+        # advanced-queries). The only exported log entries are those that are in the
+        # resource owning the sink and that match the filter.For example:logName="
+        # projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERRORCannot be empty or
+        # unset if mode == OVERWRITE. In order to match all logs, use the following line
+        # as the value of filter and do not use exclusions:logName:*
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        # Required. Determines the behavior to apply to the built-in _Default sink
+        # inclusion filter.Exclusions are always appended, as built-in _Default sinks
+        # have no exclusions.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @exclusions = args[:exclusions] if args.key?(:exclusions)
+          @filter = args[:filter] if args.key?(:filter)
+          @mode = args[:mode] if args.key?(:mode)
+        end
+      end
+      
       # The parameters to DeleteLink.
       class DeleteLinkRequest
         include Google::Apis::Core::Hashable
@@ -1184,6 +1225,86 @@ module Google
         end
       end
       
+      # The response from ListRecentQueries.
+      class ListRecentQueriesResponse
+        include Google::Apis::Core::Hashable
+      
+        # If there might be more results than appear in this response, then
+        # nextPageToken is included. To get the next set of results, call the same
+        # method again using the value of nextPageToken as pageToken.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # A list of recent queries.
+        # Corresponds to the JSON property `recentQueries`
+        # @return [Array<Google::Apis::LoggingV2::RecentQuery>]
+        attr_accessor :recent_queries
+      
+        # The unreachable resources. Each resource can be either 1) a saved query if a
+        # specific query is unreachable or 2) a location if a specific location is
+        # unreachable. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/recentQueries/[
+        # QUERY_ID]" "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"
+        # projects/my-project/locations/global/recentQueries/12345678" "projects/my-
+        # project/locations/global"If there are unreachable resources, the response will
+        # first return pages that contain recent queries, and then return pages that
+        # contain the unreachable resources.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
+        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)
+          @recent_queries = args[:recent_queries] if args.key?(:recent_queries)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
+        end
+      end
+      
+      # The response from ListSavedQueries.
+      class ListSavedQueriesResponse
+        include Google::Apis::Core::Hashable
+      
+        # If there might be more results than appear in this response, then
+        # nextPageToken is included. To get the next set of results, call the same
+        # method again using the value of nextPageToken as pageToken.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # A list of saved queries.
+        # Corresponds to the JSON property `savedQueries`
+        # @return [Array<Google::Apis::LoggingV2::SavedQuery>]
+        attr_accessor :saved_queries
+      
+        # The unreachable resources. It can be either 1) a saved query if a specific
+        # query is unreachable or 2) a location if a specific location is unreachabe. "
+        # projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" "
+        # projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example: "projects/my-
+        # project/locations/global/savedQueries/12345678" "projects/my-project/locations/
+        # global" If there are unreachable resources, the response will first return
+        # pages that contain saved queries, and then return pages that contain the
+        # unreachable resources.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
+        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)
+          @saved_queries = args[:saved_queries] if args.key?(:saved_queries)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
+        end
+      end
+      
       # Result returned from ListSinks.
       class ListSinksResponse
         include Google::Apis::Core::Hashable
@@ -2196,6 +2317,48 @@ module Google
         end
       end
       
+      # Describes a Cloud Logging query that can be run in Logs Explorer UI or via the
+      # logging API.In addition to the query itself, additional information may be
+      # stored to capture the display configuration and other UI state used in
+      # association with analysis of query results.
+      class LoggingQuery
+        include Google::Apis::Core::Hashable
+      
+        # An advanced query using the Logging Query Language (https://cloud.google.com/
+        # logging/docs/view/logging-query-language). The maximum length of the filter is
+        # 20000 characters.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        # Characters will be counted from the end of the string.
+        # Corresponds to the JSON property `summaryFieldEnd`
+        # @return [Fixnum]
+        attr_accessor :summary_field_end
+      
+        # Characters will be counted from the start of the string.
+        # Corresponds to the JSON property `summaryFieldStart`
+        # @return [Fixnum]
+        attr_accessor :summary_field_start
+      
+        # The set of summary fields to display for this saved query.
+        # Corresponds to the JSON property `summaryFields`
+        # @return [Array<Google::Apis::LoggingV2::SummaryField>]
+        attr_accessor :summary_fields
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @filter = args[:filter] if args.key?(:filter)
+          @summary_field_end = args[:summary_field_end] if args.key?(:summary_field_end)
+          @summary_field_start = args[:summary_field_start] if args.key?(:summary_field_start)
+          @summary_fields = args[:summary_fields] if args.key?(:summary_fields)
+        end
+      end
+      
       # Defines a metric type and its schema. Once a metric descriptor is created,
       # deleting or altering it stops data collection and makes the metric type's
       # existing data unusable.
@@ -2576,6 +2739,74 @@ module Google
         end
       end
       
+      # Describes an analytics query that can be run in the Log Analytics page of
+      # Google Cloud console.Preview: This is a preview feature and may be subject to
+      # change before final release.
+      class OpsAnalyticsQuery
+        include Google::Apis::Core::Hashable
+      
+        # Required. A logs analytics SQL query, which generally follows BigQuery format.
+        # This is the SQL query that appears in the Log Analytics UI's query editor.
+        # Corresponds to the JSON property `sqlQueryText`
+        # @return [String]
+        attr_accessor :sql_query_text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sql_query_text = args[:sql_query_text] if args.key?(:sql_query_text)
+        end
+      end
+      
+      # Describes a recent query executed on the Logs Explorer or Log Analytics page
+      # within the last ~ 30 days.
+      class RecentQuery
+        include Google::Apis::Core::Hashable
+      
+        # The timestamp when this query was last run.
+        # Corresponds to the JSON property `lastRunTime`
+        # @return [String]
+        attr_accessor :last_run_time
+      
+        # Describes a Cloud Logging query that can be run in Logs Explorer UI or via the
+        # logging API.In addition to the query itself, additional information may be
+        # stored to capture the display configuration and other UI state used in
+        # association with analysis of query results.
+        # Corresponds to the JSON property `loggingQuery`
+        # @return [Google::Apis::LoggingV2::LoggingQuery]
+        attr_accessor :logging_query
+      
+        # Output only. Resource name of the recent query.In the format: "projects/[
+        # PROJECT_ID]/locations/[LOCATION_ID]/recentQueries/[QUERY_ID]" For a list of
+        # supported locations, see Supported Regions (https://cloud.google.com/logging/
+        # docs/region-support)The QUERY_ID is a system generated alphanumeric ID.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Describes an analytics query that can be run in the Log Analytics page of
+        # Google Cloud console.Preview: This is a preview feature and may be subject to
+        # change before final release.
+        # Corresponds to the JSON property `opsAnalyticsQuery`
+        # @return [Google::Apis::LoggingV2::OpsAnalyticsQuery]
+        attr_accessor :ops_analytics_query
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @last_run_time = args[:last_run_time] if args.key?(:last_run_time)
+          @logging_query = args[:logging_query] if args.key?(:logging_query)
+          @name = args[:name] if args.key?(:name)
+          @ops_analytics_query = args[:ops_analytics_query] if args.key?(:ops_analytics_query)
+        end
+      end
+      
       # Complete log information about a single HTTP request to an App Engine
       # application.
       class RequestLog
@@ -2813,11 +3044,83 @@ module Google
         end
       end
       
-      # Describes the settings associated with a project, folder, organization,
-      # billing account, or flexible resource.
+      # Describes a query that has been saved by a user.
+      class SavedQuery
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The timestamp when the saved query was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # A human readable description of the saved query.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # The user specified title for the SavedQuery.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Describes a Cloud Logging query that can be run in Logs Explorer UI or via the
+        # logging API.In addition to the query itself, additional information may be
+        # stored to capture the display configuration and other UI state used in
+        # association with analysis of query results.
+        # Corresponds to the JSON property `loggingQuery`
+        # @return [Google::Apis::LoggingV2::LoggingQuery]
+        attr_accessor :logging_query
+      
+        # Output only. Resource name of the saved query.In the format: "projects/[
+        # PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For a list of
+        # supported locations, see Supported Regions (https://cloud.google.com/logging/
+        # docs/region-support#bucket-regions)After the saved query is created, the
+        # location cannot be changed.If the user doesn't provide a QUERY_ID, the system
+        # will generate an alphanumeric ID.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Describes an analytics query that can be run in the Log Analytics page of
+        # Google Cloud console.Preview: This is a preview feature and may be subject to
+        # change before final release.
+        # Corresponds to the JSON property `opsAnalyticsQuery`
+        # @return [Google::Apis::LoggingV2::OpsAnalyticsQuery]
+        attr_accessor :ops_analytics_query
+      
+        # Output only. The timestamp when the saved query was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @description = args[:description] if args.key?(:description)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @logging_query = args[:logging_query] if args.key?(:logging_query)
+          @name = args[:name] if args.key?(:name)
+          @ops_analytics_query = args[:ops_analytics_query] if args.key?(:ops_analytics_query)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Describes the settings associated with a project, folder, organization, or
+      # billing account.
       class Settings
         include Google::Apis::Core::Hashable
       
+        # Describes the custom _Default sink configuration that is used to override the
+        # built-in _Default sink configuration in newly created resource containers,
+        # such as projects or folders.
+        # Corresponds to the JSON property `defaultSinkConfig`
+        # @return [Google::Apis::LoggingV2::DefaultSinkConfig]
+        attr_accessor :default_sink_config
+      
         # Optional. If set to true, the _Default sink in newly created projects and
         # folders will created in a disabled state. This can be used to automatically
         # disable log storage if there is already an aggregated sink configured in the
@@ -2830,34 +3133,31 @@ module Google
         # Optional. The resource name for the configured Cloud KMS key.KMS key name
         # format: "projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/
         # cryptoKeys/[KEY]" For example:"projects/my-project/locations/us-central1/
-        # keyRings/my-ring/cryptoKeys/my-key"To enable CMEK for the Log Router, set this
-        # field to a valid kms_key_name for which the associated service account has the
-        # required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.
-        # The Cloud KMS key used by the Log Router can be updated by changing the
-        # kms_key_name to a new valid key name. Encryption operations that are in
-        # progress will be completed with the key that was in use when they started.
-        # Decryption operations will be completed using the key that was used at the
-        # time of encryption unless access to that key has been revoked.To disable CMEK
-        # for the Log Router, set this field to an empty string.See Enabling CMEK for
-        # Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption)
-        # for more information.
+        # keyRings/my-ring/cryptoKeys/my-key"To enable CMEK, set this field to a valid
+        # kms_key_name for which the associated service account has the required roles/
+        # cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud KMS
+        # key used by the Log Router can be updated by changing the kms_key_name to a
+        # new valid key name.To disable CMEK for the Log Router, set this field to an
+        # empty string.See Enabling CMEK for Log Router (https://cloud.google.com/
+        # logging/docs/routing/managed-encryption) for more information.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
       
         # Output only. The service account that will be used by the Log Router to access
-        # your Cloud KMS key.Before enabling CMEK for Log Router, you must first assign
-        # the role roles/cloudkms.cryptoKeyEncrypterDecrypter to the service account
-        # that the Log Router will use to access your Cloud KMS key. Use GetSettings to
-        # obtain the service account ID.See Enabling CMEK for Log Router (https://cloud.
-        # google.com/logging/docs/routing/managed-encryption) for more information.
+        # your Cloud KMS key.Before enabling CMEK, you must first assign the role roles/
+        # cloudkms.cryptoKeyEncrypterDecrypter to the service account that will be used
+        # to access your Cloud KMS key. Use GetSettings to obtain the service account ID.
+        # See Enabling CMEK for Log Router (https://cloud.google.com/logging/docs/
+        # routing/managed-encryption) for more information.
         # Corresponds to the JSON property `kmsServiceAccountId`
         # @return [String]
         attr_accessor :kms_service_account_id
       
-        # Output only. The service account for the given container. Sinks use this
-        # service account as their writer_identity if no custom service account is
-        # provided.
+        # Output only. The service account for the given resource container, such as
+        # project or folder. Log sinks use this service account as their writer_identity
+        # if no custom service account is provided in the request when calling the
+        # create sink method.
         # Corresponds to the JSON property `loggingServiceAccountId`
         # @return [String]
         attr_accessor :logging_service_account_id
@@ -2883,6 +3183,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @default_sink_config = args[:default_sink_config] if args.key?(:default_sink_config)
           @disable_default_sink = args[:disable_default_sink] if args.key?(:disable_default_sink)
           @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
           @kms_service_account_id = args[:kms_service_account_id] if args.key?(:kms_service_account_id)
@@ -2995,6 +3296,28 @@ module Google
         end
       end
       
+      # A field from the LogEntry that is added to the summary line (https://cloud.
+      # google.com/logging/docs/view/logs-explorer-interface#add-summary-fields) for a
+      # query in the Logs Explorer.
+      class SummaryField
+        include Google::Apis::Core::Hashable
+      
+        # The field from the LogEntry to include in the summary line, for example
+        # resource.type or jsonPayload.name.
+        # Corresponds to the JSON property `field`
+        # @return [String]
+        attr_accessor :field
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @field = args[:field] if args.key?(:field)
+        end
+      end
+      
       # Information about entries that were omitted from the session.
       class SuppressionInfo
         include Google::Apis::Core::Hashable

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.57.0"
+      GEM_VERSION = "0.59.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20231026"
+      REVISION = "20231130"
     end
   end
 end