google-cloud-network_connectivity-v1 0.7.0 → 0.9.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -21,11 +21,12 @@ module Google
21
21
  module Cloud
22
22
  module NetworkConnectivity
23
23
  module V1
24
- # A Network Connectivity Center hub is a collection of spokes. A single hub
25
- # can contain spokes from multiple regions. However, if any of a hub's spokes
26
- # use the data transfer feature, the resources associated with those spokes
27
- # must all reside in the same VPC network. Spokes that do not use data
28
- # transfer can be associated with any VPC network in your project.
24
+ # A Network Connectivity Center hub is a global management resource to which
25
+ # you attach spokes. A single hub can contain spokes from multiple regions.
26
+ # However, if any of a hub's spokes use the site-to-site data transfer feature,
27
+ # the resources associated with those spokes must all be in the same VPC
28
+ # network. Spokes that do not use site-to-site data transfer can be associated
29
+ # with any VPC network in your project.
29
30
  # @!attribute [rw] name
30
31
  # @return [::String]
31
32
  # Immutable. The name of the hub. Hub names must be unique. They use the
@@ -39,8 +40,8 @@ module Google
39
40
  # Output only. The time the hub was last updated.
40
41
  # @!attribute [rw] labels
41
42
  # @return [::Google::Protobuf::Map{::String => ::String}]
42
- # Optional labels in key:value format. For more information about labels, see
43
- # [Requirements for
43
+ # Optional labels in key-value pair format. For more information about
44
+ # labels, see [Requirements for
44
45
  # labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
45
46
  # @!attribute [rw] description
46
47
  # @return [::String]
@@ -59,6 +60,21 @@ module Google
59
60
  #
60
61
  # This field is read-only. Network Connectivity Center automatically
61
62
  # populates it based on the set of spokes attached to the hub.
63
+ # @!attribute [r] route_tables
64
+ # @return [::Array<::String>]
65
+ # Output only. The route tables that belong to this hub. They use the
66
+ # following form:
67
+ # `projects/{project_number}/locations/global/hubs/{hub_id}/routeTables/{route_table_id}`
68
+ #
69
+ # This field is read-only. Network Connectivity Center automatically
70
+ # populates it based on the route tables nested under the hub.
71
+ # @!attribute [r] spoke_summary
72
+ # @return [::Google::Cloud::NetworkConnectivity::V1::SpokeSummary]
73
+ # Output only. A summary of the spokes associated with a hub. The
74
+ # summary includes a count of spokes according to type
75
+ # and according to state. If any spokes are inactive,
76
+ # the summary also lists the reasons they are inactive,
77
+ # including a count for each reason.
62
78
  class Hub
63
79
  include ::Google::Protobuf::MessageExts
64
80
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -90,15 +106,16 @@ module Google
90
106
  extend ::Google::Protobuf::MessageExts::ClassMethods
91
107
  end
92
108
 
93
- # A Network Connectivity Center spoke represents a connection between your
94
- # Google Cloud network resources and a non-Google-Cloud network.
109
+ # A Network Connectivity Center spoke represents one or more network
110
+ # connectivity resources.
95
111
  #
96
- # When you create a spoke, you associate it with a hub. You must also identify
97
- # a value for exactly one of the following fields:
112
+ # When you create a spoke, you associate it with a hub. You must also
113
+ # identify a value for exactly one of the following fields:
98
114
  #
99
115
  # * linked_vpn_tunnels
100
116
  # * linked_interconnect_attachments
101
117
  # * linked_router_appliance_instances
118
+ # * linked_vpc_network
102
119
  # @!attribute [rw] name
103
120
  # @return [::String]
104
121
  # Immutable. The name of the spoke. Spoke names must be unique. They use the
@@ -112,8 +129,8 @@ module Google
112
129
  # Output only. The time the spoke was last updated.
113
130
  # @!attribute [rw] labels
114
131
  # @return [::Google::Protobuf::Map{::String => ::String}]
115
- # Optional labels in key:value format. For more information about labels, see
116
- # [Requirements for
132
+ # Optional labels in key-value pair format. For more information about
133
+ # labels, see [Requirements for
117
134
  # labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
118
135
  # @!attribute [rw] description
119
136
  # @return [::String]
@@ -121,6 +138,9 @@ module Google
121
138
  # @!attribute [rw] hub
122
139
  # @return [::String]
123
140
  # Immutable. The name of the hub that this spoke is attached to.
141
+ # @!attribute [rw] group
142
+ # @return [::String]
143
+ # Optional. The name of the group that this spoke is associated with.
124
144
  # @!attribute [rw] linked_vpn_tunnels
125
145
  # @return [::Google::Cloud::NetworkConnectivity::V1::LinkedVpnTunnels]
126
146
  # VPN tunnels that are associated with the spoke.
@@ -130,18 +150,210 @@ module Google
130
150
  # @!attribute [rw] linked_router_appliance_instances
131
151
  # @return [::Google::Cloud::NetworkConnectivity::V1::LinkedRouterApplianceInstances]
132
152
  # Router appliance instances that are associated with the spoke.
153
+ # @!attribute [rw] linked_vpc_network
154
+ # @return [::Google::Cloud::NetworkConnectivity::V1::LinkedVpcNetwork]
155
+ # Optional. VPC network that is associated with the spoke.
133
156
  # @!attribute [r] unique_id
134
157
  # @return [::String]
135
158
  # Output only. The Google-generated UUID for the spoke. This value is unique
