JcloudsLocation (Apache Brooklyn)

java.lang.Object
- brooklyn.basic.AbstractBrooklynObject
- - brooklyn.location.basic.AbstractLocation
  - - brooklyn.location.cloud.AbstractCloudMachineProvisioningLocation
    - - brooklyn.location.jclouds.JcloudsLocation

All Implemented Interfaces:

BrooklynObject, BrooklynObjectInternal, LocationWithObjectStore, Rebindable, Configurable, Identifiable, LocationInternal, CloudLocationConfig, HasHostGeoInfo, JcloudsLocationConfig, Location, MachineManagementMixins.GivesMachineMetadata, MachineManagementMixins.KillsMachines, MachineManagementMixins.ListsMachines, MachineManagementMixins.RichMachineProvisioningLocation<MachineLocation>, MachineProvisioningLocation<MachineLocation>, ProvisioningLocation<MachineLocation>, java.io.Serializable
```
public class JcloudsLocation
extends AbstractCloudMachineProvisioningLocation
implements JcloudsLocationConfig, MachineManagementMixins.RichMachineProvisioningLocation<MachineLocation>, LocationWithObjectStore
```
For provisioning and managing VMs in a particular provider/region, using jclouds. Configuration flags are defined in JcloudsLocationConfig.

See Also:
Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface JcloudsLocation.CustomizeTemplateOptions
- Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObject
  BrooklynObject.TagSupport
- Nested classes/interfaces inherited from interface brooklyn.entity.trait.Configurable
  Configurable.ConfigurationSupport
- Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObjectInternal
  BrooklynObjectInternal.ConfigurationSupportInternal

Nested Classes
Modifier and Type	Class and Description
`static interface`	`JcloudsLocation.CustomizeTemplateOptions`

Field Summary

Fields
Modifier and Type	Field and Description
`static java.util.List<java.lang.String>`	`COMMON_USER_NAMES_TO_TRY`
`static org.slf4j.Logger`	`LOG`
`static java.util.List<java.lang.String>`	`ROOT_ALIASES` these userNames are known to be the preferred/required logins in some common/default images where root@ is not allowed to log in
`static java.lang.String`	`ROOT_USERNAME`
`static java.util.Map<ConfigKey<?>,brooklyn.location.jclouds.JcloudsLocation.CustomizeTemplateBuilder>`	`SUPPORTED_TEMPLATE_BUILDER_PROPERTIES` properties which cause customization of the TemplateBuilder
`static java.util.Map<ConfigKey<?>,JcloudsLocation.CustomizeTemplateOptions>`	`SUPPORTED_TEMPLATE_OPTIONS_PROPERTIES` properties which cause customization of the TemplateOptions

Fields inherited from class brooklyn.location.basic.AbstractLocation
PARENT_LOCATION, TEMPORARY_LOCATION

