google-cloud-monitoring-v3 0.14.0 → 0.15.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '036491475ff17857d24649b9c40f0f0f914a26755937103e6c726a8da61203e1'
4
- data.tar.gz: 77f90ffdad34e1e3a6493168ab7eacd710bbeba05c6ee157507f5ddb436eb7f1
3
+ metadata.gz: a1b95ff81ddc44cb7c6ed0aeb33556278c76fc98b7c0c9d49c739cf068a9e4e4
4
+ data.tar.gz: 40c6ae87e79016a1c5f098a0eb478173e58d5996ff4199097eabae4cbb18812a
5
5
  SHA512:
6
- metadata.gz: 76a1ae73c85f3eb0454425aa7b05c3d39e22bf3b4d0f8450b2cc26b53ea93bead0d3a1d65f1d6ef361ca01e71dd648fbc3cfb1d265d49f5afa8491cb4181d2a4
7
- data.tar.gz: b1e3e39f080cbd6e361d0c3fcd7ae999e89233c1aaf174cbc98c81b7fd7cf42f51530c42f48e7bc4ac69f6a122da8e0b4867480ee4e01ff77508a1426b5efecb
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.14.0"
24
+ VERSION = "0.15.0"
25
25
  end
26
26
  end
27
27
  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
@@ -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}
@@ -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.14.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-12-13 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.