136
159
  # across all spoke resources. If a spoke is deleted and another with the same
137
- # name is created, the new spoke is assigned a different unique_id.
160
+ # name is created, the new spoke is assigned a different `unique_id`.
138
161
  # @!attribute [r] state
139
162
  # @return [::Google::Cloud::NetworkConnectivity::V1::State]
140
163
  # Output only. The current lifecycle state of this spoke.
164
+ # @!attribute [r] reasons
165
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::Spoke::StateReason>]
166
+ # Output only. The reasons for current state of the spoke. Only present when
167
+ # the spoke is in the `INACTIVE` state.
168
+ # @!attribute [r] spoke_type
169
+ # @return [::Google::Cloud::NetworkConnectivity::V1::SpokeType]
170
+ # Output only. The type of resource associated with the spoke.
141
171
  class Spoke
142
172
  include ::Google::Protobuf::MessageExts
143
173
  extend ::Google::Protobuf::MessageExts::ClassMethods
144
174
 
175
+ # The reason a spoke is inactive.
176
+ # @!attribute [rw] code
177
+ # @return [::Google::Cloud::NetworkConnectivity::V1::Spoke::StateReason::Code]
178
+ # The code associated with this reason.
179
+ # @!attribute [rw] message
180
+ # @return [::String]
181
+ # Human-readable details about this reason.
182
+ # @!attribute [rw] user_details
183
+ # @return [::String]
184
+ # Additional information provided by the user in the RejectSpoke call.
185
+ class StateReason
186
+ include ::Google::Protobuf::MessageExts
187
+ extend ::Google::Protobuf::MessageExts::ClassMethods
188
+
189
+ # The Code enum represents the various reasons a state can be `INACTIVE`.
190
+ module Code
191
+ # No information available.
192
+ CODE_UNSPECIFIED = 0
193
+
194
+ # The proposed spoke is pending review.
195
+ PENDING_REVIEW = 1
196
+
197
+ # The proposed spoke has been rejected by the hub administrator.
198
+ REJECTED = 2
199
+
200
+ # The spoke has been deactivated internally.
201
+ PAUSED = 3
202
+
203
+ # Network Connectivity Center encountered errors while accepting
204
+ # the spoke.
205
+ FAILED = 4
206
+ end
207
+ end
208
+
209
+ # @!attribute [rw] key
210
+ # @return [::String]
211
+ # @!attribute [rw] value
212
+ # @return [::String]
213
+ class LabelsEntry
214
+ include ::Google::Protobuf::MessageExts
215
+ extend ::Google::Protobuf::MessageExts::ClassMethods
216
+ end
217
+ end
218
+
219
+ # @!attribute [rw] name
220
+ # @return [::String]
221
+ # Immutable. The name of the route table. Route table names must be unique.
222
+ # They use the following form:
223
+ # `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{route_table_id}`
224
+ # @!attribute [r] create_time
225
+ # @return [::Google::Protobuf::Timestamp]
226
+ # Output only. The time the route table was created.
227
+ # @!attribute [r] update_time
228
+ # @return [::Google::Protobuf::Timestamp]
229
+ # Output only. The time the route table was last updated.
230
+ # @!attribute [rw] labels
231
+ # @return [::Google::Protobuf::Map{::String => ::String}]
232
+ # Optional labels in key-value pair format. For more information about
233
+ # labels, see [Requirements for
234
+ # labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
235
+ # @!attribute [rw] description
236
+ # @return [::String]
237
+ # An optional description of the route table.
238
+ # @!attribute [r] uid
239
+ # @return [::String]
240
+ # Output only. The Google-generated UUID for the route table. This value is
241
+ # unique across all route table resources. If a route table is deleted and
242
+ # another with the same name is created, the new route table is assigned
243
+ # a different `uid`.
244
+ # @!attribute [r] state
245
+ # @return [::Google::Cloud::NetworkConnectivity::V1::State]
246
+ # Output only. The current lifecycle state of this route table.
247
+ class RouteTable
248
+ include ::Google::Protobuf::MessageExts
249
+ extend ::Google::Protobuf::MessageExts::ClassMethods
250
+
251
+ # @!attribute [rw] key
252
+ # @return [::String]
253
+ # @!attribute [rw] value
254
+ # @return [::String]
255
+ class LabelsEntry
256
+ include ::Google::Protobuf::MessageExts
257
+ extend ::Google::Protobuf::MessageExts::ClassMethods
258
+ end
259
+ end
260
+
261
+ # A route defines a path from VM instances within a spoke to a specific
262
+ # destination resource. Only VPC spokes have routes.
263
+ # @!attribute [rw] name
264
+ # @return [::String]
265
+ # Immutable. The name of the route. Route names must be unique. Route names
266
+ # use the following form:
267
+ # `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{route_table_id}/routes/{route_id}`
268
+ # @!attribute [r] create_time
269
+ # @return [::Google::Protobuf::Timestamp]
270
+ # Output only. The time the route was created.
271
+ # @!attribute [r] update_time
272
+ # @return [::Google::Protobuf::Timestamp]
273
+ # Output only. The time the route was last updated.
274
+ # @!attribute [rw] ip_cidr_range
275
+ # @return [::String]
276
+ # The destination IP address range.
277
+ # @!attribute [r] type
278
+ # @return [::Google::Cloud::NetworkConnectivity::V1::RouteType]
279
+ # Output only. The route's type. Its type is determined by the properties of
280
+ # its IP address range.
281
+ # @!attribute [rw] next_hop_vpc_network
282
+ # @return [::Google::Cloud::NetworkConnectivity::V1::NextHopVpcNetwork]
283
+ # Immutable. The destination VPC network for packets on this route.
284
+ # @!attribute [rw] labels
285
+ # @return [::Google::Protobuf::Map{::String => ::String}]
286
+ # Optional labels in key-value pair format. For more information about
287
+ # labels, see [Requirements for
288
+ # labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
289
+ # @!attribute [rw] description
290
+ # @return [::String]
291
+ # An optional description of the route.
292
+ # @!attribute [r] uid
293
+ # @return [::String]
294
+ # Output only. The Google-generated UUID for the route. This value is unique
295
+ # across all Network Connectivity Center route resources. If a
296
+ # route is deleted and another with the same name is created,
297
+ # the new route is assigned a different `uid`.
298
+ # @!attribute [r] state
299
+ # @return [::Google::Cloud::NetworkConnectivity::V1::State]
300
+ # Output only. The current lifecycle state of the route.
301
+ # @!attribute [rw] spoke
302
+ # @return [::String]
303
+ # Immutable. The spoke that this route leads to.
304
+ # Example: projects/12345/locations/global/spokes/SPOKE
305
+ # @!attribute [r] location
306
+ # @return [::String]
307
+ # Output only. The location of the route.
308
+ # Uses the following form: "projects/\\{project}/locations/\\{location}"
309
+ # Example: projects/1234/locations/us-central1
310
+ class Route
311
+ include ::Google::Protobuf::MessageExts
312
+ extend ::Google::Protobuf::MessageExts::ClassMethods
313
+
314
+ # @!attribute [rw] key
315
+ # @return [::String]
316
+ # @!attribute [rw] value
317
+ # @return [::String]
318
+ class LabelsEntry
319
+ include ::Google::Protobuf::MessageExts
320
+ extend ::Google::Protobuf::MessageExts::ClassMethods
321
+ end
322
+ end
323
+
324
+ # A group represents a subset of spokes attached to a hub.
325
+ # @!attribute [rw] name
326
+ # @return [::String]
327
+ # Immutable. The name of the group. Group names must be unique. They
328
+ # use the following form:
329
+ # `projects/{project_number}/locations/global/hubs/{hub}/groups/{group_id}`
330
+ # @!attribute [r] create_time
331
+ # @return [::Google::Protobuf::Timestamp]
332
+ # Output only. The time the group was created.
333
+ # @!attribute [r] update_time
334
+ # @return [::Google::Protobuf::Timestamp]
335
+ # Output only. The time the group was last updated.
336
+ # @!attribute [rw] labels
337
+ # @return [::Google::Protobuf::Map{::String => ::String}]
338
+ # Optional. Labels in key-value pair format. For more information about
339
+ # labels, see [Requirements for
340
+ # labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
341
+ # @!attribute [rw] description
342
+ # @return [::String]
343
+ # Optional. The description of the group.
344
+ # @!attribute [r] uid
345
+ # @return [::String]
346
+ # Output only. The Google-generated UUID for the group. This value is unique
347
+ # across all group resources. If a group is deleted and
348
+ # another with the same name is created, the new route table is assigned
349
+ # a different unique_id.
350
+ # @!attribute [r] state
351
+ # @return [::Google::Cloud::NetworkConnectivity::V1::State]
352
+ # Output only. The current lifecycle state of this group.
353
+ class Group
354
+ include ::Google::Protobuf::MessageExts
355
+ extend ::Google::Protobuf::MessageExts::ClassMethods
356
+
145
357
  # @!attribute [rw] key