Fields inherited from interface brooklyn.location.jclouds.JcloudsLocationConfig
AUTO_ASSIGN_FLOATING_IP, AUTO_CREATE_FLOATING_IPS, AUTO_GENERATE_KEYPAIRS, CLOUD_PROVIDER, COMPUTE_SERVICE_REGISTRY, CUSTOM_CREDENTIALS, CUSTOM_MACHINE_SETUP_SCRIPT_URL, CUSTOM_MACHINE_SETUP_SCRIPT_URL_LIST, CUSTOM_MACHINE_SETUP_SCRIPT_VARS, CUSTOM_TEMPLATE_OPTIONS_SCRIPT_CONTENTS, DEFAULT_IMAGE_ID, DISABLE_ROOT_AND_PASSWORD_SSH, DONT_CREATE_USER, EXTRA_PUBLIC_KEY_DATA_TO_AUTH, EXTRA_PUBLIC_KEY_URLS_TO_AUTH, GENERATE_HOSTNAME, GRANT_USER_SUDO, GROUP_ID, HARDWARE_ID, IMAGE_CHOOSER, IMAGE_DESCRIPTION_REGEX, IMAGE_ID, IMAGE_NAME_REGEX, INCLUDE_BROOKLYN_USER_METADATA, JCLOUDS_KEY_ENDPOINT, JCLOUDS_KEY_USERNAME, JCLOUDS_LOCATION_CUSTOMIZER, JCLOUDS_LOCATION_CUSTOMIZER_TYPE, JCLOUDS_LOCATION_CUSTOMIZERS, JCLOUDS_LOCATION_CUSTOMIZERS_SUPPLIER_TYPE, KEY_PAIR, LOCAL_TEMP_DIR, LOGIN_USER, LOGIN_USER_PASSWORD, LOGIN_USER_PRIVATE_KEY_DATA, LOGIN_USER_PRIVATE_KEY_FILE, MACHINE_CREATE_ATTEMPTS, MACHINE_CREATION_SEMAPHORE, MAP_DEV_RANDOM_TO_DEV_URANDOM, MAX_CONCURRENT_MACHINE_CREATIONS, NETWORK_NAME, OPEN_IPTABLES, OS_FAMILY, OS_FAMILY_OVERRIDE, OS_VERSION_REGEX, OVERRIDE_RAM, PORT_FORWARDER, PORT_FORWARDING_MANAGER, RUN_AS_ROOT, SECURITY_GROUPS, STOP_IPTABLES, STRING_TAGS, TAGS, TEMPLATE_BUILDER, TEMPLATE_OPTIONS, TEMPLATE_SPEC, USE_JCLOUDS_SSH_INIT, USE_PORT_FORWARDING, USER_DATA_UUENCODED, USER_METADATA, USER_METADATA_MAP, USER_METADATA_STRING

Fields inherited from interface brooklyn.location.basic.LocationInternal
FINAL_SPEC, NAMED_SPEC_NAME, ORIGINAL_SPEC

Constructor Summary

Constructors
Constructor and Description

JcloudsLocation()

JcloudsLocation(java.util.Map<?,?> conf)
typically wants at least ACCESS_IDENTITY and ACCESS_CREDENTIAL

Constructors
Constructor and Description
`JcloudsLocation()`
`JcloudsLocation(java.util.Map<?,?> conf)` typically wants at least ACCESS_IDENTITY and ACCESS_CREDENTIAL

Method Summary

