java.lang.Object
- org.jclouds.softlayer.domain.VirtualGuest

```
public class VirtualGuest
extends Object
```
The virtual guest data type presents the structure in which all virtual guests will be presented. Internally, the structure supports various virtualization platforms with no change to external interaction.
A guest, also known as a virtual server or CloudLayer Computing Instance, represents an allocation of resources on a virtual host. The hostname and domain must be alphanumeric strings that may be separated by periods '.'. The only other allowable special character is the dash '-'. However the special characters '.' and '-' may not be consecutive. Each alphanumeric string separated by a period is considered a label. Labels must begin and end with an alphanumeric character. Each label cannot be solely comprised of digits and must be between 1-63 characters in length. The last label, the TLD (top level domain) must be between 2-6 alphabetic characters. The domain portion must consist of least one label followed by a period '.' then ending with the TLD label. Combining the hostname, followed by a period '.', followed by the domain gives the FQDN (fully qualified domain name), which may not exceed 253 characters in total length.

See Also:

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class VirtualGuest.BillingItem

static class VirtualGuest.Builder<T extends VirtualGuest.Builder<T>>

static class VirtualGuest.State
These states come from the powerState field.

Constructor Summary

Constructors
Modifier Constructor Description

protected VirtualGuest(int accountId, Date createDate, String domain, String fullyQualifiedDomainName, String hostname, int id, Date lastVerifiedDate, int maxCpu, String maxCpuUnits, int maxMemory, Date metricPollDate, Date modifyDate, String notes, int startCpus, int statusId, String uuid, String primaryBackendIpAddress, String primaryIpAddress, VirtualGuest.BillingItem billingItem, OperatingSystem operatingSystem, String operatingSystemReferenceCode, Datacenter datacenter, PowerState powerState, SoftwareLicense softwareLicense, int activeTransactionCount, List<VirtualGuestBlockDevice> blockDevices, boolean hourlyBillingFlag, boolean localDiskFlag, boolean dedicatedAccountHostOnlyFlag, boolean privateNetworkOnlyFlag, VirtualGuestBlockDeviceTemplateGroup blockDeviceTemplateGroup, Set<VirtualGuestNetworkComponent> networkComponents, Set<TagReference> tagReferences, VirtualGuestNetworkComponent primaryNetworkComponent, VirtualGuestNetworkComponent primaryBackendNetworkComponent, String postInstallScriptUri, VirtualGuestAttribute virtualGuestAttribute, Set<SecuritySshKey> sshKeys)

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type Method Description

static VirtualGuest.Builder<?> builder()

boolean equals(Object obj)

int getAccountId()

int getActiveTransactionCount()

int getBillingItemId()

Date getCreateDate()

Datacenter getDatacenter()

String getDomain()

String getFullyQualifiedDomainName()

String getHostname()

int getId()

Date getLastVerifiedDate()

int getMaxCpu()

String getMaxCpuUnits()

int getMaxMemory()

Date getMetricPollDate()

Date getModifyDate()

String getNotes()

OperatingSystem getOperatingSystem()

String getOperatingSystemReferenceCode()

String getPostInstallScriptUri()

PowerState getPowerState()

String getPrimaryBackendIpAddress()

VirtualGuestNetworkComponent getPrimaryBackendNetworkComponent()

String getPrimaryIpAddress()

VirtualGuestNetworkComponent getPrimaryNetworkComponent()

SoftwareLicense getSoftwareLicense()

Set<SecuritySshKey> getSshKeys()

int getStartCpus()

int getStatusId()

Set<TagReference> getTagReferences()

String getUuid()

VirtualGuestAttribute getVirtualGuestAttribute()

List<VirtualGuestBlockDevice> getVirtualGuestBlockDevices()

VirtualGuestBlockDeviceTemplateGroup getVirtualGuestBlockDeviceTemplateGroup()

Set<VirtualGuestNetworkComponent> getVirtualGuestNetworkComponents()

int hashCode()

boolean isDedicatedAccountHostOnly()

boolean isHourlyBillingFlag()

