google-cloud-network_connectivity-v1 0.7.0 → 0.8.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.
@@ -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