google-cloud-monitoring-v3 0.16.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (26) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/monitoring/v3/group_service/client.rb +11 -8
  3. data/lib/google/cloud/monitoring/v3/metric_service/client.rb +45 -30
  4. data/lib/google/cloud/monitoring/v3/query_service/client.rb +5 -4
  5. data/lib/google/cloud/monitoring/v3/query_service.rb +1 -1
  6. data/lib/google/cloud/monitoring/v3/service_monitoring_service/client.rb +34 -32
  7. data/lib/google/cloud/monitoring/v3/service_monitoring_service.rb +3 -3
  8. data/lib/google/cloud/monitoring/v3/uptime_check_service/paths.rb +19 -0
  9. data/lib/google/cloud/monitoring/v3/version.rb +1 -1
  10. data/lib/google/monitoring/v3/common_pb.rb +1 -1
  11. data/lib/google/monitoring/v3/metric_service_services_pb.rb +11 -7
  12. data/lib/google/monitoring/v3/query_service_pb.rb +2 -2
  13. data/lib/google/monitoring/v3/query_service_services_pb.rb +2 -2
  14. data/lib/google/monitoring/v3/service_pb.rb +7 -1
  15. data/lib/google/monitoring/v3/service_service_services_pb.rb +4 -4
  16. data/lib/google/monitoring/v3/uptime_pb.rb +5 -1
  17. data/proto_docs/google/api/client.rb +4 -0
  18. data/proto_docs/google/api/monitored_resource.rb +1 -1
  19. data/proto_docs/google/monitoring/v3/alert.rb +4 -3
  20. data/proto_docs/google/monitoring/v3/common.rb +43 -33
  21. data/proto_docs/google/monitoring/v3/group_service.rb +11 -8
  22. data/proto_docs/google/monitoring/v3/metric_service.rb +35 -24
  23. data/proto_docs/google/monitoring/v3/service.rb +150 -8
  24. data/proto_docs/google/monitoring/v3/service_service.rb +28 -26
  25. data/proto_docs/google/monitoring/v3/uptime.rb +59 -1
  26. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3fa7079044f4ac1bbc53472a5559862bca32a0f2f7e0b57677faf0334b7b29de
4
- data.tar.gz: 9de6e2596a2342cdf19fac80f8a916f4f195e57cb38809cb60e62bb00974ef5c
3
+ metadata.gz: d6d6e330835b7206add4715b0bc7ad4829417a73198efafdbdaae6ba44bee80b
4
+ data.tar.gz: 11c6f19292e051e64eb1f79c811f12e8f46e25383aab49225305f26b5c97838d
5
5
  SHA512:
6
- metadata.gz: eee23b4b04d01dd3aa1cbba4db027fcba8010c5133e6eb2780e5662f1c7e2ce5d98d396e7b730d4a701c9d8357b50ae99fc76ff4b139848de8db551d1093fe18
7
- data.tar.gz: ac08bb75ad7ccd5c524740c4853f13d557ec1303a6de551ca4e80c8a7025df71eb7d22a31727273b7a10b11ddbf72a2d5eafee8c326ceb40e1345efbd56c54a4
6
+ metadata.gz: d4c0a6fd761a14c6b7213e9e6a74a02c7c24d7f7318e664dba1cbabd078bedc1688be51f62036c419fefe5942dbab46a62ed3bd3baeabba37958c0049112c155
7
+ data.tar.gz: 3456c8c3c8ccf89bf679af777eb90f9a1523b79d3ad38cee482e15e6f71b2dceee8ddbd1433f2fbd2a373c687981281599c3fcb3cf7f415e0a887c8726366711
@@ -217,8 +217,9 @@ module Google
217
217
  # the default parameter values, pass an empty Hash as a request object (see above).
218
218
  #
219
219
  # @param name [::String]
220
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name)
221
- # whose groups are to be listed. The format is:
220
+ # Required. The
221
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) whose
222
+ # groups are to be listed. The format is:
222
223
  #
223
224
  # projects/[PROJECT_ID_OR_NUMBER]
224
225
  # @param children_of_group [::String]
@@ -427,13 +428,14 @@ module Google
427
428
  # the default parameter values, pass an empty Hash as a request object (see above).
428
429
  #
429
430
  # @param name [::String]
430
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) in
431
- # which to create the group. The format is:
431
+ # Required. The
432
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) in which
433
+ # to create the group. The format is:
432
434
  #
433
435
  # projects/[PROJECT_ID_OR_NUMBER]
434
436
  # @param group [::Google::Cloud::Monitoring::V3::Group, ::Hash]
435
- # Required. A group definition. It is an error to define the `name` field because
436
- # the system assigns the name.
437
+ # Required. A group definition. It is an error to define the `name` field
438
+ # because the system assigns the name.
437
439
  # @param validate_only [::Boolean]
438
440
  # If true, validate this request but do not create the group.
439
441
  #
@@ -521,8 +523,9 @@ module Google
521
523
  # the default parameter values, pass an empty Hash as a request object (see above).
522
524
  #
523
525
  # @param group [::Google::Cloud::Monitoring::V3::Group, ::Hash]