boolean isLocalDiskFlag()

boolean isPrivateNetworkOnly()

VirtualGuest.Builder<?> toBuilder()

String toString()

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

Constructor Detail

VirtualGuest

@ConstructorProperties({"accountId","createDate","domain","fullyQualifiedDomainName","hostname","id","lastVerifiedDate","maxCpu","maxCpuUnits","maxMemory","metricPollDate","modifyDate","notes","startCpus","statusId","uuid","primaryBackendIpAddress","primaryIpAddress","billingItem","operatingSystem","operatingSystemReferenceCode","datacenter","powerState","softwareLicense","activeTransactionCount","blockDevices","hourlyBillingFlag","localDiskFlag","dedicatedAccountHostOnlyFlag","privateNetworkOnlyFlag","blockDeviceTemplateGroup","networkComponents","tagReferences","primaryNetworkComponent","primaryBackendNetworkComponent","postInstallScriptUri","virtualGuestAttribute","sshKeys"})
protected VirtualGuest(int accountId,
                       @Nullable
                       Date createDate,
                       @Nullable
                       String domain,
                       @Nullable
                       String fullyQualifiedDomainName,
                       @Nullable
                       String hostname,
                       int id,
                       @Nullable
                       Date lastVerifiedDate,
                       int maxCpu,
                       @Nullable
                       String maxCpuUnits,
                       int maxMemory,
                       @Nullable
                       Date metricPollDate,
                       @Nullable
                       Date modifyDate,
                       @Nullable
                       String notes,
                       int startCpus,
                       int statusId,
                       @Nullable
                       String uuid,
                       @Nullable
                       String primaryBackendIpAddress,
                       @Nullable
                       String primaryIpAddress,
                       @Nullable
                       VirtualGuest.BillingItem billingItem,
                       @Nullable
                       OperatingSystem operatingSystem,
                       @Nullable
                       String operatingSystemReferenceCode,
                       @Nullable
                       Datacenter datacenter,
                       @Nullable
                       PowerState powerState,
                       @Nullable
                       SoftwareLicense softwareLicense,
                       int activeTransactionCount,
                       @Nullable
                       List<VirtualGuestBlockDevice> blockDevices,
                       boolean hourlyBillingFlag,
                       boolean localDiskFlag,
                       boolean dedicatedAccountHostOnlyFlag,
                       boolean privateNetworkOnlyFlag,
                       @Nullable
                       VirtualGuestBlockDeviceTemplateGroup blockDeviceTemplateGroup,
                       @Nullable
                       Set<VirtualGuestNetworkComponent> networkComponents,
                       @Nullable
                       Set<TagReference> tagReferences,
                       @Nullable
                       VirtualGuestNetworkComponent primaryNetworkComponent,
                       @Nullable
                       VirtualGuestNetworkComponent primaryBackendNetworkComponent,
                       @Nullable
                       String postInstallScriptUri,
                       @Nullable
                       VirtualGuestAttribute virtualGuestAttribute,
                       @Nullable
                       Set<SecuritySshKey> sshKeys)

Method Detail
- builder
```
public static VirtualGuest.Builder<?> builder()
```
- toBuilder
```
public VirtualGuest.Builder<?> toBuilder()
```
- getAccountId
```
public int getAccountId()
```
  Returns:
  
  A computing instance's associated account id
- getCreateDate
```
@Nullable
public Date getCreateDate()
```
  Returns:
  
  The date a virtual computing instance was created.
- getDomain
```
@Nullable
public String getDomain()
```
  Returns:
  
  A computing instance's domain name
- getFullyQualifiedDomainName
```
@Nullable
public String getFullyQualifiedDomainName()
```
  Returns:
  
  A name reflecting the hostname and domain of the computing instance.
- getHostname
```
@Nullable
public String getHostname()
```
  Returns:
  
  A virtual computing instance's hostname
- getId
```
public int getId()
```
  Returns:
  
  Unique ID for a computing instance.