Methods
Modifier and Type	Method and Description
`static java.io.File`	`asFile(java.lang.Object o)`
`org.jclouds.compute.domain.Template`	`buildTemplate(org.jclouds.compute.ComputeService computeService, ConfigBag config)` returns the jclouds Template which describes the image to be built, for the given config and compute service
`JcloudsLocation`	`configure(java.util.Map<?,?> properties)` Will set fields from flags, and put the remaining ones into the 'leftovers' map.
`static java.lang.String`	`fileAsString(java.lang.Object o)`
`static java.util.Set<ConfigKey<?>>`	`getAllSupportedProperties()`
`org.jclouds.compute.ComputeService`	`getComputeService()`
`org.jclouds.compute.ComputeService`	`getComputeService(java.util.Map<?,?> flags)`
`java.lang.String`	`getCredential()`
`java.lang.String`	`getEndpoint()`
`java.lang.String`	`getIdentity()`
`MachineManagementMixins.MachineMetadata`	`getMachineMetadata(MachineLocation l)` returns the MachineMetadata for a given (brooklyn) machine location instance, or null if not matched
`java.lang.String`	`getProvider()`
`java.util.Map<java.lang.String,java.lang.Object>`	`getProvisioningFlags(java.util.Collection<java.lang.String> tags)` Gets flags, suitable as an argument to `MachineProvisioningLocation.obtain(Map)`.
`java.lang.String`	`getRegion()` returns the location ID used by the provider, if set, e.g.
`java.lang.String`	`getUser(ConfigBag config)`
`void`	`init()` Called by framework (in new-style instances where spec was used) after configuring etc, but before a reference to this instance is shared.
`boolean`	`isLocationFirewalldEnabled(SshMachineLocation location)`
`boolean`	`isWindows(org.jclouds.compute.domain.Image image, ConfigBag config)` Whether VMs provisioned from this image will be Windows.
`boolean`	`isWindows(org.jclouds.compute.domain.NodeMetadata node, ConfigBag config)` Whether the given VM is Windows.
`boolean`	`isWindows(org.jclouds.compute.domain.Template template, ConfigBag config)`
`void`	`killMachine(MachineLocation l)` Kills the indicated machine; throws if not recognised or possible
`void`	`killMachine(java.lang.String cloudServiceId)` Kills the machine indicated by the given (server-side) machine id; note, the ID is the _cloud-service_ ID, that is, pass in getMetadata(machineLocation).getId() not the machineLocation.getId()
`java.util.Map<java.lang.String,MachineManagementMixins.MachineMetadata>`	`listMachines()` returns map of machine ID to metadata record for all machines known in a given cloud location
`java.util.Set<? extends org.jclouds.compute.domain.ComputeMetadata>`	`listNodes()` Deprecated. since 0.7.0 use `listMachines()`
`java.util.Set<? extends org.jclouds.compute.domain.ComputeMetadata>`	`listNodes(java.util.Map<?,?> flags)` Deprecated. since 0.7.0 use `listMachines()`. (no support for custom compute service flags; if that is needed, we'll have to introduce a new method, but it seems there are no usages)
`PersistenceObjectStore`	`newPersistenceObjectStore(java.lang.String container)` Creates a `PersistenceObjectStore` pointed at the given container/directory.
`JcloudsLocation`	`newSubLocation(java.lang.Class<? extends AbstractCloudMachineProvisioningLocation> type, java.util.Map<?,?> newFlags)`
`JcloudsLocation`	`newSubLocation(java.util.Map<?,?> newFlags)` uses reflection to create an object of the same type, assuming a Map constructor; subclasses can extend and downcast the result
`MachineLocation`	`obtain()`
`MachineLocation`	`obtain(java.util.Map<?,?> flags)` core method for obtaining a VM using jclouds; Map should contain CLOUD_PROVIDER and CLOUD_ENDPOINT or CLOUD_REGION, depending on the cloud, as well as ACCESS_IDENTITY and ACCESS_CREDENTIAL, plus any further properties to specify e.g.
`MachineLocation`	`obtain(java.util.Map<?,?> flags, org.jclouds.compute.domain.TemplateBuilder tb)`
`MachineLocation`	`obtain(org.jclouds.compute.domain.TemplateBuilder tb)`
`JcloudsSshMachineLocation`	`rebindMachine(ConfigBag setup)` Brings an existing machine with the given details under management.
`JcloudsSshMachineLocation`	`rebindMachine(java.util.Map<?,?> flags)`
`JcloudsSshMachineLocation`	`rebindMachine(java.util.Map<?,?> flags, org.jclouds.compute.domain.NodeMetadata metadata)`
`JcloudsSshMachineLocation`	`rebindMachine(org.jclouds.compute.domain.NodeMetadata metadata)`
`void`	`release(MachineLocation rawMachine)` Release a previously-obtained machine.
`void`	`setDefaultImageId(java.lang.String val)`
`void`	`setTagMapping(java.util.Map<java.lang.String,java.util.Map<java.lang.String,? extends java.lang.Object>> val)`
`java.lang.String`	`toString()` Default String representation is simplified name of class, together with selected fields.
`java.lang.String`	`toVerboseString()`

Methods inherited from class brooklyn.location.basic.AbstractLocation
addChild, addExtension, config, containsLocation, equals, getAllConfig, getAllConfigBag, getChildren, getConfig, getConfig, getDisplayName, getExtension, getHostGeoInfo, getLocalConfigBag, getParent, getRawLocalConfigBag, getRebindSupport, hasConfig, hasExtension, hashCode, isManaged, onManagementStarted, onManagementStopped, removeChild, setConfig, setDisplayName, setHostGeoInfo, setManagementContext, setName, setParent, setParent, toMetadataRecord

Methods inherited from class brooklyn.basic.AbstractBrooklynObject
getCatalogItemId, getId, getManagementContext, getTagSupport, rebind, setCatalogItemId, tags

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

Methods inherited from interface brooklyn.location.Location
containsLocation, getAllConfig, getChildren, getConfig, getConfig, getDisplayName, getExtension, getId, getParent, hasConfig, hasExtension, setParent

Methods inherited from interface brooklyn.basic.BrooklynObject
getCatalogItemId, getTagSupport, tags

Methods inherited from interface brooklyn.entity.trait.Configurable
config, setConfig

Methods inherited from interface brooklyn.location.basic.LocationInternal
getManagementContext

Methods inherited from interface brooklyn.basic.BrooklynObjectInternal
setCatalogItemId

- Field Detail
  - LOG
```
public static final org.slf4j.Logger LOG
```
  - ROOT_USERNAME
```
public static final java.lang.String ROOT_USERNAME
```
    See Also:
    Constant Field Values
  - ROOT_ALIASES
```
public static final java.util.List<java.lang.String> ROOT_ALIASES
```
    these userNames are known to be the preferred/required logins in some common/default images where root@ is not allowed to log in
  - COMMON_USER_NAMES_TO_TRY
```
public static final java.util.List<java.lang.String> COMMON_USER_NAMES_TO_TRY
```
  - SUPPORTED_TEMPLATE_BUILDER_PROPERTIES
```
public static final java.util.Map<ConfigKey<?>,brooklyn.location.jclouds.JcloudsLocation.CustomizeTemplateBuilder> SUPPORTED_TEMPLATE_BUILDER_PROPERTIES
```
    properties which cause customization of the TemplateBuilder
  - SUPPORTED_TEMPLATE_OPTIONS_PROPERTIES
```
public static final java.util.Map<ConfigKey<?>,JcloudsLocation.CustomizeTemplateOptions> SUPPORTED_TEMPLATE_OPTIONS_PROPERTIES
```
    properties which cause customization of the TemplateOptions
- Constructor Detail
  - JcloudsLocation
```
public JcloudsLocation()
```
  - JcloudsLocation
```
public JcloudsLocation(java.util.Map<?,?> conf)
```
    typically wants at least ACCESS_IDENTITY and ACCESS_CREDENTIAL
- Method Detail
  - configure
```
public JcloudsLocation configure(java.util.Map<?,?> properties)
```
    Description copied from class: AbstractBrooklynObject
    
    Will set fields from flags, and put the remaining ones into the 'leftovers' map. For some types, you can find unused config via ConfigBag.getUnusedConfig().
    To be overridden by AbstractEntity, AbstractLoation, AbstractPolicy, AbstractEnricher, etc.
    But should not be overridden by specific entity types. If you do, the entity may break in subsequent releases. Also note that if you require fields to be initialized you must do that in this method. You must *not* rely on field initializers because they may not run until *after* this method (this method is invoked by the constructor in this class, so initializers in subclasses will not have run when this overridden method is invoked.)
    
    Overrides:
    
    configure in class AbstractLocation
  - init
```
public void init()
```
    Description copied from class: AbstractBrooklynObject
    Called by framework (in new-style instances where spec was used) after configuring etc, but before a reference to this instance is shared.
    To preserve backwards compatibility for if the instance is constructed directly, one can call the code below, but that means it will be called after references to this policy have been shared with other entities.
```
 if (isLegacyConstruction()) {
     init();
 }
 
 
```
    Overrides:
    
    init in class AbstractBrooklynObject
  - newSubLocation
```
public JcloudsLocation newSubLocation(java.util.Map<?,?> newFlags)
```
    Description copied from class: AbstractCloudMachineProvisioningLocation
    
    uses reflection to create an object of the same type, assuming a Map constructor; subclasses can extend and downcast the result
    
    Specified by:
    
    newSubLocation in interface MachineProvisioningLocation<MachineLocation>
    
    Overrides:
    
    newSubLocation in class AbstractCloudMachineProvisioningLocation
  - newSubLocation
```
public JcloudsLocation newSubLocation(java.lang.Class<? extends AbstractCloudMachineProvisioningLocation> type,
                             java.util.Map<?,?> newFlags)
```
    Overrides:
    
    newSubLocation in class AbstractCloudMachineProvisioningLocation
  - toString
```
public java.lang.String toString()
```
    Description copied from class: AbstractLocation
    
    Default String representation is simplified name of class, together with selected fields.
    
    Overrides:
    
    toString in class AbstractLocation
  - toVerboseString
```
public java.lang.String toVerboseString()
```
    Specified by:
    
    toVerboseString in interface Location
    
    Overrides:
    
    toVerboseString in class AbstractLocation
    
    Returns:
    meta-data about the location (usually a long line, or a small number of lines).
  - getProvider
```
public java.lang.String getProvider()
```
  - getIdentity
```
public java.lang.String getIdentity()
```
  - getCredential
```
public java.lang.String getCredential()
```
  - getRegion
```
public java.lang.String getRegion()
```
    returns the location ID used by the provider, if set, e.g. us-west-1
  - getEndpoint
```
public java.lang.String getEndpoint()
```
  - getUser
```
public java.lang.String getUser(ConfigBag config)
```
  - isWindows
```
public boolean isWindows(org.jclouds.compute.domain.Template template,
                ConfigBag config)
```
  - isWindows
```
public boolean isWindows(org.jclouds.compute.domain.Image image,
                ConfigBag config)
```
    Whether VMs provisioned from this image will be Windows. Assume windows if the image explicitly says so, or if image does not tell us then fall back to whether the config explicitly says windows in JcloudsLocationConfig.OS_FAMILY. Will first look at JcloudsLocationConfig.OS_FAMILY_OVERRIDE, to check if that is set. If so, no further checks are done: the value is compared against OsFamily.WINDOWS. We believe the config (e.g. from brooklyn.properties) because for some clouds there is insufficient meta-data so the Image might not tell us. Thus a user can work around it by explicitly supplying configuration.
  - isWindows
```
public boolean isWindows(org.jclouds.compute.domain.NodeMetadata node,
                ConfigBag config)
```
    Whether the given VM is Windows.
    
    See Also:
    #isWindows(Image, ConfigBag)}
  - isLocationFirewalldEnabled
```
public boolean isLocationFirewalldEnabled(SshMachineLocation location)
```
  - setDefaultImageId
```
public void setDefaultImageId(java.lang.String val)
```
  - setTagMapping
```
public void setTagMapping(java.util.Map<java.lang.String,java.util.Map<java.lang.String,? extends java.lang.Object>> val)
```
  - getProvisioningFlags
```
public java.util.Map<java.lang.String,java.lang.Object> getProvisioningFlags(java.util.Collection<java.lang.String> tags)
```
    Description copied from interface: MachineProvisioningLocation
    
    Gets flags, suitable as an argument to MachineProvisioningLocation.obtain(Map). The tags provided give hints about the machine required. The provisioning-location could be configured to understand those tags. For example, an AWS-location could be configured to understand that a particular entity type (e.g. "TomcatServer") requires a particular AMI in that region, so would return the required image id.
    
    Specified by:
    
    getProvisioningFlags in interface MachineProvisioningLocation<MachineLocation>
    
    Overrides:
    
    getProvisioningFlags in class AbstractCloudMachineProvisioningLocation
    
    Returns:
  - getAllSupportedProperties
```
public static final java.util.Set<ConfigKey<?>> getAllSupportedProperties()
```
  - getComputeService
```
public org.jclouds.compute.ComputeService getComputeService()
```
  - getComputeService
```
public org.jclouds.compute.ComputeService getComputeService(java.util.Map<?,?> flags)
```
  - listNodes
```
@Deprecated
public java.util.Set<? extends org.jclouds.compute.domain.ComputeMetadata> listNodes()
```
    Deprecated. since 0.7.0 use listMachines()
  - listNodes
```
@Deprecated
public java.util.Set<? extends org.jclouds.compute.domain.ComputeMetadata> listNodes(java.util.Map<?,?> flags)
```
    Deprecated. since 0.7.0 use listMachines(). (no support for custom compute service flags; if that is needed, we'll have to introduce a new method, but it seems there are no usages)
  - listMachines
```
public java.util.Map<java.lang.String,MachineManagementMixins.MachineMetadata> listMachines()
```
    Description copied from interface: MachineManagementMixins.ListsMachines
    
    returns map of machine ID to metadata record for all machines known in a given cloud location
    
    Specified by:
    
    listMachines in interface MachineManagementMixins.ListsMachines
  - getMachineMetadata
```
public MachineManagementMixins.MachineMetadata getMachineMetadata(MachineLocation l)
```
    Description copied from interface: MachineManagementMixins.GivesMachineMetadata
    
    returns the MachineMetadata for a given (brooklyn) machine location instance, or null if not matched
    
    Specified by:
    
    getMachineMetadata in interface MachineManagementMixins.GivesMachineMetadata
  - killMachine
```
public void killMachine(java.lang.String cloudServiceId)
```
    Description copied from interface: MachineManagementMixins.KillsMachines
    
    Kills the machine indicated by the given (server-side) machine id; note, the ID is the _cloud-service_ ID, that is, pass in getMetadata(machineLocation).getId() not the machineLocation.getId()
    
    Specified by:
    
    killMachine in interface MachineManagementMixins.KillsMachines
  - killMachine
```
public void killMachine(MachineLocation l)
```
    Description copied from interface: MachineManagementMixins.KillsMachines
    
    Kills the indicated machine; throws if not recognised or possible
    
    Specified by:
    
    killMachine in interface MachineManagementMixins.KillsMachines
  - obtain
```
public MachineLocation obtain()
                       throws NoMachinesAvailableException
```
    Throws:
    
    NoMachinesAvailableException
  - obtain
```
public MachineLocation obtain(org.jclouds.compute.domain.TemplateBuilder tb)
                       throws NoMachinesAvailableException
```
    Throws:
    
    NoMachinesAvailableException
  - obtain
```
public MachineLocation obtain(java.util.Map<?,?> flags,
                     org.jclouds.compute.domain.TemplateBuilder tb)
                       throws NoMachinesAvailableException
```
    Throws:
    
    NoMachinesAvailableException
  - obtain
```
public MachineLocation obtain(java.util.Map<?,?> flags)
                       throws NoMachinesAvailableException
```
    core method for obtaining a VM using jclouds; Map should contain CLOUD_PROVIDER and CLOUD_ENDPOINT or CLOUD_REGION, depending on the cloud, as well as ACCESS_IDENTITY and ACCESS_CREDENTIAL, plus any further properties to specify e.g. images, hardware profiles, accessing user (for initial login, and a user potentially to create for subsequent ie normal access)
    
    Specified by:
    
    obtain in interface MachineProvisioningLocation<MachineLocation>
    
    Specified by:
    
    obtain in interface ProvisioningLocation<MachineLocation>
    
    Parameters:
    flags - Details of the desired machine (e.g. image, size, open ports, etc; some flag support is limited to selected providers). "callerContext" can be specified to have custom logging and error messages (useful if starting machines in parallel)
    
    Returns:
    a machine that is a child of this location.
    
    Throws:
    
    NoMachinesAvailableException - if there are no machines available in this location (or impls may return null, but that is discouraged)
  - buildTemplate
```
public org.jclouds.compute.domain.Template buildTemplate(org.jclouds.compute.ComputeService computeService,
                                                ConfigBag config)
```
    returns the jclouds Template which describes the image to be built, for the given config and compute service
  - rebindMachine
```
public JcloudsSshMachineLocation rebindMachine(org.jclouds.compute.domain.NodeMetadata metadata)
                                        throws NoMachinesAvailableException
```
    Throws:
    
    NoMachinesAvailableException
  - rebindMachine
```
public JcloudsSshMachineLocation rebindMachine(java.util.Map<?,?> flags,
                                      org.jclouds.compute.domain.NodeMetadata metadata)
                                        throws NoMachinesAvailableException
```
    Throws:
    
    NoMachinesAvailableException
  - rebindMachine
```
public JcloudsSshMachineLocation rebindMachine(ConfigBag setup)
                                        throws NoMachinesAvailableException
```
    Brings an existing machine with the given details under management.
    Required fields are:
    - id: the jclouds VM id, e.g. "eu-west-1/i-5504f21d" (NB this is @see JcloudsSshMachineLocation#getJcloudsId() not #getId())
    - hostname: the public hostname or IP of the machine, e.g. "ec2-176-34-93-58.eu-west-1.compute.amazonaws.com"
    - userName: the username for ssh'ing into the machine
    Throws:
    
    NoMachinesAvailableException
  - rebindMachine
```
public JcloudsSshMachineLocation rebindMachine(java.util.Map<?,?> flags)
                                        throws NoMachinesAvailableException
```
    Throws:
    
    NoMachinesAvailableException
  - release
```
public void release(MachineLocation rawMachine)
```
    Description copied from interface: MachineProvisioningLocation
    
    Release a previously-obtained machine.
    
    Specified by:
    
    release in interface MachineProvisioningLocation<MachineLocation>
    
    Specified by:
    
    release in interface ProvisioningLocation<MachineLocation>
    
    Parameters:
    rawMachine - a MachineLocation previously obtained from a call to #obtain()
  - asFile
```
public static java.io.File asFile(java.lang.Object o)
```
  - fileAsString
```
public static java.lang.String fileAsString(java.lang.Object o)
```
  - newPersistenceObjectStore
```
public PersistenceObjectStore newPersistenceObjectStore(java.lang.String container)
```
    Description copied from interface: LocationWithObjectStore
    
    Creates a PersistenceObjectStore pointed at the given container/directory.
    
    Specified by:
    
    newPersistenceObjectStore in interface LocationWithObjectStore

Class JcloudsLocation

Nested Class Summary

Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObject

Nested classes/interfaces inherited from interface brooklyn.entity.trait.Configurable

Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObjectInternal

Field Summary

Fields inherited from class brooklyn.location.basic.AbstractLocation

Fields inherited from interface brooklyn.location.jclouds.JcloudsLocationConfig

Fields inherited from interface brooklyn.location.cloud.CloudLocationConfig

Fields inherited from interface brooklyn.location.basic.LocationInternal

Constructor Summary

Method Summary

Methods inherited from class brooklyn.location.basic.AbstractLocation

Methods inherited from class brooklyn.basic.AbstractBrooklynObject

Methods inherited from class java.lang.Object

Methods inherited from interface brooklyn.location.Location

Methods inherited from interface brooklyn.basic.BrooklynObject

Methods inherited from interface brooklyn.entity.trait.Configurable

Methods inherited from interface brooklyn.location.basic.LocationInternal

Methods inherited from interface brooklyn.basic.BrooklynObjectInternal

Field Detail

LOG

ROOT_USERNAME

ROOT_ALIASES

COMMON_USER_NAMES_TO_TRY

SUPPORTED_TEMPLATE_BUILDER_PROPERTIES

SUPPORTED_TEMPLATE_OPTIONS_PROPERTIES

Constructor Detail

JcloudsLocation

JcloudsLocation

Method Detail

configure

init

newSubLocation

newSubLocation

toString

toVerboseString

getProvider

getIdentity

getCredential

getRegion

getEndpoint

getUser

isWindows

isWindows

isWindows

isLocationFirewalldEnabled

setDefaultImageId

setTagMapping

getProvisioningFlags

getAllSupportedProperties

getComputeService

getComputeService

listNodes

listNodes

listMachines

getMachineMetadata

killMachine

killMachine

obtain

obtain

obtain

obtain

buildTemplate

rebindMachine

rebindMachine

rebindMachine

rebindMachine

release

asFile

fileAsString

newPersistenceObjectStore