com.google.cloud.compute

Class Network

java.lang.Object

com.google.cloud.compute.NetworkInfo

com.google.cloud.compute.Network

All Implemented Interfaces:

Serializable

public class Network
extends NetworkInfo

A Google Compute Engine Network. Every virtual machine instance is created as a member of a network. Networks connect instances to each other and to the Internet. You can segment your networks, use firewall rules to restrict access to instances, and create static routes to forward traffic to specific destinations. Objects of this class are immutable. To get a Network object with the most recent information use reload(com.google.cloud.compute.Compute.NetworkOption...). Network adds a layer of service-related functionality over NetworkInfo.

See Also:

Using Networks and Firewalls, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Network.Builder A builder for Network objects.

Method Summary

Methods

Modifier and Type	Method and Description
Compute	compute() Returns the network's Compute object used to issue requests.
Operation	createSubnetwork(SubnetworkId subnetworkId, String ipRange, Compute.OperationOption... options) Creates a subnetwork for this network given its identity and the range of IPv4 addresses in CIDR format.
Operation	delete(Compute.OperationOption... options) Deletes this network.
boolean	equals(Object obj)
boolean	exists() Checks if this network exists.
int	hashCode()
Network	reload(Compute.NetworkOption... options) Fetches current network' latest information.
Network.Builder	toBuilder() Returns a builder for the current network.

Methods inherited from class com.google.cloud.compute.NetworkInfo

builder, configuration, creationTimestamp, description, generatedId, networkId, of, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

exists

public boolean exists()

Checks if this network exists.

Returns:

true if this network exists, false otherwise

Throws:

ComputeException - upon failure

reload

public Network reload(Compute.NetworkOption... options)

Fetches current network' latest information. Returns null if the network does not exist.

Parameters:

options - network options

Returns:

a Network object with latest information or null if not found

Throws:

ComputeException - upon failure

delete

public Operation delete(Compute.OperationOption... options)

Deletes this network.

Returns:

an operation object if delete request was successfully sent, null if the network was not found

Throws:

ComputeException - upon failure

createSubnetwork

public Operation createSubnetwork(SubnetworkId subnetworkId,
                         String ipRange,
                         Compute.OperationOption... options)

Creates a subnetwork for this network given its identity and the range of IPv4 addresses in CIDR format. Subnetwork creation is only supported for networks in "custom subnet mode" (i.e. NetworkInfo.configuration() returns a SubnetNetworkConfiguration) with automatic creation of subnetworks disabled (i.e. SubnetNetworkConfiguration.autoCreateSubnetworks() returns false).

Returns:

an operation object if creation request was successfully sent

Throws:

ComputeException - upon failure

See Also:

CIDR

compute

public Compute compute()

Returns the network's Compute object used to issue requests.

toBuilder

public Network.Builder toBuilder()

Description copied from class: NetworkInfo

Returns a builder for the current network.

Overrides:

toBuilder in class NetworkInfo

equals

public final boolean equals(Object obj)

Overrides:

equals in class NetworkInfo

hashCode

public final int hashCode()

Overrides:

hashCode in class NetworkInfo