- getLastVerifiedDate
```
@Nullable
public Date getLastVerifiedDate()
```
  Returns:
  
  The last timestamp of when the guest was verified as a resident virtual machine on the host's hypervisor platform.
- getMaxCpu
```
public int getMaxCpu()
```
  Returns:
  
  The maximum amount of CPU resources a computing instance may utilize.
- getMaxCpuUnits
```
@Nullable
public String getMaxCpuUnits()
```
  Returns:
  
  The unit of the maximum amount of CPU resources a computing instance may utilize.
- getMaxMemory
```
public int getMaxMemory()
```
  Returns:
  
  The maximum amount of memory a computing instance may utilize.
- getMetricPollDate
```
@Nullable
public Date getMetricPollDate()
```
  Returns:
  
  The date of the most recent metric tracking poll performed.
- getModifyDate
```
@Nullable
public Date getModifyDate()
```
  Returns:
  
  The date a virtual computing instance was last modified.
- getNotes
```
@Nullable
public String getNotes()
```
  Returns:
  
  A small note about a cloud instance to use at your discretion.
- getStartCpus
```
public int getStartCpus()
```
  Returns:
  
  The number of CPUs available to a computing instance upon startup.
- getStatusId
```
public int getStatusId()
```
  Returns:
  
  A computing instances status ID
- getUuid
```
@Nullable
public String getUuid()
```
  Returns:
  
  Unique ID for a computing instance's record on a virtualization platform.
- getPrimaryBackendIpAddress
```
@Nullable
public String getPrimaryBackendIpAddress()
```
  Returns:
  
  private ip address
- getPrimaryIpAddress
```
@Nullable
public String getPrimaryIpAddress()
```
  Returns:
  
  public ip address
- getBillingItemId
```
public int getBillingItemId()
```
  Returns:
  
  The billing item for a CloudLayer Compute Instance.
- getOperatingSystem
```
@Nullable
public OperatingSystem getOperatingSystem()
```
  Returns:
  
  A guest's operating system.
- getOperatingSystemReferenceCode
```
public String getOperatingSystemReferenceCode()
```
- getDatacenter
```
@Nullable
public Datacenter getDatacenter()
```
  Returns:
  
  The guest's datacenter
- getSoftwareLicense
```
@Nullable
public SoftwareLicense getSoftwareLicense()
```
  Returns:
  
  The softwareLicense of a virtual guest.
- getPowerState
```
@Nullable
public PowerState getPowerState()
```
  Returns:
  
  The current power state of a virtual guest.
- getActiveTransactionCount
```
public int getActiveTransactionCount()
```
- getVirtualGuestBlockDevices
```
@Nullable
public List<VirtualGuestBlockDevice> getVirtualGuestBlockDevices()
```
- isHourlyBillingFlag
```
public boolean isHourlyBillingFlag()
```
- isLocalDiskFlag
```
public boolean isLocalDiskFlag()
```
- isPrivateNetworkOnly
```
public boolean isPrivateNetworkOnly()
```
  Returns:
  
  Whether the computing instance only has access to the private network.
- isDedicatedAccountHostOnly
```
public boolean isDedicatedAccountHostOnly()
```
  Returns:
  
  When true this flag specifies that a compute instance is to run on hosts that only have guests from the same account.
- getVirtualGuestBlockDeviceTemplateGroup
```
public VirtualGuestBlockDeviceTemplateGroup getVirtualGuestBlockDeviceTemplateGroup()
```
- getVirtualGuestNetworkComponents
```
@Nullable
public Set<VirtualGuestNetworkComponent> getVirtualGuestNetworkComponents()
```
- getTagReferences
```
@Nullable
public Set<TagReference> getTagReferences()
```
- getPrimaryNetworkComponent
```
public VirtualGuestNetworkComponent getPrimaryNetworkComponent()
```
- getPrimaryBackendNetworkComponent
```
public VirtualGuestNetworkComponent getPrimaryBackendNetworkComponent()
```
- getPostInstallScriptUri
```
public String getPostInstallScriptUri()
```
- getVirtualGuestAttribute
```
public VirtualGuestAttribute getVirtualGuestAttribute()
```
- getSshKeys
```
public Set<SecuritySshKey> getSshKeys()
```
- hashCode
```
public int hashCode()
```
  Overrides:
  
  hashCode in class Object
