Package com.google.cloud.networkmanagement.v1 (1.23.0)

A client to Network Management API

The interfaces provided are listed below, along with usage samples.

ReachabilityServiceClient

Service Description: The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations.

You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

Sample for ReachabilityServiceClient:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (ReachabilityServiceClient reachabilityServiceClient = ReachabilityServiceClient.create()) {
   String name = "name3373707";
   ConnectivityTest response = reachabilityServiceClient.getConnectivityTest(name);
 }
 

Classes

AbortInfo

Details of the final state "abort" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.AbortInfo

AbortInfo.Builder

Details of the final state "abort" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.AbortInfo

CloudSQLInstanceInfo

For display only. Metadata associated with a Cloud SQL instance.

Protobuf type google.cloud.networkmanagement.v1.CloudSQLInstanceInfo

CloudSQLInstanceInfo.Builder

For display only. Metadata associated with a Cloud SQL instance.

Protobuf type google.cloud.networkmanagement.v1.CloudSQLInstanceInfo

ConnectivityTest

A Connectivity Test for a network reachability analysis.

Protobuf type google.cloud.networkmanagement.v1.ConnectivityTest

ConnectivityTest.Builder

A Connectivity Test for a network reachability analysis.

Protobuf type google.cloud.networkmanagement.v1.ConnectivityTest

CreateConnectivityTestRequest

Request for the CreateConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.CreateConnectivityTestRequest

CreateConnectivityTestRequest.Builder

Request for the CreateConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.CreateConnectivityTestRequest

DeleteConnectivityTestRequest

Request for the DeleteConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.DeleteConnectivityTestRequest

DeleteConnectivityTestRequest.Builder

Request for the DeleteConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.DeleteConnectivityTestRequest

DeliverInfo

Details of the final state "deliver" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.DeliverInfo

DeliverInfo.Builder

Details of the final state "deliver" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.DeliverInfo

DropInfo

Details of the final state "drop" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.DropInfo

DropInfo.Builder

Details of the final state "drop" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.DropInfo

Endpoint

Source or destination of the Connectivity Test.

Protobuf type google.cloud.networkmanagement.v1.Endpoint

Endpoint.Builder

Source or destination of the Connectivity Test.

Protobuf type google.cloud.networkmanagement.v1.Endpoint

EndpointInfo

For display only. The specification of the endpoints for the test. EndpointInfo is derived from source and destination Endpoint and validated by the backend data plane model.

Protobuf type google.cloud.networkmanagement.v1.EndpointInfo

EndpointInfo.Builder

For display only. The specification of the endpoints for the test. EndpointInfo is derived from source and destination Endpoint and validated by the backend data plane model.

Protobuf type google.cloud.networkmanagement.v1.EndpointInfo

FirewallInfo

For display only. Metadata associated with a VPC firewall rule, an implied VPC firewall rule, or a hierarchical firewall policy rule.

Protobuf type google.cloud.networkmanagement.v1.FirewallInfo

FirewallInfo.Builder

For display only. Metadata associated with a VPC firewall rule, an implied VPC firewall rule, or a hierarchical firewall policy rule.

Protobuf type google.cloud.networkmanagement.v1.FirewallInfo

ForwardInfo

Details of the final state "forward" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.ForwardInfo

ForwardInfo.Builder

Details of the final state "forward" and associated resource.

Protobuf type google.cloud.networkmanagement.v1.ForwardInfo

ForwardingRuleInfo

For display only. Metadata associated with a Compute Engine forwarding rule.

Protobuf type google.cloud.networkmanagement.v1.ForwardingRuleInfo

ForwardingRuleInfo.Builder

For display only. Metadata associated with a Compute Engine forwarding rule.

Protobuf type google.cloud.networkmanagement.v1.ForwardingRuleInfo

GKEMasterInfo

For display only. Metadata associated with a Google Kubernetes Engine (GKE) cluster master.

Protobuf type google.cloud.networkmanagement.v1.GKEMasterInfo

GKEMasterInfo.Builder

For display only. Metadata associated with a Google Kubernetes Engine (GKE) cluster master.

Protobuf type google.cloud.networkmanagement.v1.GKEMasterInfo

GetConnectivityTestRequest

Request for the GetConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.GetConnectivityTestRequest

