google-apis-monitoring_v3 0.82.0 → 0.83.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7a46434d740def7ca77372a68fb09014ba9da049f8fc22448cbd3b0b4632d7d
-  data.tar.gz: 9d6e726e05f23c39335bdd21da1b1bdc347a199f198ce639b6e77209f51ebb7e
+  metadata.gz: f501bf2830f349597646bb1aed1a7c1837016fdb87cd279c30ec16f82766823b
+  data.tar.gz: 43e57acdc201794071fb5293d4c9e0606154af3f399ebab94b1424730ccf78d1
 SHA512:
-  metadata.gz: 7c8d8fd8c605888526577e0faec2b7953479c43e9b1844f1e77ff59a57e4807096b516b618e0fa73f29f626c88b41f0b61c09b597e48c41a388609fb77da004f
-  data.tar.gz: a9dcd07195da31d0a42aeb93128b00b7598cb443b8f86db8766d85a3c068a046e316b09945551bab65299b614a2d571256bf1fdf7e41bf994515a69d1a6622f9
+  metadata.gz: f5d9a441703069e3f18cde02af54d0e1aba5f4769f6a46ae6876baae9fa40314adb0bcbfcbf505c65b6ce11f5658758648be85be4c380e5f16730bc3c6a9f2bd
+  data.tar.gz: 3498acfa1e52608aa55a5b1981850a16da0f08ea337554ffb8da094320a50fd352403ae3785de11b45c2c4947c0d66a42c63626aeff4fa1b743b1f669cdce966

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-monitoring_v3
 
+### v0.83.0 (2025-10-12)
+
+* Regenerated from discovery document revision 20251006
+
 ### v0.82.0 (2025-08-10)
 
 * Regenerated from discovery document revision 20250731

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

@@ -116,6 +116,90 @@ module Google
         end
       end
       
+      # An alert is the representation of a violation of an alert policy. It is a read-
+      # only resource that cannot be modified by the accompanied API.
+      class Alert
+        include Google::Apis::Core::Hashable
+      
+        # The time when the alert was closed.
+        # Corresponds to the JSON property `closeTime`
+        # @return [String]
+        attr_accessor :close_time
+      
+        # Information about the log for log-based alerts.
+        # Corresponds to the JSON property `log`
+        # @return [Google::Apis::MonitoringV3::LogMetadata]
+        attr_accessor :log
+      
+        # Auxiliary metadata for a MonitoredResource object. MonitoredResource objects
+        # contain the minimum set of information to uniquely identify a monitored
+        # resource instance. There is some other useful auxiliary metadata. Monitoring
+        # and Logging use an ingestion pipeline to extract metadata for cloud resources
+        # of all types, and store the metadata in this message.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::MonitoringV3::MonitoredResourceMetadata]
+        attr_accessor :metadata
+      
+        # A specific metric, identified by specifying values for all of the labels of a
+        # MetricDescriptor.
+        # Corresponds to the JSON property `metric`
+        # @return [Google::Apis::MonitoringV3::Metric]
+        attr_accessor :metric
+      
+        # Identifier. The name of the alert.The format is: projects/[
+        # PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID] The [ALERT_ID] is a system-assigned
+        # unique identifier for the alert.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The time when the alert was opened.
+        # Corresponds to the JSON property `openTime`
+        # @return [String]
+        attr_accessor :open_time
+      
+        # The state of the policy at the time the alert was generated.
+        # Corresponds to the JSON property `policy`
+        # @return [Google::Apis::MonitoringV3::PolicySnapshot]
+        attr_accessor :policy
+      
+        # An object representing a resource that can be used for monitoring, logging,
+        # billing, or other purposes. Examples include virtual machine instances,
+        # databases, and storage devices such as disks. The type field identifies a
+        # MonitoredResourceDescriptor object that describes the resource's schema.
+        # Information in the labels field identifies the actual resource and its
+        # attributes according to the schema. For example, a particular Compute Engine
+        # VM instance could be represented by the following object, because the
+        # MonitoredResourceDescriptor for "gce_instance" has labels "project_id", "
+        # instance_id" and "zone": ` "type": "gce_instance", "labels": ` "project_id": "
+        # my-project", "instance_id": "12345678901234", "zone": "us-central1-a" ``
+        # Corresponds to the JSON property `resource`
+        # @return [Google::Apis::MonitoringV3::MonitoredResource]
+        attr_accessor :resource
+      
+        # Output only. The current state of the alert.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @close_time = args[:close_time] if args.key?(:close_time)
+          @log = args[:log] if args.key?(:log)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @metric = args[:metric] if args.key?(:metric)
+          @name = args[:name] if args.key?(:name)
+          @open_time = args[:open_time] if args.key?(:open_time)
+          @policy = args[:policy] if args.key?(:policy)
+          @resource = args[:resource] if args.key?(:resource)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
       # A description of the conditions under which some aspect of your system is
       # considered to be "unhealthy" and the ways to notify people or services about
       # this state. For an overview of alerting policies, see Introduction to Alerting
