google-apis-monitoring_v3 0.3.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90854a2b71dabb439f2dbbf348bf0480aa36de03260006bc1acb3f93389c9b43
-  data.tar.gz: 5b5a6e9a4f3f83469d9a4b74d46f7eeb0635ce8e8f8a4960e6b10dcdfef51e48
+  metadata.gz: 16fd8889b71145bc6711cd640b38d66587a94dd1f78dc1d07fa1ba9852dd9d25
+  data.tar.gz: 605b19913786bc63a5da9e2597b9ddcc976e17030cb882b92a3070cdc05a1e22
 SHA512:
-  metadata.gz: 380a2c9aa289c25fe380f2cfcf52a9ec4f9f4e11b7db9a54b9c5db5b16f79b9fbc50132392df07bd739eb8ddf6331cb46c4e3f03b90641f4caa2ee4fbb0369b6
-  data.tar.gz: c36f0d92a6fdb1d547965c581e463b9acc35826c64e4c757d1b3db101868f9fe66af7056f94e1eee671852d9354af678f4880cde50716b2d2c997fd26e3c1a96
+  metadata.gz: b8b4eaf558e4c47b29824f1f6af6e9e4e863c1c919a3a32973b492db9360b15dae254dbd20a2bf3c411ddde7386032ef94cc2da2248c5378dcba51c11dea9bb4
+  data.tar.gz: 18fa015a9b7cf91b7e4e94146b62e8c4a9b4dce5dfad13f5d0e6682df598fcd4e2e830409943fd3edee4db596ef9046690123e31244821b1aa2b348881aae784

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Release history for google-apis-monitoring_v3
 
+### v0.8.0 (2021-06-18)
+
+* Regenerated from discovery document revision 20210614
+* Regenerated using generator version 0.3.0
+
+### v0.7.0 (2021-05-19)
+
+* Unspecified changes
+
+### v0.6.0 (2021-04-30)
+
+* Regenerated from discovery document revision 20210427
+
+### v0.5.0 (2021-04-02)
+
+* Regenerated from discovery document revision 20210326
+
+### v0.4.0 (2021-03-26)
+
+* Regenerated from discovery document revision 20210322
+* Regenerated using generator version 0.2.0
+
 ### v0.3.0 (2021-03-05)
 
 * Regenerated from discovery document revision 20210227

data/lib/google/apis/monitoring_v3.rb

@@ -33,7 +33,7 @@ module Google
       # This is NOT the gem version.
       VERSION = 'V3'
 
-      # View and manage your data across Google Cloud Platform services
+      # See, edit, configure, and delete your Google Cloud Platform data
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
 
       # View and write monitoring data for all of your Google and third-party Cloud and API projects

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

@@ -2929,6 +2929,38 @@ module Google
         end
       end
       
+      # Contains metadata for longrunning operation for the edit Metrics Scope
+      # endpoints.
+      class OperationMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The time when the batch request was received.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Current state of the batch operation.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # The time when the operation result 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)
+          @state = args[:state] if args.key?(:state)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
       # A protocol buffer option, which can be attached to a message, field,
       # enumeration, etc.
       class Option
@@ -3328,6 +3360,16 @@ module Google
         # @return [Google::Apis::MonitoringV3::Telemetry]
         attr_accessor :telemetry
       
+        # Labels which have been used to annotate the service. Label keys must start
+        # with a letter. Label keys and values may contain lowercase letters, numbers,
+        # underscores, and dashes. Label keys and values have a maximum length of 63
+        # characters, and must be less than 128 bytes in size. Up to 64 label entries
+        # may be stored. For labels which do not have a semantic value, the empty string
+        # may be supplied for the label value.
+        # Corresponds to the JSON property `userLabels`
+        # @return [Hash<String,String>]
+        attr_accessor :user_labels
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3343,6 +3385,7 @@ module Google
           @mesh_istio = args[:mesh_istio] if args.key?(:mesh_istio)
           @name = args[:name] if args.key?(:name)
           @telemetry = args[:telemetry] if args.key?(:telemetry)
+          @user_labels = args[:user_labels] if args.key?(:user_labels)
         end
       end
       
@@ -3449,6 +3492,16 @@ module Google
         # @return [Google::Apis::MonitoringV3::ServiceLevelIndicator]
         attr_accessor :service_level_indicator
       
+        # Labels which have been used to annotate the service-level objective. Label
+        # keys must start with a letter. Label keys and values may contain lowercase
+        # letters, numbers, underscores, and dashes. Label keys and values have a
+        # maximum length of 63 characters, and must be less than 128 bytes in size. Up
+        # to 64 label entries may be stored. For labels which do not have a semantic
+        # value, the empty string may be supplied for the label value.
+        # Corresponds to the JSON property `userLabels`
+        # @return [Hash<String,String>]
+        attr_accessor :user_labels
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3461,6 +3514,7 @@ module Google
           @name = args[:name] if args.key?(:name)
           @rolling_period = args[:rolling_period] if args.key?(:rolling_period)
           @service_level_indicator = args[:service_level_indicator] if args.key?(:service_level_indicator)