GetConnectivityTestRequest.Builder

Request for the GetConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.GetConnectivityTestRequest

InstanceInfo

For display only. Metadata associated with a Compute Engine instance.

Protobuf type google.cloud.networkmanagement.v1.InstanceInfo

InstanceInfo.Builder

For display only. Metadata associated with a Compute Engine instance.

Protobuf type google.cloud.networkmanagement.v1.InstanceInfo

ListConnectivityTestsRequest

Request for the ListConnectivityTests method.

Protobuf type google.cloud.networkmanagement.v1.ListConnectivityTestsRequest

ListConnectivityTestsRequest.Builder

Request for the ListConnectivityTests method.

Protobuf type google.cloud.networkmanagement.v1.ListConnectivityTestsRequest

ListConnectivityTestsResponse

Response for the ListConnectivityTests method.

Protobuf type google.cloud.networkmanagement.v1.ListConnectivityTestsResponse

ListConnectivityTestsResponse.Builder

Response for the ListConnectivityTests method.

Protobuf type google.cloud.networkmanagement.v1.ListConnectivityTestsResponse

LoadBalancerBackend

For display only. Metadata associated with a specific load balancer backend.

Protobuf type google.cloud.networkmanagement.v1.LoadBalancerBackend

LoadBalancerBackend.Builder

For display only. Metadata associated with a specific load balancer backend.

Protobuf type google.cloud.networkmanagement.v1.LoadBalancerBackend

LoadBalancerInfo

For display only. Metadata associated with a load balancer.

Protobuf type google.cloud.networkmanagement.v1.LoadBalancerInfo

LoadBalancerInfo.Builder

For display only. Metadata associated with a load balancer.

Protobuf type google.cloud.networkmanagement.v1.LoadBalancerInfo

NetworkInfo

For display only. Metadata associated with a Compute Engine network.

Protobuf type google.cloud.networkmanagement.v1.NetworkInfo

NetworkInfo.Builder

For display only. Metadata associated with a Compute Engine network.

Protobuf type google.cloud.networkmanagement.v1.NetworkInfo

OperationMetadata

Metadata describing an Operation

Protobuf type google.cloud.networkmanagement.v1.OperationMetadata

OperationMetadata.Builder

Metadata describing an Operation

Protobuf type google.cloud.networkmanagement.v1.OperationMetadata

ReachabilityDetails

Results of the configuration analysis from the last run of the test.

Protobuf type google.cloud.networkmanagement.v1.ReachabilityDetails

ReachabilityDetails.Builder

Results of the configuration analysis from the last run of the test.

Protobuf type google.cloud.networkmanagement.v1.ReachabilityDetails

ReachabilityServiceClient

Service Description: The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations.

You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (ReachabilityServiceClient reachabilityServiceClient = ReachabilityServiceClient.create()) {
   String name = "name3373707";
   ConnectivityTest response = reachabilityServiceClient.getConnectivityTest(name);
 }
 

Note: close() needs to be called on the ReachabilityServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

The surface of this class includes several types of Java methods for each of the API's methods:

  1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
  2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
  3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

See the individual methods for example code.

Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

This class can be customized by passing in a custom instance of ReachabilityServiceSettings to create(). For example:

To customize credentials:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 ReachabilityServiceSettings reachabilityServiceSettings =
     ReachabilityServiceSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 ReachabilityServiceClient reachabilityServiceClient =
     ReachabilityServiceClient.create(reachabilityServiceSettings);
 

To customize the endpoint:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 ReachabilityServiceSettings reachabilityServiceSettings =
     ReachabilityServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 ReachabilityServiceClient reachabilityServiceClient =
     ReachabilityServiceClient.create(reachabilityServiceSettings);
 

