google-cloud-monitoring-v3 0.13.0 → 0.15.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e93ace3a69cf86463bd42891d1c16ff7a3828e08140482bf8b5143729fde2501
4
- data.tar.gz: aac1af08674eb3aaf34b9bc538e0d0deec8c283a4999ee22a384efe80a7a4c3d
3
+ metadata.gz: a1b95ff81ddc44cb7c6ed0aeb33556278c76fc98b7c0c9d49c739cf068a9e4e4
4
+ data.tar.gz: 40c6ae87e79016a1c5f098a0eb478173e58d5996ff4199097eabae4cbb18812a
5
5
  SHA512:
6
- metadata.gz: 21df0ac548ae3d163de6aa0e057e6e3b8b494e6f607979378121a7ced6ba78f8fcb9ba5d0a4b14c295f3dd733cac71dfc8749d8c3fed3ca541c27cde71cf73b6
7
- data.tar.gz: cc33a58bf797c962793d655a52735f6575d5367d1c8ead429061bf1a24d2b44065110c70b2410236a475b2995504fbffe869e8990433502591d6dd68bf768ff0
6
+ metadata.gz: 01e4d01f3cd5736b22c7515ec47c6c668237dd71b66a6b8a1eb7889e6bafd59c7432853fdb8011d29afdb18e300e09bc69794cbbcf4002da75cdd25410dd43d3
7
+ data.tar.gz: d8738ab583e8d791d06b7f6c88940d81827ee785d9a2387f6b931202ac30f039d75be066f30987041bad63ee339a69c951e5e9e787aa106ed113cf81280de7d9
data/AUTHENTICATION.md CHANGED
@@ -1,151 +1,122 @@
1
1
  # Authentication
2
2
 