146
358
  # @return [::String]
147
359
  # @!attribute [rw] value
@@ -160,13 +372,13 @@ module Google
160
372
  # Required. The parent resource's name.
161
373
  # @!attribute [rw] page_size
162
374
  # @return [::Integer]
163
- # The maximum number of results per page that should be returned.
375
+ # The maximum number of results per page to return.
164
376
  # @!attribute [rw] page_token
165
377
  # @return [::String]
166
378
  # The page token.
167
379
  # @!attribute [rw] filter
168
380
  # @return [::String]
169
- # An expression that filters the results listed in the response.
381
+ # An expression that filters the list of results.
170
382
  # @!attribute [rw] order_by
171
383
  # @return [::String]
172
384
  # Sort the results by a certain order.
@@ -183,8 +395,9 @@ module Google
183
395
  # The requested hubs.
184
396
  # @!attribute [rw] next_page_token
185
397
  # @return [::String]
186
- # The next pagination token in the List response. It should be used as
187
- # page_token for the following request. An empty value means no more result.
398
+ # The token for the next page of the response. To see more results,
399
+ # use this value as the page_token for your next request. If this value
400
+ # is empty, there are no more results.
188
401
  # @!attribute [rw] unreachable
189
402
  # @return [::Array<::String>]
190
403
  # Locations that could not be reached.
@@ -218,11 +431,11 @@ module Google
218
431
  # Required. The initial values for a new hub.
219
432
  # @!attribute [rw] request_id
220
433
  # @return [::String]
