google-cloud-network_management-v1 0.3.0 → 0.5.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.
@@ -0,0 +1,405 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/networkmanagement/v1/reachability_pb"
20
+
21
+ module Google
22
+ module Cloud
23
+ module NetworkManagement
24
+ module V1
25
+ module ReachabilityService
26
+ module Rest
27
+ ##
28
+ # REST service stub for the ReachabilityService service.
29
+ # Service stub contains baseline method implementations
30
+ # including transcoding, making the REST call, and deserialing the response.
31
+ #
32
+ class ServiceStub
33
+ def initialize endpoint:, credentials:
34
+ # These require statements are intentionally placed here to initialize
35
+ # the REST modules only when it's required.
36
+ require "gapic/rest"
37
+
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
39
+ numeric_enums: true,
40
+ raise_faraday_errors: false
41
+ end
42
+
43
+ ##
44
+ # Baseline implementation for the list_connectivity_tests REST call
45
+ #
46
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::ListConnectivityTestsRequest]
47
+ # A request object representing the call parameters. Required.
48
+ # @param options [::Gapic::CallOptions]
49
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
50
+ #
51
+ # @yield [result, operation] Access the result along with the TransportOperation object
52
+ # @yieldparam result [::Google::Cloud::NetworkManagement::V1::ListConnectivityTestsResponse]
53
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
54
+ #
55
+ # @return [::Google::Cloud::NetworkManagement::V1::ListConnectivityTestsResponse]
56
+ # A result object deserialized from the server's reply
57
+ def list_connectivity_tests request_pb, options = nil
58
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
59
+
60
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_connectivity_tests_request request_pb
61
+ query_string_params = if query_string_params.any?
62
+ query_string_params.to_h { |p| p.split("=", 2) }
63
+ else
64
+ {}
65
+ end
66
+
67
+ response = @client_stub.make_http_request(
68
+ verb,
69
+ uri: uri,
70
+ body: body || "",
71
+ params: query_string_params,
72
+ options: options
73
+ )
74
+ operation = ::Gapic::Rest::TransportOperation.new response
75
+ result = ::Google::Cloud::NetworkManagement::V1::ListConnectivityTestsResponse.decode_json response.body, ignore_unknown_fields: true
76
+
77
+ yield result, operation if block_given?
78
+ result
79
+ end
80
+
81
+ ##
82
+ # Baseline implementation for the get_connectivity_test REST call
83
+ #
84
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::GetConnectivityTestRequest]
85
+ # A request object representing the call parameters. Required.
86
+ # @param options [::Gapic::CallOptions]
87
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
88
+ #
89
+ # @yield [result, operation] Access the result along with the TransportOperation object
90
+ # @yieldparam result [::Google::Cloud::NetworkManagement::V1::ConnectivityTest]
91
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
92
+ #
93
+ # @return [::Google::Cloud::NetworkManagement::V1::ConnectivityTest]
94
+ # A result object deserialized from the server's reply
95
+ def get_connectivity_test request_pb, options = nil
96
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
97
+
98
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_connectivity_test_request request_pb
99
+ query_string_params = if query_string_params.any?
100
+ query_string_params.to_h { |p| p.split("=", 2) }
101
+ else
102
+ {}
103
+ end
104
+
105
+ response = @client_stub.make_http_request(
106
+ verb,
107
+ uri: uri,
108
+ body: body || "",
109
+ params: query_string_params,
110
+ options: options
111
+ )
112
+ operation = ::Gapic::Rest::TransportOperation.new response
113
+ result = ::Google::Cloud::NetworkManagement::V1::ConnectivityTest.decode_json response.body, ignore_unknown_fields: true
114
+
115
+ yield result, operation if block_given?
116
+ result
117
+ end
118
+
119
+ ##
120
+ # Baseline implementation for the create_connectivity_test REST call
121
+ #
122
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::CreateConnectivityTestRequest]
123
+ # A request object representing the call parameters. Required.
124
+ # @param options [::Gapic::CallOptions]
125
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
126
+ #
127
+ # @yield [result, operation] Access the result along with the TransportOperation object
128
+ # @yieldparam result [::Google::Longrunning::Operation]
129
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
130
+ #
131
+ # @return [::Google::Longrunning::Operation]
132
+ # A result object deserialized from the server's reply
133
+ def create_connectivity_test request_pb, options = nil
134
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
135
+
136
+ verb, uri, query_string_params, body = ServiceStub.transcode_create_connectivity_test_request request_pb
137
+ query_string_params = if query_string_params.any?
138
+ query_string_params.to_h { |p| p.split("=", 2) }
139
+ else
140
+ {}
141
+ end
142
+
143
+ response = @client_stub.make_http_request(
144
+ verb,
145
+ uri: uri,
146
+ body: body || "",
147
+ params: query_string_params,
148
+ options: options
149
+ )
150
+ operation = ::Gapic::Rest::TransportOperation.new response
151
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
152
+
153
+ yield result, operation if block_given?
154
+ result
155
+ end
156
+
157
+ ##
158
+ # Baseline implementation for the update_connectivity_test REST call
159
+ #
160
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::UpdateConnectivityTestRequest]
161
+ # A request object representing the call parameters. Required.
162
+ # @param options [::Gapic::CallOptions]
163
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
164
+ #
165
+ # @yield [result, operation] Access the result along with the TransportOperation object
166
+ # @yieldparam result [::Google::Longrunning::Operation]
167
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
168
+ #
169
+ # @return [::Google::Longrunning::Operation]
170
+ # A result object deserialized from the server's reply
171
+ def update_connectivity_test request_pb, options = nil
172
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
173
+
174
+ verb, uri, query_string_params, body = ServiceStub.transcode_update_connectivity_test_request request_pb
175
+ query_string_params = if query_string_params.any?
176
+ query_string_params.to_h { |p| p.split("=", 2) }
177
+ else
178
+ {}
179
+ end
180
+
181
+ response = @client_stub.make_http_request(
182
+ verb,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ options: options
187
+ )
188
+ operation = ::Gapic::Rest::TransportOperation.new response
189
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
190
+
191
+ yield result, operation if block_given?
192
+ result
193
+ end
194
+
195
+ ##
196
+ # Baseline implementation for the rerun_connectivity_test REST call
197
+ #
198
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::RerunConnectivityTestRequest]
199
+ # A request object representing the call parameters. Required.
200
+ # @param options [::Gapic::CallOptions]
201
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
202
+ #
203
+ # @yield [result, operation] Access the result along with the TransportOperation object
204
+ # @yieldparam result [::Google::Longrunning::Operation]
205
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
206
+ #
207
+ # @return [::Google::Longrunning::Operation]
208
+ # A result object deserialized from the server's reply
209
+ def rerun_connectivity_test request_pb, options = nil
210
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
211
+
212
+ verb, uri, query_string_params, body = ServiceStub.transcode_rerun_connectivity_test_request request_pb
213
+ query_string_params = if query_string_params.any?
214
+ query_string_params.to_h { |p| p.split("=", 2) }
215
+ else
216
+ {}
217
+ end
218
+
219
+ response = @client_stub.make_http_request(
220
+ verb,
221
+ uri: uri,
222
+ body: body || "",
223
+ params: query_string_params,
224
+ options: options
225
+ )
226
+ operation = ::Gapic::Rest::TransportOperation.new response
227
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
228
+
229
+ yield result, operation if block_given?
230
+ result
231
+ end
232
+
233
+ ##
234
+ # Baseline implementation for the delete_connectivity_test REST call
235
+ #
236
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::DeleteConnectivityTestRequest]
237
+ # A request object representing the call parameters. Required.
238
+ # @param options [::Gapic::CallOptions]
239
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
240
+ #
241
+ # @yield [result, operation] Access the result along with the TransportOperation object
242
+ # @yieldparam result [::Google::Longrunning::Operation]
243
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
244
+ #
245
+ # @return [::Google::Longrunning::Operation]
246
+ # A result object deserialized from the server's reply
247
+ def delete_connectivity_test request_pb, options = nil
248
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
249
+
250
+ verb, uri, query_string_params, body = ServiceStub.transcode_delete_connectivity_test_request request_pb
251
+ query_string_params = if query_string_params.any?
252
+ query_string_params.to_h { |p| p.split("=", 2) }
253
+ else
254
+ {}
255
+ end
256
+
257
+ response = @client_stub.make_http_request(
258
+ verb,
259
+ uri: uri,
260
+ body: body || "",
261
+ params: query_string_params,
262
+ options: options
263
+ )
264
+ operation = ::Gapic::Rest::TransportOperation.new response
265
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
266
+
267
+ yield result, operation if block_given?
268
+ result
269
+ end
270
+
271
+ ##
272
+ # @private
273
+ #
274
+ # GRPC transcoding helper method for the list_connectivity_tests REST call
275
+ #
276
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::ListConnectivityTestsRequest]
277
+ # A request object representing the call parameters. Required.
278
+ # @return [Array(String, [String, nil], Hash{String => String})]
279
+ # Uri, Body, Query string parameters
280
+ def self.transcode_list_connectivity_tests_request request_pb
281
+ transcoder = Gapic::Rest::GrpcTranscoder.new
282
+ .with_bindings(
283
+ uri_method: :get,
284
+ uri_template: "/v1/{parent}/connectivityTests",
285
+ matches: [
286
+ ["parent", %r{^projects/[^/]+/locations/global/?$}, false]
287
+ ]
288
+ )
289
+ transcoder.transcode request_pb
290
+ end
291
+
292
+ ##
293
+ # @private
294
+ #
295
+ # GRPC transcoding helper method for the get_connectivity_test REST call
296
+ #
297
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::GetConnectivityTestRequest]
298
+ # A request object representing the call parameters. Required.
299
+ # @return [Array(String, [String, nil], Hash{String => String})]
300
+ # Uri, Body, Query string parameters
301
+ def self.transcode_get_connectivity_test_request request_pb
302
+ transcoder = Gapic::Rest::GrpcTranscoder.new
303
+ .with_bindings(
304
+ uri_method: :get,
305
+ uri_template: "/v1/{name}",
306
+ matches: [
307
+ ["name", %r{^projects/[^/]+/locations/global/connectivityTests/[^/]+/?$}, false]
308
+ ]
309
+ )
310
+ transcoder.transcode request_pb
311
+ end
312
+
313
+ ##
314
+ # @private
315
+ #
316
+ # GRPC transcoding helper method for the create_connectivity_test REST call
317
+ #
318
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::CreateConnectivityTestRequest]
319
+ # A request object representing the call parameters. Required.
320
+ # @return [Array(String, [String, nil], Hash{String => String})]
321
+ # Uri, Body, Query string parameters
322
+ def self.transcode_create_connectivity_test_request request_pb
323
+ transcoder = Gapic::Rest::GrpcTranscoder.new
324
+ .with_bindings(
325
+ uri_method: :post,
326
+ uri_template: "/v1/{parent}/connectivityTests",
327
+ body: "resource",
328
+ matches: [
329
+ ["parent", %r{^projects/[^/]+/locations/global/?$}, false]
330
+ ]
331
+ )
332
+ transcoder.transcode request_pb
333
+ end
334
+
335
+ ##
336
+ # @private
337
+ #
338
+ # GRPC transcoding helper method for the update_connectivity_test REST call
339
+ #
340
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::UpdateConnectivityTestRequest]
341
+ # A request object representing the call parameters. Required.
342
+ # @return [Array(String, [String, nil], Hash{String => String})]
343
+ # Uri, Body, Query string parameters
344
+ def self.transcode_update_connectivity_test_request request_pb
345
+ transcoder = Gapic::Rest::GrpcTranscoder.new
346
+ .with_bindings(
347
+ uri_method: :patch,
348
+ uri_template: "/v1/{resource.name}",
349
+ body: "resource",
350
+ matches: [
351
+ ["resource.name", %r{^projects/[^/]+/locations/global/connectivityTests/[^/]+/?$}, false]
352
+ ]
353
+ )
354
+ transcoder.transcode request_pb
355
+ end
356
+
357
+ ##
358
+ # @private
359
+ #
360
+ # GRPC transcoding helper method for the rerun_connectivity_test REST call
361
+ #
362
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::RerunConnectivityTestRequest]
363
+ # A request object representing the call parameters. Required.
364
+ # @return [Array(String, [String, nil], Hash{String => String})]
365
+ # Uri, Body, Query string parameters
366
+ def self.transcode_rerun_connectivity_test_request request_pb
367
+ transcoder = Gapic::Rest::GrpcTranscoder.new
368
+ .with_bindings(
369
+ uri_method: :post,
370
+ uri_template: "/v1/{name}:rerun",
371
+ body: "*",
372
+ matches: [
373
+ ["name", %r{^projects/[^/]+/locations/global/connectivityTests/[^/]+/?$}, false]
374
+ ]
375
+ )
376
+ transcoder.transcode request_pb
377
+ end
378
+
379
+ ##
380
+ # @private
381
+ #
382
+ # GRPC transcoding helper method for the delete_connectivity_test REST call
383
+ #
384
+ # @param request_pb [::Google::Cloud::NetworkManagement::V1::DeleteConnectivityTestRequest]
385
+ # A request object representing the call parameters. Required.
386
+ # @return [Array(String, [String, nil], Hash{String => String})]
387
+ # Uri, Body, Query string parameters
388
+ def self.transcode_delete_connectivity_test_request request_pb
389
+ transcoder = Gapic::Rest::GrpcTranscoder.new
390
+ .with_bindings(
391
+ uri_method: :delete,
392
+ uri_template: "/v1/{name}",
393
+ matches: [
394
+ ["name", %r{^projects/[^/]+/locations/global/connectivityTests/[^/]+/?$}, false]
395
+ ]
396
+ )
397
+ transcoder.transcode request_pb
398
+ end
399
+ end
400
+ end
401
+ end
402
+ end
403
+ end
404
+ end
405
+ end
@@ -0,0 +1,60 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/rest"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/network_management/v1/version"
24
+
25
+ require "google/cloud/network_management/v1/reachability_service/credentials"
26
+ require "google/cloud/network_management/v1/reachability_service/paths"
27
+ require "google/cloud/network_management/v1/reachability_service/rest/operations"
28
+ require "google/cloud/network_management/v1/reachability_service/rest/client"
29
+
30
+ module Google
31
+ module Cloud
32
+ module NetworkManagement
33
+ module V1
34
+ ##
35
+ # The Reachability service in the Google Cloud Network Management API provides
36
+ # services that analyze the reachability within a single Google Virtual Private
37
+ # Cloud (VPC) network, between peered VPC networks, between VPC and on-premises
38
+ # networks, or between VPC networks and internet hosts. A reachability analysis
39
+ # is based on Google Cloud network configurations.
40
+ #
41
+ # You can use the analysis results to verify these configurations and
42
+ # to troubleshoot connectivity issues.
43
+ #
44
+ # To load this service and instantiate a REST client:
45
+ #
46
+ # require "google/cloud/network_management/v1/reachability_service/rest"
47
+ # client = ::Google::Cloud::NetworkManagement::V1::ReachabilityService::Rest::Client.new
48
+ #
49
+ module ReachabilityService
50
+ # Client for the REST transport
51
+ module Rest
52
+ end
53
+ end
54
+ end
55
+ end
56
+ end
57
+ end
58
+
59
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
60
+ require "google/cloud/network_management/v1/reachability_service/rest/helpers" if ::File.file? helper_path
@@ -26,6 +26,7 @@ require "google/cloud/network_management/v1/reachability_service/credentials"
26
26
  require "google/cloud/network_management/v1/reachability_service/paths"