524
- # Required. The new definition of the group. All fields of the existing group,
525
- # excepting `name`, are replaced with the corresponding fields of this group.
526
+ # Required. The new definition of the group. All fields of the existing
527
+ # group, excepting `name`, are replaced with the corresponding fields of this
528
+ # group.
526
529
  # @param validate_only [::Boolean]
527
530
  # If true, validate this request but do not update the existing group.
528
531
  #
@@ -196,7 +196,7 @@ module Google
196
196
  # Service calls
197
197
 
198
198
  ##
199
- # Lists monitored resource descriptors that match a filter. This method does not require a Workspace.
199
+ # Lists monitored resource descriptors that match a filter.
200
200
  #
201
201
  # @overload list_monitored_resource_descriptors(request, options = nil)
202
202
  # Pass arguments to `list_monitored_resource_descriptors` via a request object, either of type
@@ -214,8 +214,9 @@ module Google
214
214
  # the default parameter values, pass an empty Hash as a request object (see above).
215
215
  #
216
216
  # @param name [::String]
217
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
218
- # which to execute the request. The format is:
217
+ # Required. The
218
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) on which
219
+ # to execute the request. The format is:
219
220
  #
220
221
  # projects/[PROJECT_ID_OR_NUMBER]
221
222
  # @param filter [::String]
@@ -302,7 +303,7 @@ module Google
302
303
  end
303
304
 
304
305
  ##
305
- # Gets a single monitored resource descriptor. This method does not require a Workspace.
306
+ # Gets a single monitored resource descriptor.
306
307
  #
307
308
  # @overload get_monitored_resource_descriptor(request, options = nil)
308
309
  # Pass arguments to `get_monitored_resource_descriptor` via a request object, either of type
@@ -392,7 +393,7 @@ module Google
392
393
  end
393
394
 
394
395
  ##
395
- # Lists metric descriptors that match a filter. This method does not require a Workspace.
396
+ # Lists metric descriptors that match a filter.
396
397
  #
397
398
  # @overload list_metric_descriptors(request, options = nil)
398
399
  # Pass arguments to `list_metric_descriptors` via a request object, either of type
@@ -410,8 +411,9 @@ module Google
410
411
  # the default parameter values, pass an empty Hash as a request object (see above).
411
412
  #
412
413
  # @param name [::String]
413
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
414
- # which to execute the request. The format is:
414
+ # Required. The
415
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) on which
416
+ # to execute the request. The format is:
415
417
  #
416
418
  # projects/[PROJECT_ID_OR_NUMBER]
417
419
  # @param filter [::String]
@@ -424,7 +426,9 @@ module Google
424
426
  #
425
427
  # metric.type = starts_with("custom.googleapis.com/")
426
428
  # @param page_size [::Integer]
427
- # A positive number that is the maximum number of results to return.
429
+ # A positive number that is the maximum number of results to return. The
430
+ # default and maximum value is 10,000. If a page_size <= 0 or > 10,000 is
431
+ # submitted, will instead return a maximum of 10,000 results.
428
432
  # @param page_token [::String]
429
433
  # If this field is not empty then it must contain the `nextPageToken` value
430
434
  # returned by a previous call to this method. Using this field causes the
@@ -500,7 +504,7 @@ module Google
500
504
  end
501
505
 
502
506
  ##
503
- # Gets a single metric descriptor. This method does not require a Workspace.
507
+ # Gets a single metric descriptor.
504
508
  #
505
509
  # @overload get_metric_descriptor(request, options = nil)
506
510
  # Pass arguments to `get_metric_descriptor` via a request object, either of type
@@ -518,7 +522,8 @@ module Google
518
522
  # the default parameter values, pass an empty Hash as a request object (see above).
519
523
  #
520
524
  # @param name [::String]
521
- # Required. The metric descriptor on which to execute the request. The format is:
525
+ # Required. The metric descriptor on which to execute the request. The format
526
+ # is:
522
527
  #
523
528
  # projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
524
529
  #
@@ -591,10 +596,11 @@ module Google
591
596
 
592
597
  ##
593
598
  # Creates a new metric descriptor.
594
- # The creation is executed asynchronously and callers may check the returned
595
- # operation to track its progress.
599
+ # The creation is executed asynchronously.
596
600
  # User-created metric descriptors define
597
601
  # [custom metrics](https://cloud.google.com/monitoring/custom-metrics).
602
+ # The metric descriptor is updated if it already exists,
603
+ # except that metric labels are never removed.
598
604
  #
599
605
  # @overload create_metric_descriptor(request, options = nil)
600
606
  # Pass arguments to `create_metric_descriptor` via a request object, either of type
@@ -612,13 +618,14 @@ module Google
612
618
  # the default parameter values, pass an empty Hash as a request object (see above).
613
619
  #
614
620
  # @param name [::String]
615
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
616
- # which to execute the request. The format is:
621
+ # Required. The
622
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) on which
623
+ # to execute the request. The format is:
617
624
  # 4
618
625
  # projects/[PROJECT_ID_OR_NUMBER]
619
626
  # @param metric_descriptor [::Google::Api::MetricDescriptor, ::Hash]