@@ -2407,6 +2491,41 @@ module Google
         end
       end
       
+      # The ListAlerts response.
+      class ListAlertsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of alerts.
+        # Corresponds to the JSON property `alerts`
+        # @return [Array<Google::Apis::MonitoringV3::Alert>]
+        attr_accessor :alerts
+      
+        # If not empty, indicates that there may be more results that match the request.
+        # Use the value in the page_token field in a subsequent request to fetch the
+        # next set of results. The token is encrypted and only guaranteed to return
+        # correct results for 72 hours after it is created. If empty, all results have
+        # been returned.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # The estimated total number of matching results for this query.
+        # Corresponds to the JSON property `totalSize`
+        # @return [Fixnum]
+        attr_accessor :total_size
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @alerts = args[:alerts] if args.key?(:alerts)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @total_size = args[:total_size] if args.key?(:total_size)
+        end
+      end
+      
       # The ListGroupMembers response.
       class ListGroupMembersResponse
         include Google::Apis::Core::Hashable
@@ -2819,6 +2938,25 @@ module Google
         end
       end
       
+      # Information about the log for log-based alerts.
+      class LogMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The labels extracted from the log.
+        # Corresponds to the JSON property `extractedLabels`
+        # @return [Hash<String,String>]
+        attr_accessor :extracted_labels
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @extracted_labels = args[:extracted_labels] if args.key?(:extracted_labels)
+        end
+      end
+      
       # Istio service scoped to an Istio mesh. Anthos clusters running ASM < 1.6.8
       # will have their services ingested as this type.
       class MeshIstio
@@ -3958,6 +4096,44 @@ module Google
         end
       end
       
+      # The state of the policy at the time the alert was generated.
+      class PolicySnapshot
+        include Google::Apis::Core::Hashable
+      
+        # The display name of the alert policy.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The name of the alert policy resource. In the form of "projects/
+        # PROJECT_ID_OR_NUMBER/alertPolicies/ALERT_POLICY_ID".
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The severity of the alert policy.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        # The user labels for the alert policy.
+        # Corresponds to the JSON property `userLabels`
+        # @return [Hash<String,String>]
+        attr_accessor :user_labels
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @name = args[:name] if args.key?(:name)
+          @severity = args[:severity] if args.key?(:severity)
+          @user_labels = args[:user_labels] if args.key?(:user_labels)
+        end
+      end
+      
       # A condition type that allows alerting policies to be defined using Prometheus
       # Query Language (PromQL) (https://prometheus.io/docs/prometheus/latest/querying/
       # basics/).The PrometheusQueryLanguageCondition message contains information

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module MonitoringV3
       # Version of the google-apis-monitoring_v3 gem
-      GEM_VERSION = "0.82.0"
+      GEM_VERSION = "0.83.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250731"
+      REVISION = "20251006"
     end
   end
 end

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

@@ -28,6 +28,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Alert
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AlertPolicy
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -358,6 +364,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListAlertsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListGroupMembersResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -436,6 +448,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class LogMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MeshIstio
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -574,6 +592,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PolicySnapshot
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PrometheusQueryLanguageCondition
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -794,6 +818,26 @@ module Google
         end
       end
       