+          @user_labels = args[:user_labels] if args.key?(:user_labels)
         end
       end
       
@@ -3485,8 +3539,8 @@ module Google
         end
       end
       
-      # The context of a span, attached to Exemplars in Distribution values during
-      # aggregation.It contains the name of a span with format: projects/[
+      # The context of a span. This is attached to an Exemplar in Distribution values
+      # during aggregation.It contains the name of a span with format: projects/[
       # PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID]
       class SpanContext
         include Google::Apis::Core::Hashable

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.3.0"
+      GEM_VERSION = "0.8.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.1.2"
+      GENERATOR_VERSION = "0.3.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210227"
+      REVISION = "20210614"
     end
   end
 end

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

@@ -424,6 +424,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class OperationMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Option
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1297,6 +1303,15 @@ module Google
         end
       end
       
+      class OperationMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
       class Option
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1409,6 +1424,7 @@ module Google
           property :name, as: 'name'
           property :telemetry, as: 'telemetry', class: Google::Apis::MonitoringV3::Telemetry, decorator: Google::Apis::MonitoringV3::Telemetry::Representation
       
+          hash :user_labels, as: 'userLabels'
         end
       end
       
@@ -1434,6 +1450,7 @@ module Google
           property :rolling_period, as: 'rollingPeriod'
           property :service_level_indicator, as: 'serviceLevelIndicator', class: Google::Apis::MonitoringV3::ServiceLevelIndicator, decorator: Google::Apis::MonitoringV3::ServiceLevelIndicator::Representation
       
+          hash :user_labels, as: 'userLabels'
         end
       end
       

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

@@ -56,9 +56,10 @@ module Google
         # Lists time series that match a filter. This method does not require a
         # Workspace.
         # @param [String] name
-        #   Required. The project, organization or folder on which to execute the request.
-        #   The format is: projects/[PROJECT_ID_OR_NUMBER] organizations/[ORGANIZATION_ID]
-        #   folders/[FOLDER_ID]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   , organization or folder on which to execute the request. The format is:
+        #   projects/[PROJECT_ID_OR_NUMBER] organizations/[ORGANIZATION_ID] folders/[
+        #   FOLDER_ID]
         # @param [String] aggregation_alignment_period
         #   The alignment_period specifies a time interval, in seconds, that is used to
         #   divide the data in all the time series into consistent blocks of time. This
@@ -220,9 +221,10 @@ module Google
         # Lists time series that match a filter. This method does not require a
         # Workspace.
         # @param [String] name
-        #   Required. The project, organization or folder on which to execute the request.
-        #   The format is: projects/[PROJECT_ID_OR_NUMBER] organizations/[ORGANIZATION_ID]
-        #   folders/[FOLDER_ID]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   , organization or folder on which to execute the request. The format is:
+        #   projects/[PROJECT_ID_OR_NUMBER] organizations/[ORGANIZATION_ID] folders/[
+        #   FOLDER_ID]
         # @param [String] aggregation_alignment_period
         #   The alignment_period specifies a time interval, in seconds, that is used to
         #   divide the data in all the time series into consistent blocks of time. This
@@ -383,14 +385,14 @@ module Google
         
         # Creates a new alerting policy.
         # @param [String] name
-        #   Required. The project in which to create the alerting policy. The format is:
-        #   projects/[PROJECT_ID_OR_NUMBER] Note that this field names the parent
-        #   container in which the alerting policy will be written, not the name of the
-        #   created policy. |name| must be a host project of a workspace, otherwise
-        #   INVALID_ARGUMENT error will return. The alerting policy that is returned will
-        #   have a name that contains a normalized representation of this name as a prefix
-        #   but adds a suffix of the form /alertPolicies/[ALERT_POLICY_ID], identifying
-        #   the policy in the container.
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   in which to create the alerting policy. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER] Note that this field names the parent container in which
+        #   the alerting policy will be written, not the name of the created policy. |name|
+        #   must be a host project of a workspace, otherwise INVALID_ARGUMENT error will
+        #   return. The alerting policy that is returned will have a name that contains a
+        #   normalized representation of this name as a prefix but adds a suffix of the
+        #   form /alertPolicies/[ALERT_POLICY_ID], identifying the policy in the container.
         # @param [Google::Apis::MonitoringV3::AlertPolicy] alert_policy_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -486,10 +488,11 @@ module Google
         
         # Lists the existing alerting policies for the workspace.
         # @param [String] name
