Method Detail

• createLocation

  <T extends Location> T createLocation(LocationSpec<T> spec)

  Creates a new location, which is tracked by the management context.

  Parameters:

  spec -

• createLocation

  <T extends Location> T createLocation(java.util.Map<?,?> config,
                                      java.lang.Class<T> type)

  Convenience (particularly for groovy code) to create a location. Equivalent to createLocation(LocationSpec.create(type).configure(config))

  See Also:

  createLocation(LocationSpec)

• getLocations

  java.util.Collection<Location> getLocations()

  All locations under control of this management plane. This returns a snapshot of the current locations; it will not reflect future changes in the locations. If no locations are found, the collection will be empty (i.e. null is never returned).

• getLocation

  Location getLocation(java.lang.String id)

  Returns the location under management (e.g. in use) with the given identifier (e.g. random string; and different to the LocationDefinition id). May return a full instance, or a proxy to one which is remote. If no location found with that id, returns null.

• isManaged

  boolean isManaged(Location loc)

  whether the location is under management by this management context

• manage

  Location manage(Location loc)

  Deprecated. in 0.6.0; use createLocation(LocationSpec) instead.
  Begins management for the given location and its children, recursively. depending on the implementation of the management context, this might push it out to one or more remote management nodes. Manage a location.

  Since:

  0.6.0 (added only for backwards compatibility, where locations are being created directly).

• unmanage

  void unmanage(Location loc)

  Causes the given location and its children, recursively, to be removed from the management plane (for instance because the location is no longer relevant). If the given location is not managed (e.g. it has already been unmanaged) then this is a no-op (though it may be logged so duplicate calls are best avoided).