221
- # Optional. A unique request ID (optional). If you specify this ID, you can
222
- # use it in cases when you need to retry your request. When you need to
223
- # retry, this ID lets the server know that it can ignore the request if it
224
- # has already been completed. The server guarantees that for at least 60
225
- # minutes after the first request.
434
+ # Optional. A request ID to identify requests. Specify a unique request ID so
435
+ # that if you must retry your request, the server knows to ignore the request
436
+ # if it has already been completed. The server guarantees that a request
437
+ # doesn't result in creation of duplicate commitments for at least 60
438
+ # minutes.
226
439
  #
227
440
  # For example, consider a situation where you make an initial request and
228
441
  # the request times out. If you make the request again with the same request
@@ -252,11 +465,11 @@ module Google
252
465
  # Required. The state that the hub should be in after the update.
253
466
  # @!attribute [rw] request_id
254
467
  # @return [::String]
255
- # Optional. A unique request ID (optional). If you specify this ID, you can
256
- # use it in cases when you need to retry your request. When you need to
257
- # retry, this ID lets the server know that it can ignore the request if it
258
- # has already been completed. The server guarantees that for at least 60
259
- # minutes after the first request.
468
+ # Optional. A request ID to identify requests. Specify a unique request ID so
469
+ # that if you must retry your request, the server knows to ignore the request
470
+ # if it has already been completed. The server guarantees that a request
471
+ # doesn't result in creation of duplicate commitments for at least 60
472
+ # minutes.
260
473
  #
261
474
  # For example, consider a situation where you make an initial request and
262
475
  # the request times out. If you make the request again with the same request
@@ -278,11 +491,11 @@ module Google
278
491
  # Required. The name of the hub to delete.
279
492
  # @!attribute [rw] request_id
280
493
  # @return [::String]
281
- # Optional. A unique request ID (optional). If you specify this ID, you can
282
- # use it in cases when you need to retry your request. When you need to
283
- # retry, this ID lets the server know that it can ignore the request if it
284
- # has already been completed. The server guarantees that for at least 60
285
- # minutes after the first request.
494
+ # Optional. A request ID to identify requests. Specify a unique request ID so
495
+ # that if you must retry your request, the server knows to ignore the request
496
+ # if it has already been completed. The server guarantees that a request
497
+ # doesn't result in creation of duplicate commitments for at least 60
498
+ # minutes.
286
499
  #
287
500
  # For example, consider a situation where you make an initial request and
288
501
  # the request times out. If you make the request again with the same request
@@ -297,6 +510,79 @@ module Google
297
510
  extend ::Google::Protobuf::MessageExts::ClassMethods
298
511
  end
299
512
 
513
+ # The request for
514
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_hub_spokes HubService.ListHubSpokes}.
515
+ # @!attribute [rw] name
516
+ # @return [::String]
517
+ # Required. The name of the hub.
518
+ # @!attribute [rw] spoke_locations
519
+ # @return [::Array<::String>]
520
+ # A list of locations.
521
+ # Specify one of the following: `[global]`, a single region (for
522
+ # example, `[us-central1]`), or a combination of
523
+ # values (for example, `[global, us-central1, us-west1]`).
524
+ # If the spoke_locations field is populated, the list of results
525
+ # includes only spokes in the specified location.
526
+ # If the spoke_locations field is not populated, the list of results
527
+ # includes spokes in all locations.
528
+ # @!attribute [rw] page_size
529
+ # @return [::Integer]
530
+ # The maximum number of results to return per page.
531
+ # @!attribute [rw] page_token
532
+ # @return [::String]
533
+ # The page token.
534
+ # @!attribute [rw] filter
535
+ # @return [::String]
536
+ # An expression that filters the list of results.
537
+ # @!attribute [rw] order_by
538
+ # @return [::String]
539
+ # Sort the results by name or create_time.
540
+ # @!attribute [rw] view
541
+ # @return [::Google::Cloud::NetworkConnectivity::V1::ListHubSpokesRequest::SpokeView]
542
+ # The view of the spoke to return.
543
+ # The view that you use determines which spoke fields are included in the
544
+ # response.
545
+ class ListHubSpokesRequest
546
+ include ::Google::Protobuf::MessageExts
547
+ extend ::Google::Protobuf::MessageExts::ClassMethods
548
+
549
+ # Enum that controls which spoke fields are included in the response.
550
+ module SpokeView
551
+ # The spoke view is unspecified. When the spoke view is unspecified, the
552
+ # API returns the same fields as the `BASIC` view.
553
+ SPOKE_VIEW_UNSPECIFIED = 0
554
+
555
+ # Includes `name`, `create_time`, `hub`, `unique_id`, `state`, `reasons`,
556
+ # and `spoke_type`. This is the default value.
557
+ BASIC = 1
558
+
559
+ # Includes all spoke fields except `labels`.
560
+ # You can use the `DETAILED` view only when you set the `spoke_locations`
561
+ # field to `[global]`.
562
+ DETAILED = 2
563
+ end
564
+ end
565
+
566
+ # The response for
567
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_hub_spokes HubService.ListHubSpokes}.
568
+ # @!attribute [rw] spokes
569
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::Spoke>]
570
+ # The requested spokes.
571
+ # The spoke fields can be partially populated based on the `view` field in
572
+ # the request message.
573
+ # @!attribute [rw] next_page_token
574
+ # @return [::String]
575
+ # The token for the next page of the response. To see more results,
576
+ # use this value as the page_token for your next request. If this value
577
+ # is empty, there are no more results.
578
+ # @!attribute [rw] unreachable
579
+ # @return [::Array<::String>]
580
+ # Locations that could not be reached.
581
+ class ListHubSpokesResponse
582
+ include ::Google::Protobuf::MessageExts
583
+ extend ::Google::Protobuf::MessageExts::ClassMethods
584
+ end
585
+
300
586
  # The request for