-        #   Required. The project whose alert policies are to be listed. The format is:
-        #   projects/[PROJECT_ID_OR_NUMBER] Note that this field names the parent
-        #   container in which the alerting policies to be listed are stored. To retrieve
-        #   a single alerting policy by name, use the GetAlertPolicy operation, instead.
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   whose alert policies are to be listed. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER] Note that this field names the parent container in which
+        #   the alerting policies to be listed are stored. To retrieve a single alerting
+        #   policy by name, use the GetAlertPolicy operation, instead.
         # @param [String] filter
         #   If provided, this field specifies the criteria that must be met by alert
         #   policies to be included in the response.For more details, see sorting and
@@ -598,8 +601,8 @@ module Google
         # only for use by the Stackdriver Monitoring Agent. Use projects.timeSeries.
         # create instead.
         # @param [String] name
-        #   The project in which to create the time series. The format is: projects/[
-        #   PROJECT_ID_OR_NUMBER]
+        #   The project (https://cloud.google.com/monitoring/api/v3#project_name) in which
+        #   to create the time series. The format is: projects/[PROJECT_ID_OR_NUMBER]
         # @param [Google::Apis::MonitoringV3::CreateCollectdTimeSeriesRequest] create_collectd_time_series_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -632,8 +635,8 @@ module Google
         
         # Creates a new group.
         # @param [String] name
-        #   Required. The project in which to create the group. The format is: projects/[
-        #   PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   in which to create the group. The format is: projects/[PROJECT_ID_OR_NUMBER]
         # @param [Google::Apis::MonitoringV3::Group] group_object
         # @param [Boolean] validate_only
         #   If true, validate this request but do not create the group.
@@ -736,8 +739,8 @@ module Google
         
         # Lists the existing groups.
         # @param [String] name
-        #   Required. The project whose groups are to be listed. The format is: projects/[
-        #   PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   whose groups are to be listed. The format is: projects/[PROJECT_ID_OR_NUMBER]
         # @param [String] ancestors_of_group
         #   A group name. The format is: projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
         #   Returns groups that are ancestors of the specified group. The groups are
@@ -886,8 +889,9 @@ module Google
         # Creates a new metric descriptor. User-created metric descriptors define custom
         # metrics (https://cloud.google.com/monitoring/custom-metrics).
         # @param [String] name
-        #   Required. The project on which to execute the request. The format is: projects/
-        #   [PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   on which to execute the request. The format is: 4 projects/
+        #   PROJECT_ID_OR_NUMBER
         # @param [Google::Apis::MonitoringV3::MetricDescriptor] metric_descriptor_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -987,8 +991,9 @@ module Google
         # Lists metric descriptors that match a filter. This method does not require a
         # Workspace.
         # @param [String] name
-        #   Required. The project on which to execute the request. The format is: projects/
-        #   [PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   on which to execute the request. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER]
         # @param [String] filter
         #   If this field is empty, all custom and system-defined metric descriptors are
         #   returned. Otherwise, the filter (https://cloud.google.com/monitoring/api/v3/
@@ -1068,8 +1073,9 @@ module Google
         # Lists monitored resource descriptors that match a filter. This method does not
         # require a Workspace.
         # @param [String] name
-        #   Required. The project on which to execute the request. The format is: projects/
-        #   [PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   on which to execute the request. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER]
         # @param [String] filter
         #   An optional filter (https://cloud.google.com/monitoring/api/v3/filters)
         #   describing the descriptors to be returned. The filter can reference the
@@ -1149,8 +1155,9 @@ module Google
         # @param [String] name
         #   Required. The REST resource name of the parent from which to retrieve the
         #   notification channel descriptors. The expected syntax is: projects/[
-        #   PROJECT_ID_OR_NUMBER] Note that this names the parent container in which to
-        #   look for the descriptors; to retrieve a single descriptor by name, use the
+        #   PROJECT_ID_OR_NUMBER] Note that this names (https://cloud.google.com/
+        #   monitoring/api/v3#project_name) the parent container in which to look for the
+        #   descriptors; to retrieve a single descriptor by name, use the
         #   GetNotificationChannelDescriptor operation, instead.
         # @param [Fixnum] page_size
         #   The maximum number of results to return in a single response. If not set to a
@@ -1190,8 +1197,9 @@ module Google
         # Creates a new notification channel, representing a single notification
         # endpoint such as an email address, SMS number, or PagerDuty service.
         # @param [String] name
-        #   Required. The project on which to execute the request. The format is: projects/
-        #   [PROJECT_ID_OR_NUMBER] This names the container into which the channel will be
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   on which to execute the request. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER] This names the container into which the channel will be
         #   written, this does not name the newly created channel. The resulting channel's
         #   name will have a normalized version of this field as a prefix, but will add /
         #   notificationChannels/[CHANNEL_ID] to identify the channel.