27
27
  require "google/cloud/network_management/v1/reachability_service/operations"
28
28
  require "google/cloud/network_management/v1/reachability_service/client"
29
+ require "google/cloud/network_management/v1/reachability_service/rest"
29
30
 
30
31
  module Google
31
32
  module Cloud
@@ -41,11 +42,16 @@ module Google
41
42
  # You can use the analysis results to verify these configurations and
42
43
  # to troubleshoot connectivity issues.
43
44
  #
44
- # To load this service and instantiate a client:
45
+ # @example Load this service and instantiate a gRPC client
45
46
  #
46
47
  # require "google/cloud/network_management/v1/reachability_service"
47
48
  # client = ::Google::Cloud::NetworkManagement::V1::ReachabilityService::Client.new
48
49
  #
50
+ # @example Load this service and instantiate a REST client
51
+ #
52
+ # require "google/cloud/network_management/v1/reachability_service/rest"
53
+ # client = ::Google::Cloud::NetworkManagement::V1::ReachabilityService::Rest::Client.new
54
+ #
49
55
  module ReachabilityService
50
56
  end
51
57
  end
@@ -0,0 +1,37 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/network_management/v1/reachability_service/rest"
20
+ require "google/cloud/network_management/v1/version"
21
+
22
+ module Google
23
+ module Cloud
24
+ module NetworkManagement
25
+ ##
26
+ # To load just the REST part of this package, including all its services, and instantiate a REST client:
27
+ #
28
+ # @example
29
+ #
30
+ # require "google/cloud/network_management/v1/rest"
31
+ # client = ::Google::Cloud::NetworkManagement::V1::ReachabilityService::Rest::Client.new
32
+ #
33
+ module V1
34
+ end
35
+ end
36
+ end
37
+ end
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module NetworkManagement
23
23
  module V1