620
- # Required. The new [custom metric](https://cloud.google.com/monitoring/custom-metrics)
621
- # descriptor.
627
+ # Required. The new [custom
628
+ # metric](https://cloud.google.com/monitoring/custom-metrics) descriptor.
622
629
  #
623
630
  # @yield [response, operation] Access the result along with the RPC operation
624
631
  # @yieldparam response [::Google::Api::MetricDescriptor]
@@ -705,7 +712,8 @@ module Google
705
712
  # the default parameter values, pass an empty Hash as a request object (see above).
706
713
  #
707
714
  # @param name [::String]
708
- # Required. The metric descriptor on which to execute the request. The format is:
715
+ # Required. The metric descriptor on which to execute the request. The format
716
+ # is:
709
717
  #
710
718
  # projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
711
719
  #
@@ -777,7 +785,7 @@ module Google
777
785
  end
778
786
 
779
787
  ##
780
- # Lists time series that match a filter. This method does not require a Workspace.
788
+ # Lists time series that match a filter.
781
789
  #
782
790
  # @overload list_time_series(request, options = nil)
783
791
  # Pass arguments to `list_time_series` via a request object, either of type
@@ -795,24 +803,26 @@ module Google
795
803
  # the default parameter values, pass an empty Hash as a request object (see above).
796
804
  #
797
805
  # @param name [::String]
798
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name),
806
+ # Required. The
807
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name),
799
808
  # organization or folder on which to execute the request. The format is:
800
809
  #
801
810
  # projects/[PROJECT_ID_OR_NUMBER]
802
811
  # organizations/[ORGANIZATION_ID]
803
812
  # folders/[FOLDER_ID]
804
813
  # @param filter [::String]
805
- # Required. A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
806
- # that specifies which time series should be returned. The filter must
807
- # specify a single metric type, and can additionally specify metric labels
808
- # and other information. For example:
814
+ # Required. A [monitoring
815
+ # filter](https://cloud.google.com/monitoring/api/v3/filters) that specifies
816
+ # which time series should be returned. The filter must specify a single
817
+ # metric type, and can additionally specify metric labels and other
818
+ # information. For example:
809
819
  #
810
820
  # metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
811
821
  # metric.labels.instance_name = "my-instance-name"
812
822
  # @param interval [::Google::Cloud::Monitoring::V3::TimeInterval, ::Hash]
813
- # Required. The time interval for which results should be returned. Only time series
814
- # that contain data points in the specified interval are included
815
- # in the response.
823
+ # Required. The time interval for which results should be returned. Only time
824
+ # series that contain data points in the specified interval are included in
825
+ # the response.
816
826
  # @param aggregation [::Google::Cloud::Monitoring::V3::Aggregation, ::Hash]
817
827
  # Specifies the alignment of data points in individual time series as
818
828
  # well as how to combine the retrieved time series across specified labels.
@@ -912,6 +922,9 @@ module Google
912
922
  # The response is empty if all time series in the request were written.
913
923
  # If any time series could not be written, a corresponding failure message is
914
924
  # included in the error response.
925
+ # This method does not support
926
+ # [resource locations constraint of an organization
927
+ # policy](https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations#setting_the_organization_policy).
915
928
  #
916
929
  # @overload create_time_series(request, options = nil)
917
930
  # Pass arguments to `create_time_series` via a request object, either of type
@@ -929,8 +942,9 @@ module Google
929
942
  # the default parameter values, pass an empty Hash as a request object (see above).
930
943
  #
931
944
  # @param name [::String]
932
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
933
- # which to execute the request. The format is:
945
+ # Required. The
946
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) on which
947
+ # to execute the request. The format is:
934
948
  #
935
949
  # projects/[PROJECT_ID_OR_NUMBER]
936
950
  # @param time_series [::Array<::Google::Cloud::Monitoring::V3::TimeSeries, ::Hash>]
@@ -1033,8 +1047,9 @@ module Google
1033
1047
  # the default parameter values, pass an empty Hash as a request object (see above).
1034
1048
  #
1035
1049
  # @param name [::String]
1036
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
1037
- # which to execute the request. The format is:
1050
+ # Required. The
1051
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) on which
1052
+ # to execute the request. The format is:
1038
1053
  #
1039
1054
  # projects/[PROJECT_ID_OR_NUMBER]
1040
1055
  # @param time_series [::Array<::Google::Cloud::Monitoring::V3::TimeSeries, ::Hash>]
@@ -27,7 +27,7 @@ module Google
27
27
  ##
28
28
  # Client for the QueryService service.
29
29
  #
30
- # The QueryService API is used to manage time series data in Stackdriver
30
+ # The QueryService API is used to manage time series data in Cloud
31
31
  # Monitoring. Time series data is a collection of data points that describes
32
32
  # the time-varying values of a metric.
33
33
  #
@@ -161,7 +161,7 @@ module Google
161
161
  # Service calls
162
162
 
163
163
  ##
164
- # Queries time series using Monitoring Query Language. This method does not require a Workspace.
164
+ # Queries time series using Monitoring Query Language.
165
165
  #
166
166
  # @overload query_time_series(request, options = nil)
167
167
  # Pass arguments to `query_time_series` via a request object, either of type
