Vnic (Oracle Cloud Infrastructure Java SDK

java.lang.Object
- com.oracle.bmc.http.internal.ExplicitlySetBmcModel
- - com.oracle.bmc.vnmonitoring.model.Vnic

```
@Generated(value="OracleSDKGenerator",
           comments="API Version: 20160918")
public final class Vnic
extends ExplicitlySetBmcModel
```
A virtual network interface card. Each VNIC resides in a subnet in a VCN. An instance attaches to a VNIC to obtain a network connection into the VCN through that subnet. Each instance has a primary VNIC that is automatically created and attached during launch. You can add secondary VNICs to an instance after it’s launched. For more information, see Virtual Network Interface Cards (VNICs).

Each VNIC has a *primary private IP* that is automatically assigned during launch. You can add *secondary private IPs* to a VNIC after it's created. For more information, see createPrivateIp and [IP Addresses](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingIPaddresses.htm).

To use any of the API operations, you must be authorized in an IAM policy. If you’re not authorized, talk to an administrator. If you’re an administrator who needs to write policies to give users access, see Getting Started with Policies.

Note: Objects should always be created or deserialized using the Vnic.Builder. This model distinguishes fields that are null because they are unset from fields that are explicitly set to null. This is done in the setter methods of the Vnic.Builder, which maintain a set of all explicitly set fields called ExplicitlySetBmcModel.__explicitlySet__. The hashCode() and equals(Object) methods are implemented to take ExplicitlySetBmcModel.__explicitlySet__ into account. The constructor, on the other hand, does not set ExplicitlySetBmcModel.__explicitlySet__ (since the constructor cannot distinguish explicit null from unset null).

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Vnic.Builder

static class Vnic.LifecycleState
The current state of the VNIC.

Nested Classes
Modifier and Type	Class and Description
`static class`	`Vnic.Builder`
`static class`	`Vnic.LifecycleState` The current state of the VNIC.

Constructor Summary

Constructors
Constructor and Description
`Vnic(String availabilityDomain, String compartmentId, Map<String,Map<String,Object>> definedTags, String displayName, Map<String,String> freeformTags, String hostnameLabel, String id, Boolean isPrimary, Vnic.LifecycleState lifecycleState, String macAddress, List<String> nsgIds, String privateIp, String publicIp, Boolean skipSourceDestCheck, String subnetId, Date timeCreated)` Deprecated.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static Vnic.Builder`	`builder()` Create a new builder.
`boolean`	`equals(Object o)`
`String`	`getAvailabilityDomain()` The VNIC’s availability domain.
`String`	`getCompartmentId()` The OCID of the compartment containing the VNIC.
`Map<String,Map<String,Object>>`	`getDefinedTags()` Defined tags for this resource.
`String`	`getDisplayName()` A user-friendly name.
`Map<String,String>`	`getFreeformTags()` Simple key-value pair that is applied without any predefined name, type or scope.
`String`	`getHostnameLabel()` The hostname for the VNIC’s primary private IP.
`String`	`getId()` The OCID of the VNIC.
`Boolean`	`getIsPrimary()` Whether the VNIC is the primary VNIC (the VNIC that is automatically created and attached during instance launch).
`Vnic.LifecycleState`	`getLifecycleState()` The current state of the VNIC.
`String`	`getMacAddress()` The MAC address of the VNIC.
`List<String>`	`getNsgIds()` A list of the OCIDs of the network security groups that the VNIC belongs to.
`String`	`getPrivateIp()` The private IP address of the primary `privateIp` object on the VNIC.
`String`	`getPublicIp()` The public IP address of the VNIC, if one is assigned.
`Boolean`	`getSkipSourceDestCheck()` Whether the source/destination check is disabled on the VNIC.
`String`	`getSubnetId()` The OCID of the subnet the VNIC is in.
`Date`	`getTimeCreated()` The date and time the VNIC was created, in the format defined by RFC3339.
`int`	`hashCode()`
`Vnic.Builder`	`toBuilder()`
`String`	`toString()`
`String`	`toString(boolean includeByteArrayContents)` Return a string representation of the object.

Methods inherited from class com.oracle.bmc.http.internal.ExplicitlySetBmcModel
markPropertyAsExplicitlySet, wasPropertyExplicitlySet

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Vnic

@Deprecated
 @ConstructorProperties(value={"availabilityDomain","compartmentId","definedTags","displayName","freeformTags","hostnameLabel","id","isPrimary","lifecycleState","macAddress","nsgIds","privateIp","publicIp","skipSourceDestCheck","subnetId","timeCreated"})
public Vnic(String availabilityDomain,
                                                                                                                                                                                                                                                                                       String compartmentId,
                                                                                                                                                                                                                                                                                       Map<String,Map<String,Object>> definedTags,
                                                                                                                                                                                                                                                                                       String displayName,
                                                                                                                                                                                                                                                                                       Map<String,String> freeformTags,
                                                                                                                                                                                                                                                                                       String hostnameLabel,
                                                                                                                                                                                                                                                                                       String id,
                                                                                                                                                                                                                                                                                       Boolean isPrimary,
                                                                                                                                                                                                                                                                                       Vnic.LifecycleState lifecycleState,
                                                                                                                                                                                                                                                                                       String macAddress,
                                                                                                                                                                                                                                                                                       List<String> nsgIds,
                                                                                                                                                                                                                                                                                       String privateIp,
                                                                                                                                                                                                                                                                                       String publicIp,
                                                                                                                                                                                                                                                                                       Boolean skipSourceDestCheck,
                                                                                                                                                                                                                                                                                       String subnetId,
                                                                                                                                                                                                                                                                                       Date timeCreated)

Deprecated.

Method Detail
- builder
```
public static Vnic.Builder builder()
```
  Create a new builder.
- toBuilder
```
public Vnic.Builder toBuilder()
```
- getAvailabilityDomain
```
public String getAvailabilityDomain()
```
  The VNIC’s availability domain.
  
  Example: Uocm:PHX-AD-1
  
  Returns:
  
  the value
- getCompartmentId
```
public String getCompartmentId()
```
  The OCID of the compartment containing the VNIC.
  
  Returns:
  
  the value
- getDefinedTags
```
public Map<String,Map<String,Object>> getDefinedTags()
```
  Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace": {"bar-key": "value"}}
  
  Returns:
  
  the value
- getDisplayName
```
public String getDisplayName()
```
  A user-friendly name. Does not have to be unique, and it’s changeable. Avoid entering confidential information.
  
  Returns:
  
  the value
- getFreeformTags
```
public Map<String,String> getFreeformTags()
```
  Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
  
  Returns:
  
  the value
- getHostnameLabel
```
public String getHostnameLabel()
```
  The hostname for the VNIC’s primary private IP. Used for DNS. The value is the hostname portion of the primary private IP’s fully qualified domain name (FQDN) (for example, bminstance-1 in FQDN bminstance-1.subnet123.vcn1.oraclevcn.com). Must be unique across all VNICs in the subnet and comply with RFC 952 and RFC 1123.
  
  For more information, see [DNS in Your Virtual Cloud Network](https://docs.cloud.oracle.com/iaas/Content/Network/Concepts/dns.htm).
  Example: bminstance-1
  
  Returns:
  
  the value
- getId
```
public String getId()
```
  The OCID of the VNIC.
  
  Returns:
  
  the value
- getIsPrimary
```
public Boolean getIsPrimary()
```
  Whether the VNIC is the primary VNIC (the VNIC that is automatically created and attached during instance launch).
  
  Returns:
  
  the value
- getLifecycleState
```
public Vnic.LifecycleState getLifecycleState()
```
  The current state of the VNIC.
  
  Returns:
  
  the value
- getMacAddress
```
public String getMacAddress()
```
  The MAC address of the VNIC.
  
  Example: 00:00:00:00:00:01
  
  Returns:
  
  the value
- getNsgIds
```
public List<String> getNsgIds()
```
  A list of the OCIDs of the network security groups that the VNIC belongs to.
  
  For more information about NSGs, see NetworkSecurityGroup.
  
  Returns:
  
  the value
- getPrivateIp
```
public String getPrivateIp()
```
  The private IP address of the primary privateIp object on the VNIC. The address is within the CIDR of the VNIC’s subnet.
  
  Example: 10.0.3.3
  
  Returns:
  
  the value
- getPublicIp
```
public String getPublicIp()
```
  The public IP address of the VNIC, if one is assigned.
  
  Returns:
  
  the value
- getSkipSourceDestCheck
```
public Boolean getSkipSourceDestCheck()
```
  Whether the source/destination check is disabled on the VNIC. Defaults to false, which means the check is performed. For information about why you would skip the source/destination check, see Using a Private IP as a Route Target.
  
  Example: true
  
  Returns:
  
  the value
- getSubnetId
```
public String getSubnetId()
```
  The OCID of the subnet the VNIC is in.
  
  Returns:
  
  the value
- getTimeCreated
```
public Date getTimeCreated()
```
  The date and time the VNIC was created, in the format defined by RFC3339.
  
  Example: 2016-08-25T21:10:29.600Z
  
  Returns:
  
  the value
- toString
```
public String toString()
```
  Overrides:
  
  toString in class ExplicitlySetBmcModel
- toString
```
public String toString(boolean includeByteArrayContents)
```
  Return a string representation of the object.
  
  Parameters:
  
  includeByteArrayContents - true to include the full contents of byte arrays
  
  Returns:
  
  string representation
- equals
```
public boolean equals(Object o)
```
  Overrides:
  
  equals in class ExplicitlySetBmcModel
- hashCode
```
public int hashCode()
```
  Overrides:
  
  hashCode in class ExplicitlySetBmcModel

Class Vnic

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class com.oracle.bmc.http.internal.ExplicitlySetBmcModel

Methods inherited from class java.lang.Object

Constructor Detail

Vnic

Method Detail

builder

toBuilder

getAvailabilityDomain

getCompartmentId

getDefinedTags

getDisplayName

getFreeformTags

getHostnameLabel

getId

getIsPrimary

getLifecycleState

getMacAddress

getNsgIds

getPrivateIp

getPublicIp

getSkipSourceDestCheck

getSubnetId

getTimeCreated

toString

toString

equals

hashCode