@@ -50,56 +50,25 @@ class ConnectivityTest(proto.Message):
50
50
Required. Source specification of the
51
51
Connectivity Test.
52
52
You can use a combination of source IP address,
53
- virtual machine (VM) instance, or Compute Engine
54
- network to uniquely identify the source
55
- location.
56
-
57
- Examples:
58
-
59
- If the source IP address is an internal IP
60
- address within a Google Cloud Virtual Private
61
- Cloud (VPC) network, then you must also specify
62
- the VPC network. Otherwise, specify the VM
63
- instance, which already contains its internal IP
64
- address and VPC network information.
65
-
66
- If the source of the test is within an
67
- on-premises network, then you must provide the
68
- destination VPC network.
53
+ URI of a supported endpoint, project ID, or VPC
54
+ network to identify the source location.
69
55
70
- If the source endpoint is a Compute Engine VM
71
- instance with multiple network interfaces, the
72
- instance itself is not sufficient to identify
73
- the endpoint. So, you must also specify the
74
- source IP address or VPC network.
75
-
76
- A reachability analysis proceeds even if the
56
+ Reachability analysis might proceed even if the
77
57
source location is ambiguous. However, the test
78
- result may include endpoints that you don't
79
- intend to test.
58
+ result might include endpoints or use a source
59
+ that you don't intend to test.
80
60
destination (google.cloud.network_management_v1.types.Endpoint):
81
61
Required. Destination specification of the
82
62
Connectivity Test.
83
63
You can use a combination of destination IP
84
- address, Compute Engine VM instance, or VPC
85
- network to uniquely identify the destination
64
+ address, URI of a supported endpoint, project
65
+ ID, or VPC network to identify the destination
86
66
location.
87
67
88
- Even if the destination IP address is not
89
- unique, the source IP location is unique.
90
- Usually, the analysis can infer the destination
91
- endpoint from route information.
92
-
93
- If the destination you specify is a VM instance
94
- and the instance has multiple network
95
- interfaces, then you must also specify either a
96
- destination IP address or VPC network to
97
- identify the destination interface.
98
-
99
- A reachability analysis proceeds even if the
68
+ Reachability analysis proceeds even if the
100
69
destination location is ambiguous. However, the
101
- result can include endpoints that you don't
102
- intend to test.
70
+ test result might include endpoints or use a
71
+ destination that you don't intend to test.
103
72
protocol (str):
104
73
IP Protocol of the test. When not provided,
105
74
"TCP" is assumed.
@@ -142,8 +111,8 @@ class ConnectivityTest(proto.Message):
142
111
test, updating an existing test, or triggering a
143
112
one-time rerun of an existing test.
144
113
bypass_firewall_checks (bool):
145
- Whether the test should skip firewall
146
- checking. If not provided, we assume false.
114
+ Whether the analysis should skip firewall
115
+ checking. Default value is false.
147
116
"""
148
117
149
118
name : str = proto .Field (
@@ -237,7 +206,8 @@ class Endpoint(proto.Message):
237
206
are also used for protocol forwarding, Private
238
207
Service Connect and other network services to
239
208
provide forwarding information in the control
240
- plane. Format:
209
+ plane. Applicable only to destination endpoint.
210
+ Format:
241
211
242
212
projects/{project}/global/forwardingRules/{id}
243
213
or
@@ -272,33 +242,36 @@ class Endpoint(proto.Message):
272
242
redis_instance (str):
273
243
A `Redis
274
244
Instance <https://cloud.google.com/memorystore/docs/redis>`__
275
- URI.
245
+ URI. Applicable only to destination endpoint.
276
246
redis_cluster (str):
277
247
A `Redis
278
248
Cluster <https://cloud.google.com/memorystore/docs/cluster>`__
279
- URI.
249
+ URI. Applicable only to destination endpoint.
280
250
cloud_function (google.cloud.network_management_v1.types.Endpoint.CloudFunctionEndpoint):
281
251
A `Cloud Function <https://cloud.google.com/functions>`__.
252
+ Applicable only to source endpoint.
282
253
app_engine_version (google.cloud.network_management_v1.types.Endpoint.AppEngineVersionEndpoint):
283
254
An `App Engine <https://cloud.google.com/appengine>`__
284
255
`service
285
256
version <https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions>`__.
257
+ Applicable only to source endpoint.
286
258
cloud_run_revision (google.cloud.network_management_v1.types.Endpoint.CloudRunRevisionEndpoint):
287
259
A `Cloud Run <https://cloud.google.com/run>`__
288
260
`revision <https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get>`__
261
+ Applicable only to source endpoint.
289
262
network (str):
290
- A Compute Engine network URI.
263
+ A VPC network URI.
291
264
network_type (google.cloud.network_management_v1.types.Endpoint.NetworkType):
292
265
Type of the network where the endpoint is
293
266
located. Applicable only to source endpoint, as
294
267
destination network type can be inferred from
295
268
the source.
296
269
project_id (str):
297
270
Project ID where the endpoint is located.
298
- The Project ID can be derived from the URI if
299
- you provide a VM instance or network URI.
300
- The following are two cases where you must
301
- provide the project ID:
271
+ The project ID can be derived from the URI if
272
+ you provide a endpoint or network URI.
273
+ The following are two cases where you may need
274
+ to provide the project ID:
302
275
303
276
1. Only the IP address is specified, and the IP
304
277
address is within a Google Cloud project.
@@ -322,8 +295,9 @@ class NetworkType(proto.Enum):
322
295
for the source or destination network.
323
296
NON_GCP_NETWORK (2):
324
297
A network hosted outside of Google Cloud.
325
- This can be an on-premises network, or a network
326
- hosted by another cloud provider.
298
+ This can be an on-premises network, an internet
299
+ resource or a network hosted by another cloud
300
+ provider.
327
301
"""
328
302
NETWORK_TYPE_UNSPECIFIED = 0
329
303
GCP_NETWORK = 1
0 commit comments