@@ -179,8 +179,9 @@ module Google
179
179
  # the default parameter values, pass an empty Hash as a request object (see above).
180
180
  #
181
181
  # @param name [::String]
182
- # Required. The [project](https://cloud.google.com/monitoring/api/v3#project_name) on
183
- # which to execute the request. The format is:
182
+ # Required. The
183
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) on which
184
+ # to execute the request. The format is:
184
185
  #
185
186
  # projects/[PROJECT_ID_OR_NUMBER]
186
187
  # @param query [::String]
@@ -30,7 +30,7 @@ module Google
30
30
  module Monitoring
31
31
  module V3
32
32
  ##
33
- # The QueryService API is used to manage time series data in Stackdriver
33
+ # The QueryService API is used to manage time series data in Cloud
34
34
  # Monitoring. Time series data is a collection of data points that describes
35
35
  # the time-varying values of a metric.
36
36
  #
@@ -28,9 +28,9 @@ module Google
28
28
  # Client for the ServiceMonitoringService service.
29
29
  #
30
30
  # The Cloud Monitoring Service-Oriented Monitoring API has endpoints for
31
- # managing and querying aspects of a workspace's services. These include the
32
- # `Service`'s monitored resources, its Service-Level Objectives, and a taxonomy
33
- # of categorized Health Metrics.
31
+ # managing and querying aspects of a Metrics Scope's services. These include
32
+ # the `Service`'s monitored resources, its Service-Level Objectives, and a
33
+ # taxonomy of categorized Health Metrics.
34
34
  #
35
35
  class Client
36
36
  # @private
@@ -220,8 +220,9 @@ module Google
220
220
  # the default parameter values, pass an empty Hash as a request object (see above).
221
221
  #
222
222
  # @param parent [::String]
223
- # Required. Resource [name](https://cloud.google.com/monitoring/api/v3#project_name) of
224
- # the parent workspace. The format is:
223
+ # Required. Resource
224
+ # [name](https://cloud.google.com/monitoring/api/v3#project_name) of the
225
+ # parent Metrics Scope. The format is:
225
226
  #
226
227
  # projects/[PROJECT_ID_OR_NUMBER]
227
228
  # @param service_id [::String]
@@ -382,7 +383,7 @@ module Google
382
383
  end
383
384
 
384
385
  ##
385
- # List `Service`s for this workspace.
386
+ # List `Service`s for this Metrics Scope.
386
387
  #
387
388
  # @overload list_services(request, options = nil)
388
389
  # Pass arguments to `list_services` via a request object, either of type
@@ -400,32 +401,31 @@ module Google
400
401
  # the default parameter values, pass an empty Hash as a request object (see above).
401
402
  #
402
403
  # @param parent [::String]
403
- # Required. Resource name of the parent containing the listed services, either a
404
- # [project](https://cloud.google.com/monitoring/api/v3#project_name) or a
405
- # Monitoring Workspace. The formats are:
404
+ # Required. Resource name of the parent containing the listed services,
405
+ # either a [project](https://cloud.google.com/monitoring/api/v3#project_name)
406
+ # or a Monitoring Metrics Scope. The formats are:
406
407
  #
407
408
  # projects/[PROJECT_ID_OR_NUMBER]
408
409
  # workspaces/[HOST_PROJECT_ID_OR_NUMBER]
409
410
  # @param filter [::String]
410
- # A filter specifying what `Service`s to return. The filter currently
411
- # supports the following fields:
412
- #
413
- # - `identifier_case`
414
- # - `app_engine.module_id`
415
- # - `cloud_endpoints.service` (reserved for future use)
416
- # - `mesh_istio.mesh_uid`
417
- # - `mesh_istio.service_namespace`
418
- # - `mesh_istio.service_name`
419
- # - `cluster_istio.location` (deprecated)
420
- # - `cluster_istio.cluster_name` (deprecated)
421
- # - `cluster_istio.service_namespace` (deprecated)
422
- # - `cluster_istio.service_name` (deprecated)
423
- #
424
- # `identifier_case` refers to which option in the identifier oneof is
425
- # populated. For example, the filter `identifier_case = "CUSTOM"` would match
426
- # all services with a value for the `custom` field. Valid options are
427
- # "CUSTOM", "APP_ENGINE", "MESH_ISTIO", plus "CLUSTER_ISTIO" (deprecated)
428
- # and "CLOUD_ENDPOINTS" (reserved for future use).
411
+ # A filter specifying what `Service`s to return. The filter supports
412
+ # filtering on a particular service-identifier type or one of its attributes.
413
+ #
414
+ # To filter on a particular service-identifier type, the `identifier_case`
415
+ # refers to which option in the `identifier` field is populated. For example,
416
+ # the filter `identifier_case = "CUSTOM"` would match all services with a
417
+ # value for the `custom` field. Valid options include "CUSTOM", "APP_ENGINE",
418
+ # "MESH_ISTIO", and the other options listed at
419
+ # https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services#Service
420
+ #
421
+ # To filter on an attribute of a service-identifier type, apply the filter
422
+ # name by using the snake case of the service-identifier type and the
423
+ # attribute of that service-identifier type, and join the two with a period.
424
+ # For example, to filter by the `meshUid` field of the `MeshIstio`
425
+ # service-identifier type, you must filter on `mesh_istio.mesh_uid =
426
+ # "123"` to match all services with mesh UID "123". Service-identifier types
427
+ # and their attributes are described at
428
+ # https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services#Service
429
429
  # @param page_size [::Integer]