301
587
  # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_spokes HubService.ListSpokes}.
302
588
  # @!attribute [rw] parent
@@ -304,13 +590,13 @@ module Google
304
590
  # Required. The parent resource.
305
591
  # @!attribute [rw] page_size
306
592
  # @return [::Integer]
307
- # The maximum number of results per page that should be returned.
593
+ # The maximum number of results to return per page.
308
594
  # @!attribute [rw] page_token
309
595
  # @return [::String]
310
596
  # The page token.
311
597
  # @!attribute [rw] filter
312
598
  # @return [::String]
313
- # An expression that filters the results listed in the response.
599
+ # An expression that filters the list of results.
314
600
  # @!attribute [rw] order_by
315
601
  # @return [::String]
316
602
  # Sort the results by a certain order.
@@ -326,8 +612,9 @@ module Google
326
612
  # The requested spokes.
327
613
  # @!attribute [rw] next_page_token
328
614
  # @return [::String]
329
- # The next pagination token in the List response. It should be used as
330
- # page_token for the following request. An empty value means no more result.
615
+ # The token for the next page of the response. To see more results,
616
+ # use this value as the page_token for your next request. If this value
617
+ # is empty, there are no more results.
331
618
  # @!attribute [rw] unreachable
332
619
  # @return [::Array<::String>]
333
620
  # Locations that could not be reached.
@@ -359,11 +646,11 @@ module Google
359
646
  # Required. The initial values for a new spoke.
360
647
  # @!attribute [rw] request_id
361
648
  # @return [::String]
362
- # Optional. A unique request ID (optional). If you specify this ID, you can
363
- # use it in cases when you need to retry your request. When you need to
364
- # retry, this ID lets the server know that it can ignore the request if it
365
- # has already been completed. The server guarantees that for at least 60
366
- # minutes after the first request.
649
+ # Optional. A request ID to identify requests. Specify a unique request ID so
650
+ # that if you must retry your request, the server knows to ignore the request
651
+ # if it has already been completed. The server guarantees that a request
652
+ # doesn't result in creation of duplicate commitments for at least 60
653
+ # minutes.
367
654
  #
368
655
  # For example, consider a situation where you make an initial request and
369
656
  # the request times out. If you make the request again with the same request
@@ -393,11 +680,11 @@ module Google
393
680
  # Required. The state that the spoke should be in after the update.
394
681
  # @!attribute [rw] request_id
395
682
  # @return [::String]
396
- # Optional. A unique request ID (optional). If you specify this ID, you can
397
- # use it in cases when you need to retry your request. When you need to
398
- # retry, this ID lets the server know that it can ignore the request if it
399
- # has already been completed. The server guarantees that for at least 60
400
- # minutes after the first request.
683
+ # Optional. A request ID to identify requests. Specify a unique request ID so
684
+ # that if you must retry your request, the server knows to ignore the request
685
+ # if it has already been completed. The server guarantees that a request
686
+ # doesn't result in creation of duplicate commitments for at least 60
687
+ # minutes.
401
688
  #
402
689
  # For example, consider a situation where you make an initial request and
403
690
  # the request times out. If you make the request again with the same request
@@ -419,11 +706,11 @@ module Google
419
706
  # Required. The name of the spoke to delete.
420
707
  # @!attribute [rw] request_id
421
708
  # @return [::String]
422
- # Optional. A unique request ID (optional). If you specify this ID, you can
423
- # use it in cases when you need to retry your request. When you need to
424
- # retry, this ID lets the server know that it can ignore the request if it
425
- # has already been completed. The server guarantees that for at least 60
426
- # minutes after the first request.
709
+ # Optional. A request ID to identify requests. Specify a unique request ID so
710
+ # that if you must retry your request, the server knows to ignore the request
711
+ # if it has already been completed. The server guarantees that a request
712
+ # doesn't result in creation of duplicate commitments for at least 60
713
+ # minutes.
427
714
  #
428
715
  # For example, consider a situation where you make an initial request and
429
716
  # the request times out. If you make the request again with the same request
@@ -438,6 +725,233 @@ module Google
438
725
  extend ::Google::Protobuf::MessageExts::ClassMethods
439
726
  end
440
727
 
