On this page we detail the interfaces of the SFA as implemented by PlanetLab.
The registry interface is provided by the registry and it enables not only the mapping between HRN and GIDs, called a record, but it also issues the credentials and certificates for the records it manages.
Typeand with the given
GetCredential(), giving his or her user credentials as the first argument, to retrieve the credentials associated with the named slice. The
Typeargument is used to differentiate among multiple records with the same name, so for
Type=Slice, the return value is a “slice credential” that can subsequently be passed to the operations defined in the next section. Similarly, a call to
Type=SAreturns a “registry credential” that can subsequently be used to operate on records belonging to the named authority.
All operations are interpreted relative to a credential that specifies the context (authority) in which the operation is applied. For example, invoking
Register() with a
Credential that specifies
Type=Slice registers new slice with the Princeton slice authority.
The slice interface is used to create and control slices. It is provided both by the slice manager as well as by the aggregate manager.
xrn(the HRN or URN of the slice) filled with information from the database, including resources and attributes such as user keys and initscripts. This ticket binds the slice to the right to allocate the requested resources. Whether or not the call succeeds depends on the local resources available, and the resource allocation policy implemeted on behalf of the resource owner. The operations below are grouped according to their functionality.
Operations for the creation of a slice:
ticket. (Note: The parameter
credentialsare not the credentials provided to create the ticket, but the ones that allow the caller to redeem a ticket, e.g. they don't need to allow the caller to instantiate the slice, just to redeem the ticket).
Operations for the management of an already created slice:
Operations for the control of a slice:
Operations for information retrieval:
options, it must be included the RSpec version.