430
430
  # A non-negative number that is the maximum number of results to return.
431
431
  # When 0, use default page size.
@@ -703,7 +703,7 @@ module Google
703
703
  # @param service_level_objective_id [::String]
704
704
  # Optional. The ServiceLevelObjective id to use for this
705
705
  # ServiceLevelObjective. If omitted, an id will be generated instead. Must
706
- # match the pattern `[a-z0-9\-]+`
706
+ # match the pattern `^[a-zA-Z0-9-_:.]+$`
707
707
  # @param service_level_objective [::Google::Cloud::Monitoring::V3::ServiceLevelObjective, ::Hash]
708
708
  # Required. The `ServiceLevelObjective` to create.
709
709
  # The provided `name` will be respected if no `ServiceLevelObjective` exists
@@ -792,7 +792,8 @@ module Google
792
792
  # the default parameter values, pass an empty Hash as a request object (see above).
793
793
  #
794
794
  # @param name [::String]
795
- # Required. Resource name of the `ServiceLevelObjective` to get. The format is:
795
+ # Required. Resource name of the `ServiceLevelObjective` to get. The format
796
+ # is:
796
797
  #
797
798
  # projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME]
798
799
  # @param view [::Google::Cloud::Monitoring::V3::ServiceLevelObjective::View]
@@ -885,7 +886,7 @@ module Google
885
886
  #
886
887
  # @param parent [::String]
887
888
  # Required. Resource name of the parent containing the listed SLOs, either a
888
- # project or a Monitoring Workspace. The formats are:
889
+ # project or a Monitoring Metrics Scope. The formats are:
889
890
  #
890
891
  # projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]
891
892
  # workspaces/[HOST_PROJECT_ID_OR_NUMBER]/services/-
@@ -1080,7 +1081,8 @@ module Google
1080
1081
  # the default parameter values, pass an empty Hash as a request object (see above).
1081
1082
  #
1082
1083
  # @param name [::String]
1083
- # Required. Resource name of the `ServiceLevelObjective` to delete. The format is:
1084
+ # Required. Resource name of the `ServiceLevelObjective` to delete. The
1085
+ # format is:
1084
1086
  #
1085
1087
  # projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME]
1086
1088
  #
@@ -32,9 +32,9 @@ module Google
32
32
  module V3
33
33
  ##
34
34
  # The Cloud Monitoring Service-Oriented Monitoring API has endpoints for
35
- # managing and querying aspects of a workspace's services. These include the
36
- # `Service`'s monitored resources, its Service-Level Objectives, and a taxonomy
37
- # of categorized Health Metrics.
35
+ # managing and querying aspects of a Metrics Scope's services. These include
36
+ # the `Service`'s monitored resources, its Service-Level Objectives, and a
37
+ # taxonomy of categorized Health Metrics.
38
38
  #
39
39
  # @example Load this service and instantiate a gRPC client
40
40
  #
@@ -38,6 +38,25 @@ module Google
38
38
  "folders/#{folder}"
39
39
  end
40
40
 
41
+ ##
42
+ # Create a fully-qualified Function resource string.
43
+ #
44
+ # The resource will be in the following format:
45
+ #
46
+ # `projects/{project}/locations/{location}/functions/{function}`
47
+ #
48
+ # @param project [String]
49
+ # @param location [String]
50
+ # @param function [String]
51
+ #
52
+ # @return [::String]
53
+ def function_path project:, location:, function:
54
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
55
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
56
+
57
+ "projects/#{project}/locations/#{location}/functions/#{function}"
58
+ end
59
+
41
60
  ##
42
61
  # Create a fully-qualified Organization resource string.
43
62
  #
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Monitoring
23
23
  module V3
24
- VERSION = "0.16.0"
24
+ VERSION = "0.17.0"
25
25
  end
26
26
  end
27
27
  end
@@ -9,7 +9,7 @@ require 'google/protobuf/duration_pb'
9
9
  require 'google/protobuf/timestamp_pb'
10
10
 
11
11
 