24
- VERSION = "0.3.0"
24
+ VERSION = "0.5.0"
25
25
  end
26
26
  end
27
27
  end
@@ -23,13 +23,18 @@ module Google
23
23
  module Cloud
24
24
  module NetworkManagement
25
25
  ##
26
- # To load this package, including all its services, and instantiate a client:
26
+ # API client module.
27
27
  #
28
- # @example
28
+ # @example Load this package, including all its services, and instantiate a gRPC client
29
29
  #
30
30
  # require "google/cloud/network_management/v1"
31
31
  # client = ::Google::Cloud::NetworkManagement::V1::ReachabilityService::Client.new
32
32
  #
33
+ # @example Load this package, including all its services, and instantiate a REST client
34
+ #
35
+ # require "google/cloud/network_management/v1"
36
+ # client = ::Google::Cloud::NetworkManagement::V1::ReachabilityService::Rest::Client.new
37
+ #
33
38
  module V1
34
39
  end
35
40
  end
@@ -122,6 +122,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
122
122
  value :NEXT_HOP_INTERNET_GATEWAY, 8
123
123
  value :NEXT_HOP_BLACKHOLE, 9
124
124
  value :NEXT_HOP_ILB, 10
125
+ value :NEXT_HOP_ROUTER_APPLIANCE, 11
125
126
  end
126
127
  add_message "google.cloud.networkmanagement.v1.ForwardingRuleInfo" do
127
128
  optional :display_name, :string, 1
@@ -244,6 +245,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
244
245
  value :MISMATCHED_SOURCE_NETWORK, 12
245
246
  value :DESTINATION_ENDPOINT_NOT_FOUND, 13
246
247
  value :MISMATCHED_DESTINATION_NETWORK, 14
248
+ value :UNSUPPORTED, 15
247
249
  end
248
250
  add_message "google.cloud.networkmanagement.v1.DropInfo" do
249
251
  optional :cause, :enum, 1, "google.cloud.networkmanagement.v1.DropInfo.Cause"