To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 ReachabilityServiceSettings reachabilityServiceSettings =
     ReachabilityServiceSettings.newHttpJsonBuilder().build();
 ReachabilityServiceClient reachabilityServiceClient =
     ReachabilityServiceClient.create(reachabilityServiceSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

ReachabilityServiceClient.ListConnectivityTestsFixedSizeCollection

ReachabilityServiceClient.ListConnectivityTestsPage

ReachabilityServiceClient.ListConnectivityTestsPagedResponse

ReachabilityServiceGrpc

The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations. You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

ReachabilityServiceGrpc.ReachabilityServiceBlockingStub

A stub to allow clients to do synchronous rpc calls to service ReachabilityService.

The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations. You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

ReachabilityServiceGrpc.ReachabilityServiceFutureStub

A stub to allow clients to do ListenableFuture-style rpc calls to service ReachabilityService.

The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations. You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

ReachabilityServiceGrpc.ReachabilityServiceImplBase

Base class for the server implementation of the service ReachabilityService.

The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations. You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

ReachabilityServiceGrpc.ReachabilityServiceStub

A stub to allow clients to do asynchronous rpc calls to service ReachabilityService.

The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations. You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

ReachabilityServiceProto

ReachabilityServiceSettings

Settings class to configure an instance of ReachabilityServiceClient.

The default instance has everything set to sensible defaults:

  • The default service address (networkmanagement.googleapis.com) and default port (443) are used.
  • Credentials are acquired automatically through Application Default Credentials.
  • Retries are configured for idempotent methods but not for non-idempotent methods.

The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.

For example, to set the total timeout of getConnectivityTest to 30 seconds:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 ReachabilityServiceSettings.Builder reachabilityServiceSettingsBuilder =
     ReachabilityServiceSettings.newBuilder();
 reachabilityServiceSettingsBuilder
     .getConnectivityTestSettings()
     .setRetrySettings(
         reachabilityServiceSettingsBuilder
             .getConnectivityTestSettings()
             .getRetrySettings()
             .toBuilder()
             .setTotalTimeout(Duration.ofSeconds(30))
             .build());
 ReachabilityServiceSettings reachabilityServiceSettings =
     reachabilityServiceSettingsBuilder.build();
 

ReachabilityServiceSettings.Builder

Builder for ReachabilityServiceSettings.

RerunConnectivityTestRequest

Request for the RerunConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.RerunConnectivityTestRequest

RerunConnectivityTestRequest.Builder

Request for the RerunConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.RerunConnectivityTestRequest

RouteInfo

For display only. Metadata associated with a Compute Engine route.

Protobuf type google.cloud.networkmanagement.v1.RouteInfo

RouteInfo.Builder

For display only. Metadata associated with a Compute Engine route.

Protobuf type google.cloud.networkmanagement.v1.RouteInfo

Step

A simulated forwarding path is composed of multiple steps. Each step has a well-defined state and an associated configuration.

Protobuf type google.cloud.networkmanagement.v1.Step

Step.Builder

A simulated forwarding path is composed of multiple steps. Each step has a well-defined state and an associated configuration.

Protobuf type google.cloud.networkmanagement.v1.Step

TestOuterClass

Trace

Trace represents one simulated packet forwarding path.

  • Each trace contains multiple ordered steps.
  • Each step is in a particular state with associated configuration.
  • State is categorized as final or non-final states.
  • Each final state has a reason associated.
  • Each trace must end with a final state (the last step). <code><code> |---------------------Trace----------------------| Step1(State) Step2(State) --- StepN(State(final)) </code></code>

Protobuf type google.cloud.networkmanagement.v1.Trace

Trace.Builder

Trace represents one simulated packet forwarding path.

  • Each trace contains multiple ordered steps.
  • Each step is in a particular state with associated configuration.
  • State is categorized as final or non-final states.
  • Each final state has a reason associated.
  • Each trace must end with a final state (the last step). <code><code> |---------------------Trace----------------------| Step1(State) Step2(State) --- StepN(State(final)) </code></code>

Protobuf type google.cloud.networkmanagement.v1.Trace

TraceProto

UpdateConnectivityTestRequest

Request for the UpdateConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.UpdateConnectivityTestRequest

UpdateConnectivityTestRequest.Builder

Request for the UpdateConnectivityTest method.

Protobuf type google.cloud.networkmanagement.v1.UpdateConnectivityTestRequest

VpnGatewayInfo

For display only. Metadata associated with a Compute Engine VPN gateway.

Protobuf type google.cloud.networkmanagement.v1.VpnGatewayInfo

VpnGatewayInfo.Builder

For display only. Metadata associated with a Compute Engine VPN gateway.

Protobuf type google.cloud.networkmanagement.v1.VpnGatewayInfo

VpnTunnelInfo

For display only. Metadata associated with a Compute Engine VPN tunnel.

Protobuf type google.cloud.networkmanagement.v1.VpnTunnelInfo

VpnTunnelInfo.Builder

For display only. Metadata associated with a Compute Engine VPN tunnel.

Protobuf type google.cloud.networkmanagement.v1.VpnTunnelInfo

Interfaces

AbortInfoOrBuilder

CloudSQLInstanceInfoOrBuilder

ConnectivityTestOrBuilder

CreateConnectivityTestRequestOrBuilder

DeleteConnectivityTestRequestOrBuilder

DeliverInfoOrBuilder

DropInfoOrBuilder

EndpointInfoOrBuilder

EndpointOrBuilder

FirewallInfoOrBuilder

ForwardInfoOrBuilder

ForwardingRuleInfoOrBuilder

GKEMasterInfoOrBuilder

GetConnectivityTestRequestOrBuilder

InstanceInfoOrBuilder

ListConnectivityTestsRequestOrBuilder

ListConnectivityTestsResponseOrBuilder

LoadBalancerBackendOrBuilder

LoadBalancerInfoOrBuilder

NetworkInfoOrBuilder

OperationMetadataOrBuilder

ReachabilityDetailsOrBuilder

ReachabilityServiceGrpc.AsyncService

The Reachability service in the Google Cloud Network Management API provides services that analyze the reachability within a single Google Virtual Private Cloud (VPC) network, between peered VPC networks, between VPC and on-premises networks, or between VPC networks and internet hosts. A reachability analysis is based on Google Cloud network configurations. You can use the analysis results to verify these configurations and to troubleshoot connectivity issues.

RerunConnectivityTestRequestOrBuilder

RouteInfoOrBuilder

StepOrBuilder

TraceOrBuilder

UpdateConnectivityTestRequestOrBuilder

VpnGatewayInfoOrBuilder

VpnTunnelInfoOrBuilder

Enums

AbortInfo.Cause

Abort cause types:

Protobuf enum google.cloud.networkmanagement.v1.AbortInfo.Cause

DeliverInfo.Target

Deliver target types:

Protobuf enum google.cloud.networkmanagement.v1.DeliverInfo.Target

DropInfo.Cause

Drop cause types:

Protobuf enum google.cloud.networkmanagement.v1.DropInfo.Cause

Endpoint.NetworkType

The type definition of an endpoint's network. Use one of the following choices:

Protobuf enum google.cloud.networkmanagement.v1.Endpoint.NetworkType

FirewallInfo.FirewallRuleType

The firewall rule's type.

Protobuf enum google.cloud.networkmanagement.v1.FirewallInfo.FirewallRuleType

ForwardInfo.Target

Forward target types.

Protobuf enum google.cloud.networkmanagement.v1.ForwardInfo.Target

LoadBalancerBackend.HealthCheckFirewallState

State of a health check firewall configuration:

Protobuf enum google.cloud.networkmanagement.v1.LoadBalancerBackend.HealthCheckFirewallState

LoadBalancerInfo.BackendType

The type definition for a load balancer backend configuration:

Protobuf enum google.cloud.networkmanagement.v1.LoadBalancerInfo.BackendType

LoadBalancerInfo.LoadBalancerType

The type definition for a load balancer:

Protobuf enum google.cloud.networkmanagement.v1.LoadBalancerInfo.LoadBalancerType

ReachabilityDetails.Result

The overall result of the test's configuration analysis.

Protobuf enum google.cloud.networkmanagement.v1.ReachabilityDetails.Result

RouteInfo.NextHopType

Type of next hop:

Protobuf enum google.cloud.networkmanagement.v1.RouteInfo.NextHopType

RouteInfo.RouteType

Type of route:

Protobuf enum google.cloud.networkmanagement.v1.RouteInfo.RouteType

Step.State

Type of states that are defined in the network state machine. Each step in the packet trace is in a specific state.

Protobuf enum google.cloud.networkmanagement.v1.Step.State

Step.StepInfoCase

VpnTunnelInfo.RoutingType

Types of VPN routing policy. For details, refer to Networks and Tunnel routing.

Protobuf enum google.cloud.networkmanagement.v1.VpnTunnelInfo.RoutingType