12
- descriptor_data = "\n!google/monitoring/v3/common.proto\x12\x14google.monitoring.v3\x1a\x1dgoogle/api/distribution.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xaa\x01\n\nTypedValue\x12\x14\n\nbool_value\x18\x01 \x01(\x08H\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x04 \x01(\tH\x00\x12\x36\n\x12\x64istribution_value\x18\x05 \x01(\x0b\x32\x18.google.api.DistributionH\x00\x42\x07\n\x05value\"l\n\x0cTimeInterval\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xad\x07\n\x0b\x41ggregation\x12\x33\n\x10\x61lignment_period\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x45\n\x12per_series_aligner\x18\x02 \x01(\x0e\x32).google.monitoring.v3.Aggregation.Aligner\x12G\n\x14\x63ross_series_reducer\x18\x04 \x01(\x0e\x32).google.monitoring.v3.Aggregation.Reducer\x12\x17\n\x0fgroup_by_fields\x18\x05 \x03(\t\"\x8b\x03\n\x07\x41ligner\x12\x0e\n\nALIGN_NONE\x10\x00\x12\x0f\n\x0b\x41LIGN_DELTA\x10\x01\x12\x0e\n\nALIGN_RATE\x10\x02\x12\x15\n\x11\x41LIGN_INTERPOLATE\x10\x03\x12\x14\n\x10\x41LIGN_NEXT_OLDER\x10\x04\x12\r\n\tALIGN_MIN\x10\n\x12\r\n\tALIGN_MAX\x10\x0b\x12\x0e\n\nALIGN_MEAN\x10\x0c\x12\x0f\n\x0b\x41LIGN_COUNT\x10\r\x12\r\n\tALIGN_SUM\x10\x0e\x12\x10\n\x0c\x41LIGN_STDDEV\x10\x0f\x12\x14\n\x10\x41LIGN_COUNT_TRUE\x10\x10\x12\x15\n\x11\x41LIGN_COUNT_FALSE\x10\x18\x12\x17\n\x13\x41LIGN_FRACTION_TRUE\x10\x11\x12\x17\n\x13\x41LIGN_PERCENTILE_99\x10\x12\x12\x17\n\x13\x41LIGN_PERCENTILE_95\x10\x13\x12\x17\n\x13\x41LIGN_PERCENTILE_50\x10\x14\x12\x17\n\x13\x41LIGN_PERCENTILE_05\x10\x15\x12\x18\n\x14\x41LIGN_PERCENT_CHANGE\x10\x17\"\xb1\x02\n\x07Reducer\x12\x0f\n\x0bREDUCE_NONE\x10\x00\x12\x0f\n\x0bREDUCE_MEAN\x10\x01\x12\x0e\n\nREDUCE_MIN\x10\x02\x12\x0e\n\nREDUCE_MAX\x10\x03\x12\x0e\n\nREDUCE_SUM\x10\x04\x12\x11\n\rREDUCE_STDDEV\x10\x05\x12\x10\n\x0cREDUCE_COUNT\x10\x06\x12\x15\n\x11REDUCE_COUNT_TRUE\x10\x07\x12\x16\n\x12REDUCE_COUNT_FALSE\x10\x0f\x12\x18\n\x14REDUCE_FRACTION_TRUE\x10\x08\x12\x18\n\x14REDUCE_PERCENTILE_99\x10\t\x12\x18\n\x14REDUCE_PERCENTILE_95\x10\n\x12\x18\n\x14REDUCE_PERCENTILE_50\x10\x0b\x12\x18\n\x14REDUCE_PERCENTILE_05\x10\x0c*\x9e\x01\n\x0e\x43omparisonType\x12\x1a\n\x16\x43OMPARISON_UNSPECIFIED\x10\x00\x12\x11\n\rCOMPARISON_GT\x10\x01\x12\x11\n\rCOMPARISON_GE\x10\x02\x12\x11\n\rCOMPARISON_LT\x10\x03\x12\x11\n\rCOMPARISON_LE\x10\x04\x12\x11\n\rCOMPARISON_EQ\x10\x05\x12\x11\n\rCOMPARISON_NE\x10\x06*a\n\x0bServiceTier\x12\x1c\n\x18SERVICE_TIER_UNSPECIFIED\x10\x00\x12\x16\n\x12SERVICE_TIER_BASIC\x10\x01\x12\x18\n\x14SERVICE_TIER_PREMIUM\x10\x02\x1a\x02\x18\x01\x42\xc6\x01\n\x18\x63om.google.monitoring.v3B\x0b\x43ommonProtoP\x01ZAcloud.google.com/go/monitoring/apiv3/v2/monitoringpb;monitoringpb\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3\xea\x02\x1dGoogle::Cloud::Monitoring::V3b\x06proto3"
12
+ descriptor_data = "\n!google/monitoring/v3/common.proto\x12\x14google.monitoring.v3\x1a\x1dgoogle/api/distribution.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xaa\x01\n\nTypedValue\x12\x14\n\nbool_value\x18\x01 \x01(\x08H\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x04 \x01(\tH\x00\x12\x36\n\x12\x64istribution_value\x18\x05 \x01(\x0b\x32\x18.google.api.DistributionH\x00\x42\x07\n\x05value\"l\n\x0cTimeInterval\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xad\x07\n\x0b\x41ggregation\x12\x33\n\x10\x61lignment_period\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x45\n\x12per_series_aligner\x18\x02 \x01(\x0e\x32).google.monitoring.v3.Aggregation.Aligner\x12G\n\x14\x63ross_series_reducer\x18\x04 \x01(\x0e\x32).google.monitoring.v3.Aggregation.Reducer\x12\x17\n\x0fgroup_by_fields\x18\x05 \x03(\t\"\x8b\x03\n\x07\x41ligner\x12\x0e\n\nALIGN_NONE\x10\x00\x12\x0f\n\x0b\x41LIGN_DELTA\x10\x01\x12\x0e\n\nALIGN_RATE\x10\x02\x12\x15\n\x11\x41LIGN_INTERPOLATE\x10\x03\x12\x14\n\x10\x41LIGN_NEXT_OLDER\x10\x04\x12\r\n\tALIGN_MIN\x10\n\x12\r\n\tALIGN_MAX\x10\x0b\x12\x0e\n\nALIGN_MEAN\x10\x0c\x12\x0f\n\x0b\x41LIGN_COUNT\x10\r\x12\r\n\tALIGN_SUM\x10\x0e\x12\x10\n\x0c\x41LIGN_STDDEV\x10\x0f\x12\x14\n\x10\x41LIGN_COUNT_TRUE\x10\x10\x12\x15\n\x11\x41LIGN_COUNT_FALSE\x10\x18\x12\x17\n\x13\x41LIGN_FRACTION_TRUE\x10\x11\x12\x17\n\x13\x41LIGN_PERCENTILE_99\x10\x12\x12\x17\n\x13\x41LIGN_PERCENTILE_95\x10\x13\x12\x17\n\x13\x41LIGN_PERCENTILE_50\x10\x14\x12\x17\n\x13\x41LIGN_PERCENTILE_05\x10\x15\x12\x18\n\x14\x41LIGN_PERCENT_CHANGE\x10\x17\"\xb1\x02\n\x07Reducer\x12\x0f\n\x0bREDUCE_NONE\x10\x00\x12\x0f\n\x0bREDUCE_MEAN\x10\x01\x12\x0e\n\nREDUCE_MIN\x10\x02\x12\x0e\n\nREDUCE_MAX\x10\x03\x12\x0e\n\nREDUCE_SUM\x10\x04\x12\x11\n\rREDUCE_STDDEV\x10\x05\x12\x10\n\x0cREDUCE_COUNT\x10\x06\x12\x15\n\x11REDUCE_COUNT_TRUE\x10\x07\x12\x16\n\x12REDUCE_COUNT_FALSE\x10\x0f\x12\x18\n\x14REDUCE_FRACTION_TRUE\x10\x08\x12\x18\n\x14REDUCE_PERCENTILE_99\x10\t\x12\x18\n\x14REDUCE_PERCENTILE_95\x10\n\x12\x18\n\x14REDUCE_PERCENTILE_50\x10\x0b\x12\x18\n\x14REDUCE_PERCENTILE_05\x10\x0c*\x9e\x01\n\x0e\x43omparisonType\x12\x1a\n\x16\x43OMPARISON_UNSPECIFIED\x10\x00\x12\x11\n\rCOMPARISON_GT\x10\x01\x12\x11\n\rCOMPARISON_GE\x10\x02\x12\x11\n\rCOMPARISON_LT\x10\x03\x12\x11\n\rCOMPARISON_LE\x10\x04\x12\x11\n\rCOMPARISON_EQ\x10\x05\x12\x11\n\rCOMPARISON_NE\x10\x06*a\n\x0bServiceTier\x12\x1c\n\x18SERVICE_TIER_UNSPECIFIED\x10\x00\x12\x16\n\x12SERVICE_TIER_BASIC\x10\x01\x12\x18\n\x14SERVICE_TIER_PREMIUM\x10\x02\x1a\x02\x18\x01\x42\xcd\x01\n\x18\x63om.google.monitoring.v3B\x0b\x43ommonProtoP\x01ZAcloud.google.com/go/monitoring/apiv3/v2/monitoringpb;monitoringpb\xa2\x02\x04GMON\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3\xea\x02\x1dGoogle::Cloud::Monitoring::V3b\x06proto3"
13
13
 