3
- In general, the google-cloud-monitoring-v3 library uses
4
- [Service Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
5
- credentials to connect to Google Cloud services. When running within
6
- [Google Cloud Platform environments](#google-cloud-platform-environments) the
7
- credentials will be discovered automatically. When running on other
8
- environments, the Service Account credentials can be specified by providing the
9
- path to the
10
- [JSON keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys)
11
- for the account (or the JSON itself) in
12
- [environment variables](#environment-variables). Additionally, Cloud SDK
13
- credentials can also be discovered automatically, but this is only recommended
14
- during development.
3
+ The recommended way to authenticate to the google-cloud-monitoring-v3 library is to use
4
+ [Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).
5
+ To review all of your authentication options, see [Credentials lookup](#credential-lookup).
15
6
 
16
7
  ## Quickstart
17
8
 
18
- 1. [Create a service account and credentials](#creating-a-service-account).
19
- 2. Set the [environment variable](#environment-variables).
9
+ The following example shows how to set up authentication for a local development
10
+ environment with your user credentials.
20
11
 
21
- ```sh
22
- export MONITORING_CREDENTIALS=path/to/keyfile.json
23
- ```
24
-
25
- 3. Initialize the client.
12
+ **NOTE:** This method is _not_ recommended for running in production. User credentials
13
+ should be used only during development.
26
14
 
27
- ```ruby
28
- require "google/cloud/monitoring/v3"
15
+ 1. [Download and install the Google Cloud CLI](https://cloud.google.com/sdk).
16
+ 2. Set up a local ADC file with your user credentials:
29
17
 
30
- client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
18
+ ```sh
19
+ gcloud auth application-default login
31
20
  ```
32
21
 
33
- ## Credential Lookup
34
-
35
- The google-cloud-monitoring-v3 library aims to make authentication
36
- as simple as possible, and provides several mechanisms to configure your system
37
- without requiring **Service Account Credentials** directly in code.
38
-
39
- **Credentials** are discovered in the following order:
40
-
41
- 1. Specify credentials in method arguments
42
- 2. Specify credentials in configuration
43
- 3. Discover credentials path in environment variables
44
- 4. Discover credentials JSON in environment variables
45
- 5. Discover credentials file in the Cloud SDK's path
46
- 6. Discover GCP credentials
47
-
48
- ### Google Cloud Platform environments
22
+ 3. Write code as if already authenticated.
49
23
 
50
- When running on Google Cloud Platform (GCP), including Google Compute Engine
51
- (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
52
- Functions (GCF) and Cloud Run, **Credentials** are discovered automatically.
53
- Code should be written as if already authenticated.
24
+ For more information about setting up authentication for a local development environment, see
25
+ [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-dev).
54
26
 
55
- ### Environment Variables
27
+ ## Credential Lookup
56
28
 
57
- The **Credentials JSON** can be placed in environment variables instead of
58
- declaring them directly in code. Each service has its own environment variable,
59
- allowing for different service accounts to be used for different services. (See
60
- the READMEs for the individual service gems for details.) The path to the
61
- **Credentials JSON** file can be stored in the environment variable, or the
62
- **Credentials JSON** itself can be stored for environments such as Docker
63
- containers where writing files is difficult or not encouraged.
29
+ The google-cloud-monitoring-v3 library provides several mechanisms to configure your system.
30
+ Generally, using Application Default Credentials to facilitate automatic
31
+ credentials discovery is the easist method. But if you need to explicitly specify
32
+ credentials, there are several methods available to you.
64
33
 
65
- The environment variables that google-cloud-monitoring-v3
66
- checks for credentials are configured on the service Credentials class (such as
67
- {::Google::Cloud::Monitoring::V3::AlertPolicyService::Credentials}):
34
+ Credentials are accepted in the following ways, in the following order or precedence:
68
35
 
69
- * `MONITORING_CREDENTIALS` - Path to JSON file, or JSON contents
70
- * `MONITORING_KEYFILE` - Path to JSON file, or JSON contents
71
- * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
36
+ 1. Credentials specified in method arguments
37
+ 2. Credentials specified in configuration
38
+ 3. Credentials pointed to or included in environment variables
39
+ 4. Credentials found in local ADC file
40
+ 5. Credentials returned by the metadata server for the attached service account (GCP)
74
41
 
75
- ```ruby
76
- require "google/cloud/monitoring/v3"
77
-
78
- ENV["MONITORING_CREDENTIALS"] = "path/to/keyfile.json"
42
+ ### Configuration
79
43
 
80
- client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
81
- ```
44
+ You can configure a path to a JSON credentials file, either for an individual client object or
45
+ globally, for all client objects. The JSON file can contain credentials created for
46
+ [workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
47
+ [workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
48
+ [service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
82
49
 
83
- ### Configuration
50
+ Note: Service account keys are a security risk if not managed correctly. You should
51
+ [choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
52
+ whenever possible.
84
53
 
85
- The path to the **Credentials JSON** file can be configured instead of storing
86
- it in an environment variable. Either on an individual client initialization:
54
+ To configure a credentials file for an individual client initialization:
87
55
 
88
56
  ```ruby
89
57
  require "google/cloud/monitoring/v3"
90
58
 
91
59
  client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new do |config|
92
- config.credentials = "path/to/keyfile.json"
60
+ config.credentials = "path/to/credentialfile.json"
93
61
  end
94
62
  ```
95
63
 
96
- Or globally for all clients:
64
+ To configure a credentials file globally for all clients:
97
65
 
98
66
  ```ruby
99
67
  require "google/cloud/monitoring/v3"
100
68
 
101
69
  ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.configure do |config|
102
- config.credentials = "path/to/keyfile.json"
70
+ config.credentials = "path/to/credentialfile.json"
103
71
  end
104
72
 
105
73
  client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
106
74
  ```
107
75
 
108
- ### Cloud SDK
76
+ ### Environment Variables
109
77
 
110
- This option allows for an easy way to authenticate during development. If
111
- credentials are not provided in code or in environment variables, then Cloud SDK
112
- credentials are discovered.
78
+ You can also use an environment variable to provide a JSON credentials file.
79
+ The environment variable can contain a path to the credentials file or, for
80
+ environments such as Docker containers where writing files is not encouraged,
81
+ you can include the credentials file itself.
113
82
 
114
- To configure your system for this, simply:
83
+ The JSON file can contain credentials created for
84
+ [workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
85
+ [workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
86
+ [service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
115
87
 
116
- 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
- 3. Write code as if already authenticated.
88
+ Note: Service account keys are a security risk if not managed correctly. You should
89
+ [choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
90
+ whenever possible.
91
+
92
+ The environment variables that google-cloud-monitoring-v3
93
+ checks for credentials are:
119
94
 
120
- **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
- *should* only be used during development.
95
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
96
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
122
97
 
123
- ## Creating a Service Account
98
+ ```ruby
99
+ require "google/cloud/monitoring/v3"
124
100
 
125
- Google Cloud requires **Service Account Credentials** to
126
- connect to the APIs. You will use the **JSON key file** to
127
- connect to most services with google-cloud-monitoring-v3.
101
+ ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
128
102
 
129
- If you are not running this client within
130
- [Google Cloud Platform environments](#google-cloud-platform-environments), you
131
- need a Google Developers service account.
103
+ client = ::Google::Cloud::Monitoring::V3::AlertPolicyService::Client.new
104
+ ```
132
105
 
133
- 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
134
- 2. Create a new project or click on an existing project.
135
- 3. Activate the menu in the upper left and select **APIs & Services**. From
136
- here, you will enable the APIs that your application requires.
106
+ ### Local ADC file
137
107
 
138
- *Note: You may need to enable billing in order to use these services.*
108
+ You can set up a local ADC file with your user credentials for authentication during
109
+ development. If credentials are not provided in code or in environment variables,
110
+ then the local ADC credentials are discovered.
139
111
 
140
- 4. Select **Credentials** from the side navigation.
112
+ Follow the steps in [Quickstart](#quickstart) to set up a local ADC file.
141
113
 
142
- Find the "Create credentials" drop down near the top of the page, and select
143
- "Service account" to be guided through downloading a new JSON key file.
114
+ ### Google Cloud Platform environments
144
115
 
145
- If you want to re-use an existing service account, you can easily generate a
146
- new key file. Just select the account you wish to re-use, click the pencil
147
- tool on the right side to edit the service account, select the **Keys** tab,
148
- and then select **Add Key**.
116
+ When running on Google Cloud Platform (GCP), including Google Compute Engine
117
+ (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
118
+ Functions (GCF) and Cloud Run, credentials are retrieved from the attached
119
+ service account automatically. Code should be written as if already authenticated.
149
120
 
150
- The key file you download will be used by this library to authenticate API
151
- requests and should be stored in a secure location.
121
+ For more information, see
122
+ [Set up ADC for Google Cloud services](https://cloud.google.com/docs/authentication/provide-credentials-adc#attached-sa).
@@ -38,6 +38,9 @@ module Google
38
38
  # [Cloud console](https://console.cloud.google.com/).
39
39
  #
40
40
  class Client
41
+ # @private
42
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
43
+
41
44
  include Paths
42
45
 
43
46
  # @private
@@ -117,6 +120,15 @@ module Google
117
120
  @config
118
121
  end
119
122
 
123
+ ##
124
+ # The effective universe domain
125
+ #
126
+ # @return [String]
127
+ #
128
+ def universe_domain
129
+ @alert_policy_service_stub.universe_domain
130
+ end
131
+
120
132
  ##
121
133
  # Create a new AlertPolicyService client object.
122
134
  #
@@ -150,8 +162,9 @@ module Google
150
162
  credentials = @config.credentials
151
163
  # Use self-signed JWT if the endpoint is unchanged from default,
152
164
  # but only if the default endpoint does not have a region prefix.
153
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
154
- !@config.endpoint.split(".").first.include?("-")
165
+ enable_self_signed_jwt = @config.endpoint.nil? ||
166
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
167
+ !@config.endpoint.split(".").first.include?("-"))
155
168
  credentials ||= Credentials.default scope: @config.scope,
156
169
  enable_self_signed_jwt: enable_self_signed_jwt
157
170
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -162,8 +175,10 @@ module Google
162
175
 
163
176
  @alert_policy_service_stub = ::Gapic::ServiceStub.new(
164
177
  ::Google::Cloud::Monitoring::V3::AlertPolicyService::Stub,
165
- credentials: credentials,
166
- endpoint: @config.endpoint,
178
+ credentials: credentials,
179
+ endpoint: @config.endpoint,
180
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
181
+ universe_domain: @config.universe_domain,
167
182
  channel_args: @config.channel_args,
168
183
  interceptors: @config.interceptors,
169
184
  channel_pool_config: @config.channel_pool
@@ -723,9 +738,9 @@ module Google
723
738
  # end
724
739
  #
725
740
  # @!attribute [rw] endpoint
726
- # The hostname or hostname:port of the service endpoint.
727
- # Defaults to `"monitoring.googleapis.com"`.
728
- # @return [::String]
741
+ # A custom service endpoint, as a hostname or hostname:port. The default is
742
+ # nil, indicating to use the default endpoint in the current universe domain.
743
+ # @return [::String,nil]
729
744
  # @!attribute [rw] credentials
730
745
  # Credentials to send with calls. You may provide any of the following types:
731
746
  # * (`String`) The path to a service account key file in JSON format
@@ -771,13 +786,20 @@ module Google
771
786
  # @!attribute [rw] quota_project
772
787
  # A separate project against which to charge quota.
773
788
  # @return [::String]
789
+ # @!attribute [rw] universe_domain
790
+ # The universe domain within which to make requests. This determines the
791
+ # default endpoint URL. The default value of nil uses the environment
792
+ # universe (usually the default "googleapis.com" universe).
793
+ # @return [::String,nil]
774
794
  #
775
795
  class Configuration
776
796
  extend ::Gapic::Config
777
797
 
798
+ # @private
799
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
778
800
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
779
801
 
780
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
802
+ config_attr :endpoint, nil, ::String, nil
781
803
  config_attr :credentials, nil do |value|
782
804
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
783
805
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -792,6 +814,7 @@ module Google
792
814
  config_attr :metadata, nil, ::Hash, nil
793
815
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
794
816
  config_attr :quota_project, nil, ::String, nil
817
+ config_attr :universe_domain, nil, ::String, nil
795
818
 
796
819
  # @private
797
820
  def initialize parent_config = nil
@@ -41,6 +41,9 @@ module Google
41
41
  # from the infrastructure.
42
42
  #
43
43
  class Client
44
+ # @private
45
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
46
+
44
47
  include Paths
45
48
 
46
49
  # @private
@@ -128,6 +131,15 @@ module Google
128
131
  @config
129
132
  end
130
133
 
134
+ ##
135
+ # The effective universe domain
136
+ #
137
+ # @return [String]
138
+ #
139
+ def universe_domain
140
+ @group_service_stub.universe_domain
141
+ end
142
+
131
143
  ##
132
144
  # Create a new GroupService client object.
133
145
  #
@@ -161,8 +173,9 @@ module Google
161
173
  credentials = @config.credentials
162
174
  # Use self-signed JWT if the endpoint is unchanged from default,
163
175
  # but only if the default endpoint does not have a region prefix.
164
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
165
- !@config.endpoint.split(".").first.include?("-")
176
+ enable_self_signed_jwt = @config.endpoint.nil? ||
177
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
178
+ !@config.endpoint.split(".").first.include?("-"))
166
179
  credentials ||= Credentials.default scope: @config.scope,
167
180
  enable_self_signed_jwt: enable_self_signed_jwt
168
181
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -173,8 +186,10 @@ module Google
173
186
 
174
187
  @group_service_stub = ::Gapic::ServiceStub.new(
175
188
  ::Google::Cloud::Monitoring::V3::GroupService::Stub,
176
- credentials: credentials,
177
- endpoint: @config.endpoint,
189
+ credentials: credentials,
190
+ endpoint: @config.endpoint,
191
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
192
+ universe_domain: @config.universe_domain,
178
193
  channel_args: @config.channel_args,
179
194
  interceptors: @config.interceptors,
180
195
  channel_pool_config: @config.channel_pool
@@ -808,9 +823,9 @@ module Google
808
823
  # end
809
824
  #
810
825
  # @!attribute [rw] endpoint
811
- # The hostname or hostname:port of the service endpoint.
812
- # Defaults to `"monitoring.googleapis.com"`.
813
- # @return [::String]
826
+ # A custom service endpoint, as a hostname or hostname:port. The default is
827
+ # nil, indicating to use the default endpoint in the current universe domain.
828
+ # @return [::String,nil]
814
829
  # @!attribute [rw] credentials
815
830
  # Credentials to send with calls. You may provide any of the following types:
816
831
  # * (`String`) The path to a service account key file in JSON format
@@ -856,13 +871,20 @@ module Google
856
871
  # @!attribute [rw] quota_project
857
872
  # A separate project against which to charge quota.
858
873
  # @return [::String]
874
+ # @!attribute [rw] universe_domain
875
+ # The universe domain within which to make requests. This determines the
876
+ # default endpoint URL. The default value of nil uses the environment
877
+ # universe (usually the default "googleapis.com" universe).
878
+ # @return [::String,nil]
859
879
  #
860
880
  class Configuration
861
881
  extend ::Gapic::Config
862
882
 
883
+ # @private
884
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
863
885
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
864
886
 
865
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
887
+ config_attr :endpoint, nil, ::String, nil
866
888
  config_attr :credentials, nil do |value|
867
889
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
868
890
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -877,6 +899,7 @@ module Google
877
899
  config_attr :metadata, nil, ::Hash, nil
878
900
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
879
901
  config_attr :quota_project, nil, ::String, nil
902
+ config_attr :universe_domain, nil, ::String, nil
880
903
 
881
904
  # @private
882
905
  def initialize parent_config = nil
@@ -31,6 +31,9 @@ module Google
31
31
  # time series data.
32
32
  #
33
33
  class Client
34
+ # @private
35
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
36
+
34
37
  include Paths
35
38
 
36
39
  # @private
@@ -125,6 +128,15 @@ module Google
125
128
  @config
126
129
  end
127
130
 
131
+ ##
132
+ # The effective universe domain
133
+ #
134
+ # @return [String]
135
+ #
136
+ def universe_domain
137
+ @metric_service_stub.universe_domain
138
+ end
139
+
128
140
  ##
129
141
  # Create a new MetricService client object.
130
142
  #
@@ -158,8 +170,9 @@ module Google
158
170
  credentials = @config.credentials
159
171
  # Use self-signed JWT if the endpoint is unchanged from default,
160
172
  # but only if the default endpoint does not have a region prefix.
161
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
162
- !@config.endpoint.split(".").first.include?("-")
173
+ enable_self_signed_jwt = @config.endpoint.nil? ||
174
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
175
+ !@config.endpoint.split(".").first.include?("-"))
163
176
  credentials ||= Credentials.default scope: @config.scope,
164
177
  enable_self_signed_jwt: enable_self_signed_jwt
165
178
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -170,8 +183,10 @@ module Google
170
183
 
171
184
  @metric_service_stub = ::Gapic::ServiceStub.new(
172
185
  ::Google::Cloud::Monitoring::V3::MetricService::Stub,
173
- credentials: credentials,
174
- endpoint: @config.endpoint,
186
+ credentials: credentials,
187
+ endpoint: @config.endpoint,
188
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
189
+ universe_domain: @config.universe_domain,
175
190
  channel_args: @config.channel_args,
176
191
  interceptors: @config.interceptors,
177
192
  channel_pool_config: @config.channel_pool
@@ -1125,9 +1140,9 @@ module Google
1125
1140
  # end
1126
1141
  #
1127
1142
  # @!attribute [rw] endpoint
1128
- # The hostname or hostname:port of the service endpoint.
1129
- # Defaults to `"monitoring.googleapis.com"`.
1130
- # @return [::String]
1143
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1144
+ # nil, indicating to use the default endpoint in the current universe domain.
1145
+ # @return [::String,nil]
1131
1146
  # @!attribute [rw] credentials
1132
1147
  # Credentials to send with calls. You may provide any of the following types:
1133
1148
  # * (`String`) The path to a service account key file in JSON format
@@ -1173,13 +1188,20 @@ module Google
1173
1188
  # @!attribute [rw] quota_project
1174
1189
  # A separate project against which to charge quota.
1175
1190
  # @return [::String]
1191
+ # @!attribute [rw] universe_domain
1192
+ # The universe domain within which to make requests. This determines the
1193
+ # default endpoint URL. The default value of nil uses the environment
1194
+ # universe (usually the default "googleapis.com" universe).
1195
+ # @return [::String,nil]
1176
1196
  #
1177
1197
  class Configuration
1178
1198
  extend ::Gapic::Config
1179
1199
 
1200
+ # @private
1201
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1180
1202
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
1181
1203
 
1182
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1204
+ config_attr :endpoint, nil, ::String, nil
1183
1205
  config_attr :credentials, nil do |value|
1184
1206
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1185
1207
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -1194,6 +1216,7 @@ module Google
1194
1216
  config_attr :metadata, nil, ::Hash, nil
1195
1217
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1196
1218
  config_attr :quota_project, nil, ::String, nil
1219
+ config_attr :universe_domain, nil, ::String, nil
1197
1220
 
1198
1221
  # @private
1199
1222
  def initialize parent_config = nil
@@ -31,6 +31,9 @@ module Google
31
31
  # controls how messages related to incidents are sent.
32
32
  #
33
33
  class Client
34
+ # @private
35
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
36
+
34
37
  include Paths
35
38
 
36
39
  # @private
@@ -132,6 +135,15 @@ module Google
132
135
  @config
133
136
  end
134
137
 
138
+ ##
139
+ # The effective universe domain
140
+ #
141
+ # @return [String]
142
+ #
143
+ def universe_domain
144
+ @notification_channel_service_stub.universe_domain
145
+ end
146
+
135
147
  ##
136
148
  # Create a new NotificationChannelService client object.
137
149
  #
@@ -165,8 +177,9 @@ module Google
165
177
  credentials = @config.credentials
166
178
  # Use self-signed JWT if the endpoint is unchanged from default,
167
179
  # but only if the default endpoint does not have a region prefix.
168
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
169
- !@config.endpoint.split(".").first.include?("-")
180
+ enable_self_signed_jwt = @config.endpoint.nil? ||
181
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
182
+ !@config.endpoint.split(".").first.include?("-"))
170
183
  credentials ||= Credentials.default scope: @config.scope,
171
184
  enable_self_signed_jwt: enable_self_signed_jwt
172
185
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -177,8 +190,10 @@ module Google
177
190
 
178
191
  @notification_channel_service_stub = ::Gapic::ServiceStub.new(
179
192
  ::Google::Cloud::Monitoring::V3::NotificationChannelService::Stub,
180
- credentials: credentials,
181
- endpoint: @config.endpoint,
193
+ credentials: credentials,
194
+ endpoint: @config.endpoint,
195
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
196
+ universe_domain: @config.universe_domain,
182
197
  channel_args: @config.channel_args,
183
198
  interceptors: @config.interceptors,
184
199
  channel_pool_config: @config.channel_pool
@@ -1222,9 +1237,9 @@ module Google
1222
1237
  # end
1223
1238
  #
1224
1239
  # @!attribute [rw] endpoint
1225
- # The hostname or hostname:port of the service endpoint.
1226
- # Defaults to `"monitoring.googleapis.com"`.
1227
- # @return [::String]
1240
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1241
+ # nil, indicating to use the default endpoint in the current universe domain.
1242
+ # @return [::String,nil]
1228
1243
  # @!attribute [rw] credentials
1229
1244
  # Credentials to send with calls. You may provide any of the following types:
1230
1245
  # * (`String`) The path to a service account key file in JSON format
@@ -1270,13 +1285,20 @@ module Google
1270
1285
  # @!attribute [rw] quota_project
1271
1286
  # A separate project against which to charge quota.
1272
1287
  # @return [::String]
1288
+ # @!attribute [rw] universe_domain
1289
+ # The universe domain within which to make requests. This determines the
1290
+ # default endpoint URL. The default value of nil uses the environment
1291
+ # universe (usually the default "googleapis.com" universe).
1292
+ # @return [::String,nil]
1273
1293
  #
1274
1294
  class Configuration
1275
1295
  extend ::Gapic::Config
1276
1296
 
1297
+ # @private
1298
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1277
1299
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
1278
1300
 
1279
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1301
+ config_attr :endpoint, nil, ::String, nil
1280
1302
  config_attr :credentials, nil do |value|
1281
1303
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1282
1304
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -1291,6 +1313,7 @@ module Google
1291
1313
  config_attr :metadata, nil, ::Hash, nil
1292
1314
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1293
1315
  config_attr :quota_project, nil, ::String, nil
1316
+ config_attr :universe_domain, nil, ::String, nil
1294
1317
 
1295
1318
  # @private
1296
1319
  def initialize parent_config = nil
@@ -32,6 +32,9 @@ module Google
32
32
  # the time-varying values of a metric.
33
33
  #
34
34
  class Client
35
+ # @private
36
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
37
+
35
38
  # @private
36
39
  attr_reader :query_service_stub
37
40
 
@@ -90,6 +93,15 @@ module Google
90
93
  @config
91
94
  end
92
95
 
96
+ ##
97
+ # The effective universe domain
98
+ #
99
+ # @return [String]
100
+ #
101
+ def universe_domain
102
+ @query_service_stub.universe_domain
103
+ end
104
+
93
105
  ##
94
106
  # Create a new QueryService client object.
95
107
  #
@@ -123,8 +135,9 @@ module Google
123
135
  credentials = @config.credentials
124
136
  # Use self-signed JWT if the endpoint is unchanged from default,
125
137
  # but only if the default endpoint does not have a region prefix.
126
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
127
- !@config.endpoint.split(".").first.include?("-")
138
+ enable_self_signed_jwt = @config.endpoint.nil? ||
139
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
140
+ !@config.endpoint.split(".").first.include?("-"))
128
141
  credentials ||= Credentials.default scope: @config.scope,
129
142
  enable_self_signed_jwt: enable_self_signed_jwt
130
143
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -135,8 +148,10 @@ module Google
135
148
 
136
149
  @query_service_stub = ::Gapic::ServiceStub.new(
137
150
  ::Google::Cloud::Monitoring::V3::QueryService::Stub,
138
- credentials: credentials,
139
- endpoint: @config.endpoint,
151
+ credentials: credentials,
152
+ endpoint: @config.endpoint,
153
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
154
+ universe_domain: @config.universe_domain,
140
155
  channel_args: @config.channel_args,
141
156
  interceptors: @config.interceptors,
142
157
  channel_pool_config: @config.channel_pool
@@ -278,9 +293,9 @@ module Google
278
293
  # end
279
294
  #
280
295
  # @!attribute [rw] endpoint
281
- # The hostname or hostname:port of the service endpoint.
282
- # Defaults to `"monitoring.googleapis.com"`.
283
- # @return [::String]
296
+ # A custom service endpoint, as a hostname or hostname:port. The default is
297
+ # nil, indicating to use the default endpoint in the current universe domain.
298
+ # @return [::String,nil]
284
299
  # @!attribute [rw] credentials
285
300
  # Credentials to send with calls. You may provide any of the following types:
286
301
  # * (`String`) The path to a service account key file in JSON format
@@ -326,13 +341,20 @@ module Google
326
341
  # @!attribute [rw] quota_project
327
342
  # A separate project against which to charge quota.
328
343
  # @return [::String]
344
+ # @!attribute [rw] universe_domain
345
+ # The universe domain within which to make requests. This determines the
346
+ # default endpoint URL. The default value of nil uses the environment
347
+ # universe (usually the default "googleapis.com" universe).
348
+ # @return [::String,nil]
329
349
  #
330
350
  class Configuration
331
351
  extend ::Gapic::Config
332
352
 
353
+ # @private
354
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
333
355
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
334
356
 
335
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
357
+ config_attr :endpoint, nil, ::String, nil
336
358
  config_attr :credentials, nil do |value|
337
359
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
338
360
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -347,6 +369,7 @@ module Google
347
369
  config_attr :metadata, nil, ::Hash, nil
348
370
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
349
371
  config_attr :quota_project, nil, ::String, nil
372
+ config_attr :universe_domain, nil, ::String, nil
350
373
 
351
374
  # @private
352
375
  def initialize parent_config = nil
@@ -33,6 +33,9 @@ module Google
33
33
  # of categorized Health Metrics.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
38
+
36
39
  include Paths
37
40
 
38
41
  # @private
@@ -131,6 +134,15 @@ module Google
131
134
  @config
132
135
  end
133
136
 
137
+ ##
138
+ # The effective universe domain
139
+ #
140
+ # @return [String]
141
+ #
142
+ def universe_domain
143
+ @service_monitoring_service_stub.universe_domain
144
+ end
145
+
134
146
  ##
135
147
  # Create a new ServiceMonitoringService client object.
136
148
  #
@@ -164,8 +176,9 @@ module Google
164
176
  credentials = @config.credentials
165
177
  # Use self-signed JWT if the endpoint is unchanged from default,
166
178
  # but only if the default endpoint does not have a region prefix.
167
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
168
- !@config.endpoint.split(".").first.include?("-")
179
+ enable_self_signed_jwt = @config.endpoint.nil? ||
180
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
181
+ !@config.endpoint.split(".").first.include?("-"))
169
182
  credentials ||= Credentials.default scope: @config.scope,
170
183
  enable_self_signed_jwt: enable_self_signed_jwt
171
184
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -176,8 +189,10 @@ module Google
176
189
 
177
190
  @service_monitoring_service_stub = ::Gapic::ServiceStub.new(
178
191
  ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Stub,
179
- credentials: credentials,
180
- endpoint: @config.endpoint,
192
+ credentials: credentials,
193
+ endpoint: @config.endpoint,
194
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
195
+ universe_domain: @config.universe_domain,
181
196
  channel_args: @config.channel_args,
182
197
  interceptors: @config.interceptors,
183
198
  channel_pool_config: @config.channel_pool
@@ -1163,9 +1178,9 @@ module Google
1163
1178
  # end
1164
1179
  #
1165
1180
  # @!attribute [rw] endpoint
1166
- # The hostname or hostname:port of the service endpoint.
1167
- # Defaults to `"monitoring.googleapis.com"`.
1168
- # @return [::String]
1181
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1182
+ # nil, indicating to use the default endpoint in the current universe domain.
1183
+ # @return [::String,nil]
1169
1184
  # @!attribute [rw] credentials
1170
1185
  # Credentials to send with calls. You may provide any of the following types:
1171
1186
  # * (`String`) The path to a service account key file in JSON format
@@ -1211,13 +1226,20 @@ module Google
1211
1226
  # @!attribute [rw] quota_project
1212
1227
  # A separate project against which to charge quota.
1213
1228
  # @return [::String]
1229
+ # @!attribute [rw] universe_domain
1230
+ # The universe domain within which to make requests. This determines the
1231
+ # default endpoint URL. The default value of nil uses the environment
1232
+ # universe (usually the default "googleapis.com" universe).
1233
+ # @return [::String,nil]
1214
1234
  #
1215
1235
  class Configuration
1216
1236
  extend ::Gapic::Config
1217
1237
 
1238
+ # @private
1239
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1218
1240
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
1219
1241
 
1220
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1242
+ config_attr :endpoint, nil, ::String, nil
1221
1243
  config_attr :credentials, nil do |value|
1222
1244
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1223
1245
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -1232,6 +1254,7 @@ module Google
1232
1254
  config_attr :metadata, nil, ::Hash, nil
1233
1255
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1234
1256
  config_attr :quota_project, nil, ::String, nil
1257
+ config_attr :universe_domain, nil, ::String, nil
1235
1258
 
1236
1259
  # @private
1237
1260
  def initialize parent_config = nil
@@ -32,6 +32,9 @@ module Google
32
32
  # or more alert policies should not fire alerts for the specified duration.
33
33
  #
34
34
  class Client
35
+ # @private
36
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
37
+
35
38
  include Paths
36
39
 
37
40
  # @private
@@ -106,6 +109,15 @@ module Google
106
109
  @config
107
110
  end
108
111
 
112
+ ##
113
+ # The effective universe domain
114
+ #
115
+ # @return [String]
116
+ #
117
+ def universe_domain
118
+ @snooze_service_stub.universe_domain
119
+ end
120
+
109
121
  ##
110
122
  # Create a new SnoozeService client object.
111
123
  #
@@ -139,8 +151,9 @@ module Google
139
151
  credentials = @config.credentials
140
152
  # Use self-signed JWT if the endpoint is unchanged from default,
141
153
  # but only if the default endpoint does not have a region prefix.
142
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
143
- !@config.endpoint.split(".").first.include?("-")
154
+ enable_self_signed_jwt = @config.endpoint.nil? ||
155
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
156
+ !@config.endpoint.split(".").first.include?("-"))
144
157
  credentials ||= Credentials.default scope: @config.scope,
145
158
  enable_self_signed_jwt: enable_self_signed_jwt
146
159
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -151,8 +164,10 @@ module Google
151
164
 
152
165
  @snooze_service_stub = ::Gapic::ServiceStub.new(
153
166
  ::Google::Cloud::Monitoring::V3::SnoozeService::Stub,
154
- credentials: credentials,
155
- endpoint: @config.endpoint,
167
+ credentials: credentials,
168
+ endpoint: @config.endpoint,
169
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
170
+ universe_domain: @config.universe_domain,
156
171
  channel_args: @config.channel_args,
157
172
  interceptors: @config.interceptors,
158
173
  channel_pool_config: @config.channel_pool
@@ -598,9 +613,9 @@ module Google
598
613
  # end
599
614
  #
600
615
  # @!attribute [rw] endpoint
601
- # The hostname or hostname:port of the service endpoint.
602
- # Defaults to `"monitoring.googleapis.com"`.
603
- # @return [::String]
616
+ # A custom service endpoint, as a hostname or hostname:port. The default is
617
+ # nil, indicating to use the default endpoint in the current universe domain.
618
+ # @return [::String,nil]
604
619
  # @!attribute [rw] credentials
605
620
  # Credentials to send with calls. You may provide any of the following types:
606
621
  # * (`String`) The path to a service account key file in JSON format
@@ -646,13 +661,20 @@ module Google
646
661
  # @!attribute [rw] quota_project
647
662
  # A separate project against which to charge quota.
648
663
  # @return [::String]
664
+ # @!attribute [rw] universe_domain
665
+ # The universe domain within which to make requests. This determines the
666
+ # default endpoint URL. The default value of nil uses the environment
667
+ # universe (usually the default "googleapis.com" universe).
668
+ # @return [::String,nil]
649
669
  #
650
670
  class Configuration
651
671
  extend ::Gapic::Config
652
672
 
673
+ # @private
674
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
653
675
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
654
676
 
655
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
677
+ config_attr :endpoint, nil, ::String, nil
656
678
  config_attr :credentials, nil do |value|
657
679
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
658
680
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -667,6 +689,7 @@ module Google
667
689
  config_attr :metadata, nil, ::Hash, nil
668
690
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
669
691
  config_attr :quota_project, nil, ::String, nil
692
+ config_attr :universe_domain, nil, ::String, nil
670
693
 
671
694
  # @private
672
695
  def initialize parent_config = nil
@@ -37,6 +37,9 @@ module Google
37
37
  # Monitoring, and then clicking on "Uptime".
38
38
  #
39
39
  class Client
40
+ # @private
41
+ DEFAULT_ENDPOINT_TEMPLATE = "monitoring.$UNIVERSE_DOMAIN$"
42
+
40
43
  include Paths
41
44
 
42
45
  # @private
@@ -121,6 +124,15 @@ module Google
121
124
  @config
122
125
  end
123
126
 
127
+ ##
128
+ # The effective universe domain
129
+ #
130
+ # @return [String]
131
+ #
132
+ def universe_domain
133
+ @uptime_check_service_stub.universe_domain
134
+ end
135
+
124
136
  ##
125
137
  # Create a new UptimeCheckService client object.
126
138
  #
@@ -154,8 +166,9 @@ module Google
154
166
  credentials = @config.credentials
155
167
  # Use self-signed JWT if the endpoint is unchanged from default,
156
168
  # but only if the default endpoint does not have a region prefix.
157
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
158
- !@config.endpoint.split(".").first.include?("-")
169
+ enable_self_signed_jwt = @config.endpoint.nil? ||
170
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
171
+ !@config.endpoint.split(".").first.include?("-"))
159
172
  credentials ||= Credentials.default scope: @config.scope,
160
173
  enable_self_signed_jwt: enable_self_signed_jwt
161
174
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -166,8 +179,10 @@ module Google
166
179
 
167
180
  @uptime_check_service_stub = ::Gapic::ServiceStub.new(
168
181
  ::Google::Cloud::Monitoring::V3::UptimeCheckService::Stub,
169
- credentials: credentials,
170
- endpoint: @config.endpoint,
182
+ credentials: credentials,
183
+ endpoint: @config.endpoint,
184
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
185
+ universe_domain: @config.universe_domain,
171
186
  channel_args: @config.channel_args,
172
187
  interceptors: @config.interceptors,
173
188
  channel_pool_config: @config.channel_pool
@@ -777,9 +792,9 @@ module Google
777
792
  # end
778
793
  #
779
794
  # @!attribute [rw] endpoint
780
- # The hostname or hostname:port of the service endpoint.
781
- # Defaults to `"monitoring.googleapis.com"`.
782
- # @return [::String]
795
+ # A custom service endpoint, as a hostname or hostname:port. The default is
796
+ # nil, indicating to use the default endpoint in the current universe domain.
797
+ # @return [::String,nil]
783
798
  # @!attribute [rw] credentials
784
799
  # Credentials to send with calls. You may provide any of the following types:
785
800
  # * (`String`) The path to a service account key file in JSON format
@@ -825,13 +840,20 @@ module Google
825
840
  # @!attribute [rw] quota_project
826
841
  # A separate project against which to charge quota.
827
842
  # @return [::String]
843
+ # @!attribute [rw] universe_domain
844
+ # The universe domain within which to make requests. This determines the
845
+ # default endpoint URL. The default value of nil uses the environment
846
+ # universe (usually the default "googleapis.com" universe).
847
+ # @return [::String,nil]
828
848
  #
829
849
  class Configuration
830
850
  extend ::Gapic::Config
831
851
 
852
+ # @private
853
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
832
854
  DEFAULT_ENDPOINT = "monitoring.googleapis.com"
833
855
 
834
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
856
+ config_attr :endpoint, nil, ::String, nil
835
857
  config_attr :credentials, nil do |value|
836
858
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
837
859
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -846,6 +868,7 @@ module Google
846
868
  config_attr :metadata, nil, ::Hash, nil
847
869
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
848
870
  config_attr :quota_project, nil, ::String, nil
871
+ config_attr :universe_domain, nil, ::String, nil
849
872
 
850
873
  # @private
851
874
  def initialize parent_config = nil
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Monitoring
23
23
  module V3
24
- VERSION = "0.13.0"
24
+ VERSION = "0.15.0"
25
25
  end
26
26
  end
27
27
  end
@@ -13,7 +13,7 @@ require 'google/protobuf/wrappers_pb'
13
13
  require 'google/rpc/status_pb'
14
14
 
15
15
 
16
- descriptor_data = "\n google/monitoring/v3/alert.proto\x12\x14google.monitoring.v3\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a!google/monitoring/v3/common.proto\x1a*google/monitoring/v3/mutation_record.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto\"\x87\"\n\x0b\x41lertPolicy\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x46\n\rdocumentation\x18\r \x01(\x0b\x32/.google.monitoring.v3.AlertPolicy.Documentation\x12\x46\n\x0buser_labels\x18\x10 \x03(\x0b\x32\x31.google.monitoring.v3.AlertPolicy.UserLabelsEntry\x12?\n\nconditions\x18\x0c \x03(\x0b\x32+.google.monitoring.v3.AlertPolicy.Condition\x12I\n\x08\x63ombiner\x18\x06 \x01(\x0e\x32\x37.google.monitoring.v3.AlertPolicy.ConditionCombinerType\x12+\n\x07\x65nabled\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12$\n\x08validity\x18\x12 \x01(\x0b\x32\x12.google.rpc.Status\x12\x1d\n\x15notification_channels\x18\x0e \x03(\t\x12=\n\x0f\x63reation_record\x18\n \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x12=\n\x0fmutation_record\x18\x0b \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x12G\n\x0e\x61lert_strategy\x18\x15 \x01(\x0b\x32/.google.monitoring.v3.AlertPolicy.AlertStrategy\x1aI\n\rDocumentation\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\x12\x14\n\x07subject\x18\x03 \x01(\tB\x03\xe0\x41\x01\x1a\xf7\x15\n\tCondition\x12\x0c\n\x04name\x18\x0c \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x06 \x01(\t\x12Z\n\x13\x63ondition_threshold\x18\x01 \x01(\x0b\x32;.google.monitoring.v3.AlertPolicy.Condition.MetricThresholdH\x00\x12U\n\x10\x63ondition_absent\x18\x02 \x01(\x0b\x32\x39.google.monitoring.v3.AlertPolicy.Condition.MetricAbsenceH\x00\x12U\n\x15\x63ondition_matched_log\x18\x14 \x01(\x0b\x32\x34.google.monitoring.v3.AlertPolicy.Condition.LogMatchH\x00\x12{\n#condition_monitoring_query_language\x18\x13 \x01(\x0b\x32L.google.monitoring.v3.AlertPolicy.Condition.MonitoringQueryLanguageConditionH\x00\x12{\n#condition_prometheus_query_language\x18\x15 \x01(\x0b\x32L.google.monitoring.v3.AlertPolicy.Condition.PrometheusQueryLanguageConditionH\x00\x1a\x35\n\x07Trigger\x12\x0f\n\x05\x63ount\x18\x01 \x01(\x05H\x00\x12\x11\n\x07percent\x18\x02 \x01(\x01H\x00\x42\x06\n\x04type\x1a\x9e\x05\n\x0fMetricThreshold\x12\x13\n\x06\x66ilter\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x37\n\x0c\x61ggregations\x18\x08 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x1a\n\x12\x64\x65nominator_filter\x18\t \x01(\t\x12\x43\n\x18\x64\x65nominator_aggregations\x18\n \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x65\n\x10\x66orecast_options\x18\x0c \x01(\x0b\x32K.google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.ForecastOptions\x12\x38\n\ncomparison\x18\x04 \x01(\x0e\x32$.google.monitoring.v3.ComparisonType\x12\x17\n\x0fthreshold_value\x18\x05 \x01(\x01\x12+\n\x08\x64uration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x07 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x12\x62\n\x17\x65valuation_missing_data\x18\x0b \x01(\x0e\x32\x41.google.monitoring.v3.AlertPolicy.Condition.EvaluationMissingData\x1aK\n\x0f\x46orecastOptions\x12\x38\n\x10\x66orecast_horizon\x18\x01 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x1a\xd0\x01\n\rMetricAbsence\x12\x13\n\x06\x66ilter\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x37\n\x0c\x61ggregations\x18\x05 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x03 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x1a\xbc\x01\n\x08LogMatch\x12\x13\n\x06\x66ilter\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x63\n\x10label_extractors\x18\x02 \x03(\x0b\x32I.google.monitoring.v3.AlertPolicy.Condition.LogMatch.LabelExtractorsEntry\x1a\x36\n\x14LabelExtractorsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x88\x02\n MonitoringQueryLanguageCondition\x12\r\n\x05query\x18\x01 \x01(\t\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x03 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x12\x62\n\x17\x65valuation_missing_data\x18\x04 \x01(\x0e\x32\x41.google.monitoring.v3.AlertPolicy.Condition.EvaluationMissingData\x1a\xf5\x02\n PrometheusQueryLanguageCondition\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x30\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x01\x12;\n\x13\x65valuation_interval\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x01\x12m\n\x06labels\x18\x04 \x03(\x0b\x32X.google.monitoring.v3.AlertPolicy.Condition.PrometheusQueryLanguageCondition.LabelsEntryB\x03\xe0\x41\x01\x12\x17\n\nrule_group\x18\x05 \x01(\tB\x03\xe0\x41\x01\x12\x17\n\nalert_rule\x18\x06 \x01(\tB\x03\xe0\x41\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xad\x01\n\x15\x45valuationMissingData\x12\'\n#EVALUATION_MISSING_DATA_UNSPECIFIED\x10\x00\x12$\n EVALUATION_MISSING_DATA_INACTIVE\x10\x01\x12\"\n\x1e\x45VALUATION_MISSING_DATA_ACTIVE\x10\x02\x12!\n\x1d\x45VALUATION_MISSING_DATA_NO_OP\x10\x03:\x97\x02\xea\x41\x93\x02\n.monitoring.googleapis.com/AlertPolicyCondition\x12\x46projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}\x12Porganizations/{organization}/alertPolicies/{alert_policy}/conditions/{condition}\x12\x44\x66olders/{folder}/alertPolicies/{alert_policy}/conditions/{condition}\x12\x01*B\x0b\n\tcondition\x1a\xd7\x03\n\rAlertStrategy\x12\x66\n\x17notification_rate_limit\x18\x01 \x01(\x0b\x32\x45.google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationRateLimit\x12-\n\nauto_close\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12r\n\x1dnotification_channel_strategy\x18\x04 \x03(\x0b\x32K.google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationChannelStrategy\x1a\x42\n\x15NotificationRateLimit\x12)\n\x06period\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x1aw\n\x1bNotificationChannelStrategy\x12\"\n\x1anotification_channel_names\x18\x01 \x03(\t\x12\x34\n\x11renotify_interval\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"a\n\x15\x43onditionCombinerType\x12\x17\n\x13\x43OMBINE_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x12\x06\n\x02OR\x10\x02\x12\x1e\n\x1a\x41ND_WITH_MATCHING_RESOURCE\x10\x03:\xc9\x01\xea\x41\xc5\x01\n%monitoring.googleapis.com/AlertPolicy\x12/projects/{project}/alertPolicies/{alert_policy}\x12\x39organizations/{organization}/alertPolicies/{alert_policy}\x12-folders/{folder}/alertPolicies/{alert_policy}\x12\x01*B\xc5\x01\n\x18\x63om.google.monitoring.v3B\nAlertProtoP\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"
16
+ descriptor_data = "\n google/monitoring/v3/alert.proto\x12\x14google.monitoring.v3\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a!google/monitoring/v3/common.proto\x1a*google/monitoring/v3/mutation_record.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto\"\x96#\n\x0b\x41lertPolicy\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x46\n\rdocumentation\x18\r \x01(\x0b\x32/.google.monitoring.v3.AlertPolicy.Documentation\x12\x46\n\x0buser_labels\x18\x10 \x03(\x0b\x32\x31.google.monitoring.v3.AlertPolicy.UserLabelsEntry\x12?\n\nconditions\x18\x0c \x03(\x0b\x32+.google.monitoring.v3.AlertPolicy.Condition\x12I\n\x08\x63ombiner\x18\x06 \x01(\x0e\x32\x37.google.monitoring.v3.AlertPolicy.ConditionCombinerType\x12+\n\x07\x65nabled\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12$\n\x08validity\x18\x12 \x01(\x0b\x32\x12.google.rpc.Status\x12\x1d\n\x15notification_channels\x18\x0e \x03(\t\x12=\n\x0f\x63reation_record\x18\n \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x12=\n\x0fmutation_record\x18\x0b \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x12G\n\x0e\x61lert_strategy\x18\x15 \x01(\x0b\x32/.google.monitoring.v3.AlertPolicy.AlertStrategy\x12\x41\n\x08severity\x18\x16 \x01(\x0e\x32*.google.monitoring.v3.AlertPolicy.SeverityB\x03\xe0\x41\x01\x1aI\n\rDocumentation\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\x12\x14\n\x07subject\x18\x03 \x01(\tB\x03\xe0\x41\x01\x1a\xf7\x15\n\tCondition\x12\x0c\n\x04name\x18\x0c \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x06 \x01(\t\x12Z\n\x13\x63ondition_threshold\x18\x01 \x01(\x0b\x32;.google.monitoring.v3.AlertPolicy.Condition.MetricThresholdH\x00\x12U\n\x10\x63ondition_absent\x18\x02 \x01(\x0b\x32\x39.google.monitoring.v3.AlertPolicy.Condition.MetricAbsenceH\x00\x12U\n\x15\x63ondition_matched_log\x18\x14 \x01(\x0b\x32\x34.google.monitoring.v3.AlertPolicy.Condition.LogMatchH\x00\x12{\n#condition_monitoring_query_language\x18\x13 \x01(\x0b\x32L.google.monitoring.v3.AlertPolicy.Condition.MonitoringQueryLanguageConditionH\x00\x12{\n#condition_prometheus_query_language\x18\x15 \x01(\x0b\x32L.google.monitoring.v3.AlertPolicy.Condition.PrometheusQueryLanguageConditionH\x00\x1a\x35\n\x07Trigger\x12\x0f\n\x05\x63ount\x18\x01 \x01(\x05H\x00\x12\x11\n\x07percent\x18\x02 \x01(\x01H\x00\x42\x06\n\x04type\x1a\x9e\x05\n\x0fMetricThreshold\x12\x13\n\x06\x66ilter\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x37\n\x0c\x61ggregations\x18\x08 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x1a\n\x12\x64\x65nominator_filter\x18\t \x01(\t\x12\x43\n\x18\x64\x65nominator_aggregations\x18\n \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x65\n\x10\x66orecast_options\x18\x0c \x01(\x0b\x32K.google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.ForecastOptions\x12\x38\n\ncomparison\x18\x04 \x01(\x0e\x32$.google.monitoring.v3.ComparisonType\x12\x17\n\x0fthreshold_value\x18\x05 \x01(\x01\x12+\n\x08\x64uration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x07 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x12\x62\n\x17\x65valuation_missing_data\x18\x0b \x01(\x0e\x32\x41.google.monitoring.v3.AlertPolicy.Condition.EvaluationMissingData\x1aK\n\x0f\x46orecastOptions\x12\x38\n\x10\x66orecast_horizon\x18\x01 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x1a\xd0\x01\n\rMetricAbsence\x12\x13\n\x06\x66ilter\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x37\n\x0c\x61ggregations\x18\x05 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x03 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x1a\xbc\x01\n\x08LogMatch\x12\x13\n\x06\x66ilter\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x63\n\x10label_extractors\x18\x02 \x03(\x0b\x32I.google.monitoring.v3.AlertPolicy.Condition.LogMatch.LabelExtractorsEntry\x1a\x36\n\x14LabelExtractorsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x88\x02\n MonitoringQueryLanguageCondition\x12\r\n\x05query\x18\x01 \x01(\t\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x03 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x12\x62\n\x17\x65valuation_missing_data\x18\x04 \x01(\x0e\x32\x41.google.monitoring.v3.AlertPolicy.Condition.EvaluationMissingData\x1a\xf5\x02\n PrometheusQueryLanguageCondition\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x30\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x01\x12;\n\x13\x65valuation_interval\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x01\x12m\n\x06labels\x18\x04 \x03(\x0b\x32X.google.monitoring.v3.AlertPolicy.Condition.PrometheusQueryLanguageCondition.LabelsEntryB\x03\xe0\x41\x01\x12\x17\n\nrule_group\x18\x05 \x01(\tB\x03\xe0\x41\x01\x12\x17\n\nalert_rule\x18\x06 \x01(\tB\x03\xe0\x41\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xad\x01\n\x15\x45valuationMissingData\x12\'\n#EVALUATION_MISSING_DATA_UNSPECIFIED\x10\x00\x12$\n EVALUATION_MISSING_DATA_INACTIVE\x10\x01\x12\"\n\x1e\x45VALUATION_MISSING_DATA_ACTIVE\x10\x02\x12!\n\x1d\x45VALUATION_MISSING_DATA_NO_OP\x10\x03:\x97\x02\xea\x41\x93\x02\n.monitoring.googleapis.com/AlertPolicyCondition\x12\x46projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}\x12Porganizations/{organization}/alertPolicies/{alert_policy}/conditions/{condition}\x12\x44\x66olders/{folder}/alertPolicies/{alert_policy}/conditions/{condition}\x12\x01*B\x0b\n\tcondition\x1a\xd7\x03\n\rAlertStrategy\x12\x66\n\x17notification_rate_limit\x18\x01 \x01(\x0b\x32\x45.google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationRateLimit\x12-\n\nauto_close\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12r\n\x1dnotification_channel_strategy\x18\x04 \x03(\x0b\x32K.google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationChannelStrategy\x1a\x42\n\x15NotificationRateLimit\x12)\n\x06period\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x1aw\n\x1bNotificationChannelStrategy\x12\"\n\x1anotification_channel_names\x18\x01 \x03(\t\x12\x34\n\x11renotify_interval\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"a\n\x15\x43onditionCombinerType\x12\x17\n\x13\x43OMBINE_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x12\x06\n\x02OR\x10\x02\x12\x1e\n\x1a\x41ND_WITH_MATCHING_RESOURCE\x10\x03\"J\n\x08Severity\x12\x18\n\x14SEVERITY_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43RITICAL\x10\x01\x12\t\n\x05\x45RROR\x10\x02\x12\x0b\n\x07WARNING\x10\x03:\xc9\x01\xea\x41\xc5\x01\n%monitoring.googleapis.com/AlertPolicy\x12/projects/{project}/alertPolicies/{alert_policy}\x12\x39organizations/{organization}/alertPolicies/{alert_policy}\x12-folders/{folder}/alertPolicies/{alert_policy}\x12\x01*B\xc5\x01\n\x18\x63om.google.monitoring.v3B\nAlertProtoP\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"
17
17
 
18
18
  pool = Google::Protobuf::DescriptorPool.generated_pool
19
19
 
@@ -63,6 +63,7 @@ module Google
63
63
  AlertPolicy::AlertStrategy::NotificationRateLimit = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationRateLimit").msgclass
64
64
  AlertPolicy::AlertStrategy::NotificationChannelStrategy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.AlertStrategy.NotificationChannelStrategy").msgclass
65
65
  AlertPolicy::ConditionCombinerType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.ConditionCombinerType").enummodule
66
+ AlertPolicy::Severity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.monitoring.v3.AlertPolicy.Severity").enummodule
66
67
  end
67
68
  end
68
69
  end
@@ -21,6 +21,7 @@ module Google
21
21
  module Api
22
22
  # Required information for every language.
23
23
  # @!attribute [rw] reference_docs_uri
24
+ # @deprecated This field is deprecated and may be removed in the next major version update.
24
25
  # @return [::String]
25
26
  # Link to automatically generated reference documentation. Example:
26
27
  # https://cloud.google.com/nodejs/docs/reference/asset/latest
@@ -304,6 +305,19 @@ module Google
304
305
  # seconds: 360 # 6 minutes
305
306
  # total_poll_timeout:
306
307
  # seconds: 54000 # 90 minutes
308
+ # @!attribute [rw] auto_populated_fields
309
+ # @return [::Array<::String>]
310
+ # List of top-level fields of the request message, that should be
311
+ # automatically populated by the client libraries based on their
312
+ # (google.api.field_info).format. Currently supported format: UUID4.
313
+ #
314
+ # Example of a YAML configuration:
315
+ #
316
+ # publishing:
317
+ # method_settings:
318
+ # - selector: google.example.v1.ExampleService.CreateExample
319
+ # auto_populated_fields:
320
+ # - request_id
307
321
  class MethodSettings
308
322
  include ::Google::Protobuf::MessageExts
309
323
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -184,6 +184,7 @@ module Google
184
184
 
185
185
  # Additional annotations that can be used to guide the usage of a metric.
186
186
  # @!attribute [rw] launch_stage
187
+ # @deprecated This field is deprecated and may be removed in the next major version update.
187
188
  # @return [::Google::Api::LaunchStage]
188
189
  # Deprecated. Must use the
189
190
  # {::Google::Api::MetricDescriptor#launch_stage MetricDescriptor.launch_stage}
@@ -123,6 +123,11 @@ module Google
123
123
  # @!attribute [rw] alert_strategy
124
124
  # @return [::Google::Cloud::Monitoring::V3::AlertPolicy::AlertStrategy]
125
125
  # Control over how this alert policy's notification channels are notified.
126
+ # @!attribute [rw] severity
127
+ # @return [::Google::Cloud::Monitoring::V3::AlertPolicy::Severity]
128
+ # Optional. The severity of an alert policy indicates how important incidents
129
+ # generated by that policy are. The severity level will be displayed on the
130
+ # Incident detail page and in notifications.
126
131
  class AlertPolicy
127
132
  include ::Google::Protobuf::MessageExts
128
133
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -339,6 +344,7 @@ module Google
339
344
  # found to violate the threshold, and the violation is observed in all
340
345
  # forecasts made for the configured `duration`, then the time series is
341
346
  # considered to be failing.
347
+ # The forecast horizon can range from 1 hour to 60 hours.
342
348
  class ForecastOptions
343
349
  include ::Google::Protobuf::MessageExts
344
350
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -670,6 +676,25 @@ module Google
670
676
  # simultaneously on at least one resource.
671
677
  AND_WITH_MATCHING_RESOURCE = 3
672
678
  end
679
+
680
+ # An enumeration of possible severity level for an Alert Policy.
681
+ module Severity
682
+ # No severity is specified. This is the default value.
683
+ SEVERITY_UNSPECIFIED = 0
684
+
685
+ # This is the highest severity level. Use this if the problem could
686
+ # cause significant damage or downtime.
687
+ CRITICAL = 1
688
+
689
+ # This is the medium severity level. Use this if the problem could
690
+ # cause minor damage or downtime.
691
+ ERROR = 2
692
+
693
+ # This is the lowest severity level. Use this if the problem is not causing
694
+ # any damage or downtime, but could potentially lead to a problem in the
695
+ # future.
696
+ WARNING = 3
697
+ end
673
698
  end
674
699
  end
675
700
  end
@@ -464,6 +464,7 @@ module Google
464
464
  # [service tiers
465
465
  # documentation](https://cloud.google.com/monitoring/workspaces/tiers) for more
466
466
  # details.
467
+ # @deprecated This enum is deprecated and may be removed in the next major version update.
467
468
  module ServiceTier
468
469
  # An invalid sentinel value, used to indicate that a tier has not
469
470
  # been provided explicitly.
@@ -285,9 +285,11 @@ module Google
285
285
 
286
286
  # DEPRECATED. Used to hold per-time-series error status.
287
287
  # @!attribute [rw] time_series
288
+ # @deprecated This field is deprecated and may be removed in the next major version update.
288
289
  # @return [::Google::Cloud::Monitoring::V3::TimeSeries]
289
290
  # DEPRECATED. Time series ID that resulted in the `status` error.
290
291
  # @!attribute [rw] status
292
+ # @deprecated This field is deprecated and may be removed in the next major version update.
291
293
  # @return [::Google::Rpc::Status]
292
294
  # DEPRECATED. The status of the requested write operation for `time_series`.
293
295
  class CreateTimeSeriesError
@@ -53,6 +53,7 @@ module Google
53
53
  # channel of the corresponding type. Each label includes a
54
54
  # description for how that field should be populated.
55
55
  # @!attribute [rw] supported_tiers
56
+ # @deprecated This field is deprecated and may be removed in the next major version update.
56
57
  # @return [::Array<::Google::Cloud::Monitoring::V3::ServiceTier>]
57
58
  # The tiers that support this notification channel; the project service tier
58
59
  # must be one of the supported_tiers.
@@ -23,6 +23,7 @@ module Google
23
23
  module V3
24
24
  # An internal checker allows Uptime checks to run on private/internal GCP
25
25
  # resources.
26
+ # @deprecated This message is deprecated and may be removed in the next major version update.
26
27
  # @!attribute [rw] name
27
28
  # @return [::String]
28
29
  # A unique resource name for this InternalChecker. The format is:
@@ -148,12 +149,14 @@ module Google
148
149
  # minimum of 3 locations. Not specifying this field will result in Uptime
149
150
  # checks running from all available regions.
150
151
  # @!attribute [rw] is_internal
152
+ # @deprecated This field is deprecated and may be removed in the next major version update.
151
153
  # @return [::Boolean]
152
154
  # If this is `true`, then checks are made only from the 'internal_checkers'.
153
155
  # If it is `false`, then checks are made only from the 'selected_regions'.
154
156
  # It is an error to provide 'selected_regions' when is_internal is `true`,
155
157
  # or to provide 'internal_checkers' when is_internal is `false`.
156
158
  # @!attribute [rw] internal_checkers
159
+ # @deprecated This field is deprecated and may be removed in the next major version update.
157
160
  # @return [::Array<::Google::Cloud::Monitoring::V3::InternalChecker>]
158
161
  # The internal checkers that this check will egress from. If `is_internal` is
159
162
  # `true` and this list is empty, the check will egress from all the
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-monitoring-v3
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.13.0
4
+ version: 0.15.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-09-12 00:00:00.000000000 Z
11
+ date: 2024-01-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.20.0
19
+ version: 0.21.1
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.20.0
29
+ version: 0.21.1
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -286,7 +286,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
286
286
  - !ruby/object:Gem::Version
287
287
  version: '0'
288
288
  requirements: []
289
- rubygems_version: 3.4.19
289
+ rubygems_version: 3.5.3
290
290
  signing_key:
291
291
  specification_version: 4
292
292
  summary: Manages your Cloud Monitoring data and configurations.