728
+ # The request for
729
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#accept_hub_spoke HubService.AcceptHubSpoke}.
730
+ # @!attribute [rw] name
731
+ # @return [::String]
732
+ # Required. The name of the hub into which to accept the spoke.
733
+ # @!attribute [rw] spoke_uri
734
+ # @return [::String]
735
+ # Required. The URI of the spoke to accept into the hub.
736
+ # @!attribute [rw] request_id
737
+ # @return [::String]
738
+ # Optional. A request ID to identify requests. Specify a unique request ID so
739
+ # that if you must retry your request, the server knows to ignore the request
740
+ # if it has already been completed. The server guarantees that a request
741
+ # doesn't result in creation of duplicate commitments for at least 60
742
+ # minutes.
743
+ #
744
+ # For example, consider a situation where you make an initial request and
745
+ # the request times out. If you make the request again with the same request
746
+ # ID, the server can check to see whether the original operation
747
+ # was received. If it was, the server ignores the second request. This
748
+ # behavior prevents clients from mistakenly creating duplicate commitments.
749
+ #
750
+ # The request ID must be a valid UUID, with the exception that zero UUID is
751
+ # not supported (00000000-0000-0000-0000-000000000000).
752
+ class AcceptHubSpokeRequest
753
+ include ::Google::Protobuf::MessageExts
754
+ extend ::Google::Protobuf::MessageExts::ClassMethods
755
+ end
756
+
757
+ # The response for
758
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#accept_hub_spoke HubService.AcceptHubSpoke}.
759
+ # @!attribute [rw] spoke
760
+ # @return [::Google::Cloud::NetworkConnectivity::V1::Spoke]
761
+ # The spoke that was operated on.
762
+ class AcceptHubSpokeResponse
763
+ include ::Google::Protobuf::MessageExts
764
+ extend ::Google::Protobuf::MessageExts::ClassMethods
765
+ end
766
+
767
+ # The request for
768
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#reject_hub_spoke HubService.RejectHubSpoke}.
769
+ # @!attribute [rw] name
770
+ # @return [::String]
771
+ # Required. The name of the hub from which to reject the spoke.
772
+ # @!attribute [rw] spoke_uri
773
+ # @return [::String]
774
+ # Required. The URI of the spoke to reject from the hub.
775
+ # @!attribute [rw] request_id
776
+ # @return [::String]
777
+ # Optional. A request ID to identify requests. Specify a unique request ID so
778
+ # that if you must retry your request, the server knows to ignore the request
779
+ # if it has already been completed. The server guarantees that a request
780
+ # doesn't result in creation of duplicate commitments for at least 60
781
+ # minutes.
782
+ #
783
+ # For example, consider a situation where you make an initial request and
784
+ # the request times out. If you make the request again with the same request
785
+ # ID, the server can check to see whether the original operation
786
+ # was received. If it was, the server ignores the second request. This
787
+ # behavior prevents clients from mistakenly creating duplicate commitments.
788
+ #
789
+ # The request ID must be a valid UUID, with the exception that zero UUID is
790
+ # not supported (00000000-0000-0000-0000-000000000000).
791
+ # @!attribute [rw] details
792
+ # @return [::String]
793
+ # Optional. Additional information provided by the hub administrator.
794
+ class RejectHubSpokeRequest
795
+ include ::Google::Protobuf::MessageExts
796
+ extend ::Google::Protobuf::MessageExts::ClassMethods
797
+ end
798
+
799
+ # The response for
800
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#reject_hub_spoke HubService.RejectHubSpoke}.
801
+ # @!attribute [rw] spoke
802
+ # @return [::Google::Cloud::NetworkConnectivity::V1::Spoke]
803
+ # The spoke that was operated on.
804
+ class RejectHubSpokeResponse
805
+ include ::Google::Protobuf::MessageExts
806
+ extend ::Google::Protobuf::MessageExts::ClassMethods
807
+ end
808
+
809
+ # The request for
810
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#get_route_table HubService.GetRouteTable}.
811
+ # @!attribute [rw] name
812
+ # @return [::String]
813
+ # Required. The name of the route table resource.
814
+ class GetRouteTableRequest
815
+ include ::Google::Protobuf::MessageExts
816
+ extend ::Google::Protobuf::MessageExts::ClassMethods
817
+ end
818
+
819
+ # The request for
820
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#get_route HubService.GetRoute}.
821
+ # @!attribute [rw] name
822
+ # @return [::String]
823
+ # Required. The name of the route resource.
824
+ class GetRouteRequest
825
+ include ::Google::Protobuf::MessageExts
826
+ extend ::Google::Protobuf::MessageExts::ClassMethods
827
+ end
828
+
829
+ # Request for
830
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_routes HubService.ListRoutes}
831
+ # method.
832
+ # @!attribute [rw] parent
833
+ # @return [::String]
834
+ # Required. The parent resource's name.
835
+ # @!attribute [rw] page_size
836
+ # @return [::Integer]
837
+ # The maximum number of results to return per page.
838
+ # @!attribute [rw] page_token
839
+ # @return [::String]
840
+ # The page token.
841
+ # @!attribute [rw] filter
842
+ # @return [::String]
843
+ # An expression that filters the list of results.
844
+ # @!attribute [rw] order_by
845
+ # @return [::String]
846
+ # Sort the results by a certain order.
847
+ class ListRoutesRequest
848
+ include ::Google::Protobuf::MessageExts
849
+ extend ::Google::Protobuf::MessageExts::ClassMethods
850
+ end
851
+
852
+ # Response for
853
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_routes HubService.ListRoutes}
854
+ # method.
855
+ # @!attribute [rw] routes
856
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::Route>]
857
+ # The requested routes.
858
+ # @!attribute [rw] next_page_token
859
+ # @return [::String]
860
+ # The token for the next page of the response. To see more results,
861
+ # use this value as the page_token for your next request. If this value
862
+ # is empty, there are no more results.
863
+ # @!attribute [rw] unreachable
864
+ # @return [::Array<::String>]
865
+ # RouteTables that could not be reached.
866
+ class ListRoutesResponse
867
+ include ::Google::Protobuf::MessageExts
868
+ extend ::Google::Protobuf::MessageExts::ClassMethods
869
+ end
870
+
871
+ # Request for
872
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_route_tables HubService.ListRouteTables}
873
+ # method.
874
+ # @!attribute [rw] parent
875
+ # @return [::String]
876
+ # Required. The parent resource's name.
877
+ # @!attribute [rw] page_size
878
+ # @return [::Integer]
879
+ # The maximum number of results to return per page.
880
+ # @!attribute [rw] page_token
881
+ # @return [::String]
882
+ # The page token.
883
+ # @!attribute [rw] filter
884
+ # @return [::String]
885
+ # An expression that filters the list of results.
886
+ # @!attribute [rw] order_by
887
+ # @return [::String]
888
+ # Sort the results by a certain order.
889
+ class ListRouteTablesRequest
890
+ include ::Google::Protobuf::MessageExts
891
+ extend ::Google::Protobuf::MessageExts::ClassMethods
892
+ end
893
+
894
+ # Response for
895
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_route_tables HubService.ListRouteTables}
896
+ # method.
897
+ # @!attribute [rw] route_tables
898
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::RouteTable>]
899
+ # The requested route tables.
900
+ # @!attribute [rw] next_page_token
901
+ # @return [::String]
902
+ # The token for the next page of the response. To see more results,
903
+ # use this value as the page_token for your next request. If this value
904
+ # is empty, there are no more results.
905
+ # @!attribute [rw] unreachable
906
+ # @return [::Array<::String>]
907
+ # Hubs that could not be reached.
908
+ class ListRouteTablesResponse
909
+ include ::Google::Protobuf::MessageExts
910
+ extend ::Google::Protobuf::MessageExts::ClassMethods
911
+ end
912
+
913
+ # Request for
914
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_groups HubService.ListGroups}
915
+ # method.
916
+ # @!attribute [rw] parent
917
+ # @return [::String]
918
+ # Required. The parent resource's name.
919
+ # @!attribute [rw] page_size
920
+ # @return [::Integer]
921
+ # The maximum number of results to return per page.
922
+ # @!attribute [rw] page_token
923
+ # @return [::String]
924
+ # The page token.
925
+ # @!attribute [rw] filter
926
+ # @return [::String]
927
+ # An expression that filters the list of results.
928
+ # @!attribute [rw] order_by
929
+ # @return [::String]
930
+ # Sort the results by a certain order.
931
+ class ListGroupsRequest
932
+ include ::Google::Protobuf::MessageExts
933
+ extend ::Google::Protobuf::MessageExts::ClassMethods
934
+ end
935
+
936
+ # Response for
937
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#list_groups HubService.ListGroups}
938
+ # method.
939
+ # @!attribute [rw] groups
940
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::Group>]
941
+ # The requested groups.
942
+ # @!attribute [rw] next_page_token
943
+ # @return [::String]
944
+ # The token for the next page of the response. To see more results,
945
+ # use this value as the page_token for your next request. If this value
946
+ # is empty, there are no more results.
947
+ # @!attribute [rw] unreachable
948
+ # @return [::Array<::String>]
949
+ # Hubs that could not be reached.
950
+ class ListGroupsResponse
951
+ include ::Google::Protobuf::MessageExts
952
+ extend ::Google::Protobuf::MessageExts::ClassMethods
953
+ end
954
+
441
955
  # A collection of Cloud VPN tunnel resources. These resources should be