14
14
  pool = Google::Protobuf::DescriptorPool.generated_pool
15
15
 
@@ -34,30 +34,34 @@ module Google
34
34
  self.unmarshal_class_method = :decode
35
35
  self.service_name = 'google.monitoring.v3.MetricService'
36
36
 
37
- # Lists monitored resource descriptors that match a filter. This method does not require a Workspace.
37
+ # Lists monitored resource descriptors that match a filter.
38
38
  rpc :ListMonitoredResourceDescriptors, ::Google::Cloud::Monitoring::V3::ListMonitoredResourceDescriptorsRequest, ::Google::Cloud::Monitoring::V3::ListMonitoredResourceDescriptorsResponse
39
- # Gets a single monitored resource descriptor. This method does not require a Workspace.
39
+ # Gets a single monitored resource descriptor.
40
40
  rpc :GetMonitoredResourceDescriptor, ::Google::Cloud::Monitoring::V3::GetMonitoredResourceDescriptorRequest, ::Google::Api::MonitoredResourceDescriptor
41
- # Lists metric descriptors that match a filter. This method does not require a Workspace.
41
+ # Lists metric descriptors that match a filter.
42
42
  rpc :ListMetricDescriptors, ::Google::Cloud::Monitoring::V3::ListMetricDescriptorsRequest, ::Google::Cloud::Monitoring::V3::ListMetricDescriptorsResponse
43
- # Gets a single metric descriptor. This method does not require a Workspace.
43
+ # Gets a single metric descriptor.
44
44
  rpc :GetMetricDescriptor, ::Google::Cloud::Monitoring::V3::GetMetricDescriptorRequest, ::Google::Api::MetricDescriptor