@@ -1351,8 +1359,9 @@ module Google
         
         # Lists the notification channels that have been created for the project.
         # @param [String] name
-        #   Required. The project on which to execute the request. The format is: projects/
-        #   [PROJECT_ID_OR_NUMBER] This names the container in which to look for the
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   on which to execute the request. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER] This names the container in which to look for the
         #   notification channels; it does not name a specific channel. To query a
         #   specific channel by REST resource name, use the GetNotificationChannel
         #   operation.
@@ -1515,8 +1524,9 @@ module Google
         # time series in the request were written. If any time series could not be
         # written, a corresponding failure message is included in the error response.
         # @param [String] name
-        #   Required. The project on which to execute the request. The format is: projects/
-        #   [PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   on which to execute the request. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER]
         # @param [Google::Apis::MonitoringV3::CreateTimeSeriesRequest] create_time_series_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1550,9 +1560,10 @@ module Google
         # Lists time series that match a filter. This method does not require a
         # Workspace.
         # @param [String] name
-        #   Required. The project, organization or folder on which to execute the request.
-        #   The format is: projects/[PROJECT_ID_OR_NUMBER] organizations/[ORGANIZATION_ID]
-        #   folders/[FOLDER_ID]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   , organization or folder on which to execute the request. The format is:
+        #   projects/[PROJECT_ID_OR_NUMBER] organizations/[ORGANIZATION_ID] folders/[
+        #   FOLDER_ID]
         # @param [String] aggregation_alignment_period
         #   The alignment_period specifies a time interval, in seconds, that is used to
         #   divide the data in all the time series into consistent blocks of time. This
@@ -1714,8 +1725,9 @@ module Google
         # Queries time series using Monitoring Query Language. This method does not
         # require a Workspace.
         # @param [String] name
-        #   Required. The project on which to execute the request. The format is: projects/
-        #   [PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   on which to execute the request. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER]
         # @param [Google::Apis::MonitoringV3::QueryTimeSeriesRequest] query_time_series_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1748,8 +1760,9 @@ module Google
         
         # Creates a new Uptime check configuration.
         # @param [String] parent
-        #   Required. The project in which to create the Uptime check. The format is:
-        #   projects/[PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   in which to create the Uptime check. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER]
         # @param [Google::Apis::MonitoringV3::UptimeCheckConfig] uptime_check_config_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1847,8 +1860,9 @@ module Google
         # Lists the existing valid Uptime check configurations for the project (leaving
         # out any invalid configurations).
         # @param [String] parent
-        #   Required. The project whose Uptime check configurations are listed. The format
-        #   is: projects/[PROJECT_ID_OR_NUMBER]
+        #   Required. The project (https://cloud.google.com/monitoring/api/v3#project_name)
+        #   whose Uptime check configurations are listed. The format is: projects/[
+        #   PROJECT_ID_OR_NUMBER]
         # @param [Fixnum] page_size
         #   The maximum number of results to return in a single response. The server may
         #   further constrain the maximum number of results returned in a single page. If
@@ -1936,7 +1950,8 @@ module Google
         
         # Create a Service.
         # @param [String] parent
-        #   Required. Resource name of the parent workspace. The format is: projects/[
+        #   Required. Resource name (https://cloud.google.com/monitoring/api/v3#
+        #   project_name) of the parent workspace. The format is: projects/[
         #   PROJECT_ID_OR_NUMBER]
         # @param [Google::Apis::MonitoringV3::Service] service_object
         # @param [String] service_id
@@ -2037,8 +2052,9 @@ module Google
         # List Services for this workspace.
         # @param [String] parent
         #   Required. Resource name of the parent containing the listed services, either a
-        #   project or a Monitoring Workspace. The formats are: projects/[
-        #   PROJECT_ID_OR_NUMBER] workspaces/[HOST_PROJECT_ID_OR_NUMBER]
+        #   project (https://cloud.google.com/monitoring/api/v3#project_name) or a
+        #   Monitoring Workspace. The formats are: projects/[PROJECT_ID_OR_NUMBER]
+        #   workspaces/[HOST_PROJECT_ID_OR_NUMBER]
         # @param [String] filter
         #   A filter specifying what Services to return. The filter currently supports the
         #   following fields: - `identifier_case` - `app_engine.module_id` - `

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-monitoring_v3
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-08 00:00:00.000000000 Z
+date: 2021-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -52,7 +52,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/master/generated/google-apis-monitoring_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-monitoring_v3/v0.3.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-monitoring_v3/v0.8.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-monitoring_v3
 post_install_message: 
 rdoc_options: []
@@ -69,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Monitoring API V3