442
956
  # redundant HA VPN tunnels that all advertise the same prefixes to Google
443
957
  # Cloud. Alternatively, in a passive/active configuration, all tunnels
@@ -499,6 +1013,18 @@ module Google
499
1013
  extend ::Google::Protobuf::MessageExts::ClassMethods
500
1014
  end
501
1015
 
1016
+ # An existing VPC network.
1017
+ # @!attribute [rw] uri
1018
+ # @return [::String]
1019
+ # Required. The URI of the VPC network resource.
1020
+ # @!attribute [rw] exclude_export_ranges
1021
+ # @return [::Array<::String>]
1022
+ # Optional. IP ranges encompassing the subnets to be excluded from peering.
1023
+ class LinkedVpcNetwork
1024
+ include ::Google::Protobuf::MessageExts
1025
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1026
+ end
1027
+
502
1028
  # A router appliance instance is a Compute Engine virtual machine (VM) instance
503
1029
  # that acts as a BGP speaker. A router appliance instance is specified by the
504
1030
  # URI of the VM and the internal IP address of one of the VM's network
@@ -523,6 +1049,88 @@ module Google
523
1049
  extend ::Google::Protobuf::MessageExts::ClassMethods
524
1050
  end
525
1051
 
1052
+ # @!attribute [rw] uri
1053
+ # @return [::String]
1054
+ # The URI of the VPC network resource
1055
+ class NextHopVpcNetwork
1056
+ include ::Google::Protobuf::MessageExts
1057
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1058
+ end
1059
+
1060
+ # Summarizes information about the spokes associated with a hub.
1061
+ # The summary includes a count of spokes according to type
1062
+ # and according to state. If any spokes are inactive,
1063
+ # the summary also lists the reasons they are inactive,
1064
+ # including a count for each reason.
1065
+ # @!attribute [r] spoke_type_counts
1066
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::SpokeSummary::SpokeTypeCount>]
1067
+ # Output only. Counts the number of spokes of each type that are
1068
+ # associated with a specific hub.
1069
+ # @!attribute [r] spoke_state_counts
1070
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::SpokeSummary::SpokeStateCount>]
1071
+ # Output only. Counts the number of spokes that are in each state
1072
+ # and associated with a given hub.
1073
+ # @!attribute [r] spoke_state_reason_counts
1074
+ # @return [::Array<::Google::Cloud::NetworkConnectivity::V1::SpokeSummary::SpokeStateReasonCount>]
1075
+ # Output only. Counts the number of spokes that are inactive for each
1076
+ # possible reason and associated with a given hub.
1077
+ class SpokeSummary
1078
+ include ::Google::Protobuf::MessageExts
1079
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1080
+
1081
+ # The number of spokes of a given type that are associated
1082
+ # with a specific hub. The type indicates what kind of
1083
+ # resource is associated with the spoke.
1084
+ # @!attribute [r] spoke_type
1085
+ # @return [::Google::Cloud::NetworkConnectivity::V1::SpokeType]
1086
+ # Output only. The type of the spokes.
1087
+ # @!attribute [r] count
1088
+ # @return [::Integer]
1089
+ # Output only. The total number of spokes of this type that are
1090
+ # associated with the hub.
1091
+ class SpokeTypeCount
1092
+ include ::Google::Protobuf::MessageExts
1093
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1094
+ end
1095
+
1096
+ # The number of spokes that are in a particular state
1097
+ # and associated with a given hub.
1098
+ # @!attribute [r] state
1099
+ # @return [::Google::Cloud::NetworkConnectivity::V1::State]
1100
+ # Output only. The state of the spokes.
1101
+ # @!attribute [r] count
1102
+ # @return [::Integer]
1103
+ # Output only. The total number of spokes that are in this state
1104
+ # and associated with a given hub.
1105
+ class SpokeStateCount
1106
+ include ::Google::Protobuf::MessageExts
1107
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1108
+ end
1109
+
1110
+ # The number of spokes in the hub that are inactive for this reason.
1111
+ # @!attribute [r] state_reason_code
1112
+ # @return [::Google::Cloud::NetworkConnectivity::V1::Spoke::StateReason::Code]
1113
+ # Output only. The reason that a spoke is inactive.
1114
+ # @!attribute [r] count
1115
+ # @return [::Integer]
1116
+ # Output only. The total number of spokes that are inactive for a
1117
+ # particular reason and associated with a given hub.
1118
+ class SpokeStateReasonCount
1119
+ include ::Google::Protobuf::MessageExts
1120
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1121
+ end
1122
+ end
1123
+
1124
+ # The request for
1125
+ # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#get_group HubService.GetGroup}.
1126
+ # @!attribute [rw] name
1127
+ # @return [::String]
1128
+ # Required. The name of the route table resource.
1129
+ class GetGroupRequest
1130
+ include ::Google::Protobuf::MessageExts
1131
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1132
+ end
1133
+
526
1134
  # Supported features for a location