- equals
```
public boolean equals(Object obj)
```
  Overrides:
  
  equals in class Object
- toString
```
public String toString()
```
  Overrides:
  
  toString in class Object

Modifier and Type	Class	Description
`static class`	`VirtualGuest.BillingItem`
`static class`	`VirtualGuest.Builder<T extends VirtualGuest.Builder<T>>`
`static class`	`VirtualGuest.State`	These states come from the powerState field.

Modifier and Type	Method	Description
`static VirtualGuest.Builder<?>`	`builder()`
`boolean`	`equals(Object obj)`
`int`	`getAccountId()`
`int`	`getActiveTransactionCount()`
`int`	`getBillingItemId()`
`Date`	`getCreateDate()`
`Datacenter`	`getDatacenter()`
`String`	`getDomain()`
`String`	`getFullyQualifiedDomainName()`
`String`	`getHostname()`
`int`	`getId()`
`Date`	`getLastVerifiedDate()`
`int`	`getMaxCpu()`
`String`	`getMaxCpuUnits()`
`int`	`getMaxMemory()`
`Date`	`getMetricPollDate()`
`Date`	`getModifyDate()`
`String`	`getNotes()`
`OperatingSystem`	`getOperatingSystem()`
`String`	`getOperatingSystemReferenceCode()`
`String`	`getPostInstallScriptUri()`
`PowerState`	`getPowerState()`
`String`	`getPrimaryBackendIpAddress()`
`VirtualGuestNetworkComponent`	`getPrimaryBackendNetworkComponent()`
`String`	`getPrimaryIpAddress()`
`VirtualGuestNetworkComponent`	`getPrimaryNetworkComponent()`
`SoftwareLicense`	`getSoftwareLicense()`
`Set<SecuritySshKey>`	`getSshKeys()`
`int`	`getStartCpus()`
`int`	`getStatusId()`
`Set<TagReference>`	`getTagReferences()`
`String`	`getUuid()`
`VirtualGuestAttribute`	`getVirtualGuestAttribute()`
`List<VirtualGuestBlockDevice>`	`getVirtualGuestBlockDevices()`
`VirtualGuestBlockDeviceTemplateGroup`	`getVirtualGuestBlockDeviceTemplateGroup()`
`Set<VirtualGuestNetworkComponent>`	`getVirtualGuestNetworkComponents()`
`int`	`hashCode()`
`boolean`	`isDedicatedAccountHostOnly()`
`boolean`	`isHourlyBillingFlag()`
`boolean`	`isLocalDiskFlag()`
`boolean`	`isPrivateNetworkOnly()`
`VirtualGuest.Builder<?>`	`toBuilder()`
`String`	`toString()`

Class VirtualGuest

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

VirtualGuest

Method Detail

builder

toBuilder

getAccountId

getCreateDate

getDomain

getFullyQualifiedDomainName

getHostname

getId

getLastVerifiedDate

getMaxCpu

getMaxCpuUnits

getMaxMemory

getMetricPollDate

getModifyDate

getNotes

getStartCpus

getStatusId

getUuid

getPrimaryBackendIpAddress

getPrimaryIpAddress

getBillingItemId

getOperatingSystem

getOperatingSystemReferenceCode

getDatacenter

getSoftwareLicense

getPowerState

getActiveTransactionCount

getVirtualGuestBlockDevices

isHourlyBillingFlag

isLocalDiskFlag

isPrivateNetworkOnly

isDedicatedAccountHostOnly

getVirtualGuestBlockDeviceTemplateGroup

getVirtualGuestNetworkComponents

getTagReferences

getPrimaryNetworkComponent

getPrimaryBackendNetworkComponent

getPostInstallScriptUri

getVirtualGuestAttribute

getSshKeys

hashCode

equals

toString