google-cloud-monitoring-v3 0.16.0 → 0.17.0

Sign up to get free protection for your applications and to get access to all the features.
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