527
1135
  module LocationFeature
528
1136
  # No publicly supported feature in this location
@@ -535,23 +1143,69 @@ module Google
535
1143
  SITE_TO_SITE_SPOKES = 2
536
1144
  end
537
1145
 
1146
+ # The route's type
1147
+ module RouteType
1148
+ # No route type information specified
1149
+ ROUTE_TYPE_UNSPECIFIED = 0
1150
+
1151
+ # The route leads to a destination within the primary address range of the
1152
+ # VPC network's subnet.
1153
+ VPC_PRIMARY_SUBNET = 1
1154
+
1155
+ # The route leads to a destination within the secondary address range of the
1156
+ # VPC network's subnet.
1157
+ VPC_SECONDARY_SUBNET = 2
1158
+ end
1159
+
538
1160
  # The State enum represents the lifecycle stage of a Network Connectivity
539
1161
  # Center resource.
540
1162
  module State
541
1163
  # No state information available
542
1164
  STATE_UNSPECIFIED = 0
543
1165
 
544
- # The resource's create operation is in progress
1166
+ # The resource's create operation is in progress.
545
1167
  CREATING = 1
546
1168
 
547
1169
  # The resource is active
548
1170
  ACTIVE = 2
549
1171
 
550
- # The resource's Delete operation is in progress
1172
+ # The resource's delete operation is in progress.
551
1173
  DELETING = 3
552
1174
 
553
- # The resource's Update operation is in progress
1175
+ # The resource's accept operation is in progress.
1176
+ ACCEPTING = 8
1177
+
1178
+ # The resource's reject operation is in progress.
1179
+ REJECTING = 9
1180
+
1181
+ # The resource's update operation is in progress.
554
1182
  UPDATING = 6
1183
+
1184
+ # The resource is inactive.
1185
+ INACTIVE = 7
1186
+
1187
+ # The hub associated with this spoke resource has been deleted.
1188
+ # This state applies to spoke resources only.
1189
+ OBSOLETE = 10
1190
+ end
1191
+
1192
+ # The SpokeType enum represents the type of spoke. The type
1193
+ # reflects the kind of resource that a spoke is associated with.
1194
+ module SpokeType
1195
+ # Unspecified spoke type.
1196
+ SPOKE_TYPE_UNSPECIFIED = 0
1197
+
1198
+ # Spokes associated with VPN tunnels.
1199
+ VPN_TUNNEL = 1
1200
+
1201
+ # Spokes associated with VLAN attachments.
1202
+ INTERCONNECT_ATTACHMENT = 2
1203
+
1204
+ # Spokes associated with router appliance instances.
1205
+ ROUTER_APPLIANCE = 3
1206
+
1207
+ # Spokes associated with VPC networks.
1208
+ VPC_NETWORK = 4
555
1209
  end
556
1210
  end
557
1211
  end