45
45
  # Creates a new metric descriptor.
46
- # The creation is executed asynchronously and callers may check the returned
47
- # operation to track its progress.
46
+ # The creation is executed asynchronously.
48
47
  # User-created metric descriptors define
49
48
  # [custom metrics](https://cloud.google.com/monitoring/custom-metrics).
49
+ # The metric descriptor is updated if it already exists,
50
+ # except that metric labels are never removed.
50
51
  rpc :CreateMetricDescriptor, ::Google::Cloud::Monitoring::V3::CreateMetricDescriptorRequest, ::Google::Api::MetricDescriptor
51
52
  # Deletes a metric descriptor. Only user-created
52
53
  # [custom metrics](https://cloud.google.com/monitoring/custom-metrics) can be
53
54
  # deleted.
54
55
  rpc :DeleteMetricDescriptor, ::Google::Cloud::Monitoring::V3::DeleteMetricDescriptorRequest, ::Google::Protobuf::Empty
55
- # Lists time series that match a filter. This method does not require a Workspace.
56
+ # Lists time series that match a filter.
56
57
  rpc :ListTimeSeries, ::Google::Cloud::Monitoring::V3::ListTimeSeriesRequest, ::Google::Cloud::Monitoring::V3::ListTimeSeriesResponse
57
58
  # Creates or adds data to one or more time series.
58
59
  # The response is empty if all time series in the request were written.
59
60
  # If any time series could not be written, a corresponding failure message is
60
61
  # included in the error response.
62
+ # This method does not support
63
+ # [resource locations constraint of an organization
64
+ # policy](https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations#setting_the_organization_policy).
61
65
  rpc :CreateTimeSeries, ::Google::Cloud::Monitoring::V3::CreateTimeSeriesRequest, ::Google::Protobuf::Empty
62
66
  # Creates or adds data to one or more service time series. A service time
63
67
  # series is a time series for a metric from a Google Cloud service. The
@@ -5,11 +5,11 @@
5
5
  require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
- require 'google/monitoring/v3/metric_service_pb'
9
8
  require 'google/api/client_pb'
9
+ require 'google/monitoring/v3/metric_service_pb'
10
10
 
11
11
 
12
- descriptor_data = "\n(google/monitoring/v3/query_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a)google/monitoring/v3/metric_service.proto\x1a\x17google/api/client.proto2\xde\x02\n\x0cQueryService\x12\xa1\x01\n\x0fQueryTimeSeries\x12,.google.monitoring.v3.QueryTimeSeriesRequest\x1a-.google.monitoring.v3.QueryTimeSeriesResponse\"1\x82\xd3\xe4\x93\x02+\"&/v3/{name=projects/*}/timeSeries:query:\x01*\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xcc\x01\n\x18\x63om.google.monitoring.v3B\x11QueryServiceProtoP\x01ZAcloud.google.com/go/monitoring/apiv3/v2/monitoringpb;monitoringpb\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3\xea\x02\x1dGoogle::Cloud::Monitoring::V3b\x06proto3"
12
+ descriptor_data = "\n(google/monitoring/v3/query_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a)google/monitoring/v3/metric_service.proto2\xde\x02\n\x0cQueryService\x12\xa1\x01\n\x0fQueryTimeSeries\x12,.google.monitoring.v3.QueryTimeSeriesRequest\x1a-.google.monitoring.v3.QueryTimeSeriesResponse\"1\x82\xd3\xe4\x93\x02+\"&/v3/{name=projects/*}/timeSeries:query:\x01*\x1a\xa9\x01\xca\x41\x19monitoring.googleapis.com\xd2\x41\x89\x01https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/monitoring,https://www.googleapis.com/auth/monitoring.readB\xcc\x01\n\x18\x63om.google.monitoring.v3B\x11QueryServiceProtoP\x01ZAcloud.google.com/go/monitoring/apiv3/v2/monitoringpb;monitoringpb\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3\xea\x02\x1dGoogle::Cloud::Monitoring::V3b\x06proto3"
13
13
 
14
14
  pool = Google::Protobuf::DescriptorPool.generated_pool
15
15
 
@@ -24,7 +24,7 @@ module Google
24
24
  module Monitoring
25
25
  module V3
26
26
  module QueryService
27
- # The QueryService API is used to manage time series data in Stackdriver
27
+ # The QueryService API is used to manage time series data in Cloud
28
28
  # Monitoring. Time series data is a collection of data points that describes
29
29
  # the time-varying values of a metric.
30
30
  class Service
@@ -35,7 +35,7 @@ module Google
35
35
  self.unmarshal_class_method = :decode
36
36
  self.service_name = 'google.monitoring.v3.QueryService'
37
37
 
38
- # Queries time series using Monitoring Query Language. This method does not require a Workspace.
38
+ # Queries time series using Monitoring Query Language.
39
39
  rpc :QueryTimeSeries, ::Google::Cloud::Monitoring::V3::QueryTimeSeriesRequest, ::Google::Cloud::Monitoring::V3::QueryTimeSeriesResponse
40
40
  end
41
41