+      class Alert
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :close_time, as: 'closeTime'
+          property :log, as: 'log', class: Google::Apis::MonitoringV3::LogMetadata, decorator: Google::Apis::MonitoringV3::LogMetadata::Representation
+      
+          property :metadata, as: 'metadata', class: Google::Apis::MonitoringV3::MonitoredResourceMetadata, decorator: Google::Apis::MonitoringV3::MonitoredResourceMetadata::Representation
+      
+          property :metric, as: 'metric', class: Google::Apis::MonitoringV3::Metric, decorator: Google::Apis::MonitoringV3::Metric::Representation
+      
+          property :name, as: 'name'
+          property :open_time, as: 'openTime'
+          property :policy, as: 'policy', class: Google::Apis::MonitoringV3::PolicySnapshot, decorator: Google::Apis::MonitoringV3::PolicySnapshot::Representation
+      
+          property :resource, as: 'resource', class: Google::Apis::MonitoringV3::MonitoredResource, decorator: Google::Apis::MonitoringV3::MonitoredResource::Representation
+      
+          property :state, as: 'state'
+        end
+      end
+      
       class AlertPolicy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1351,6 +1395,16 @@ module Google
         end
       end
       
+      class ListAlertsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :alerts, as: 'alerts', class: Google::Apis::MonitoringV3::Alert, decorator: Google::Apis::MonitoringV3::Alert::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+          property :total_size, as: 'totalSize'
+        end
+      end
+      
       class ListGroupMembersResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1474,6 +1528,13 @@ module Google
         end
       end
       
+      class LogMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :extracted_labels, as: 'extractedLabels'
+        end
+      end
+      
       class MeshIstio
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1718,6 +1779,16 @@ module Google
         end
       end
       
+      class PolicySnapshot
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :display_name, as: 'displayName'
+          property :name, as: 'name'
+          property :severity, as: 'severity'
+          hash :user_labels, as: 'userLabels'
+        end
+      end
+      
       class PrometheusQueryLanguageCondition
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -601,6 +601,89 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets a single alert.
+        # @param [String] name
+        #   Required. The name of the alert.The format is: projects/[PROJECT_ID_OR_NUMBER]/
+        #   alerts/[ALERT_ID] The [ALERT_ID] is a system-assigned unique identifier for
+        #   the alert.
+        # @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::MonitoringV3::Alert] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MonitoringV3::Alert]
+        #
+        # @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_project_alert(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::MonitoringV3::Alert::Representation
+          command.response_class = Google::Apis::MonitoringV3::Alert
+          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 the existing alerts for the metrics scope of the project.
+        # @param [String] parent
+        #   Required. The name of the project to list alerts for.
+        # @param [String] filter
+        #   Optional. An alert is returned if there is a match on any fields belonging to
+        #   the alert or its subfields.
+        # @param [String] order_by
+        #   Optional. A comma-separated list of fields in Alert to use for sorting. The
+        #   default sort direction is ascending. To specify descending order for a field,
+        #   add a desc modifier. The following fields are supported: open_time
+        #   close_timeFor example, close_time desc, open_time will return the alerts
+        #   closed most recently, with ties broken in the order of older alerts listed
+        #   first.If the field is not set, the results are sorted by open_time desc.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return in a single response. If not
+        #   set to a positive number, at most 50 alerts will be returned. The maximum
+        #   value is 1000; values above 1000 will be coerced to 1000.
+        # @param [String] page_token
+        #   Optional. If non-empty, page_token must contain a value returned as the
+        #   next_page_token in a previous response to request the next set of results.
+        # @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::MonitoringV3::ListAlertsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MonitoringV3::ListAlertsResponse]
+        #
+        # @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_alerts(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/alerts', options)
+          command.response_representation = Google::Apis::MonitoringV3::ListAlertsResponse::Representation
+          command.response_class = Google::Apis::MonitoringV3::ListAlertsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.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?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Cloud Monitoring Agent only: Creates a new time series.This method is only for
         # use by the Cloud Monitoring Agent. Use projects.timeSeries.create instead.
         # @param [String] name

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-monitoring_v3
 version: !ruby/object:Gem::Version
-  version: 0.82.0
+  version: 0.83.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,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-monitoring_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-monitoring_v3/v0.82.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-monitoring_v3/v0.83.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-monitoring_v3
 rdoc_options: []
 require_paths: