geni.aggregate.vts

class VTS(name, host, url=None)

Wrapper for all VTS-supposed AMAPI functions

exception InvalidRSpecPathError(path)

args

message

exception UnspecifiedComponentManagerError

args

message

addDNSResourceRecord(context, sname, client_id, record_name, record_type, record_value, record_ttl=7200)

addFlows(context, sname, flows)

addSSHKeys(context, sname, client_ids, keys)

amtype

api

changeController(context, sname, url, datapaths, ofver=None)

clearFlows(context, sname, datapaths)

Clear all installed flows from the requested datapaths.

Parameters:

• context – geni-lib context
• sname (str) – Slice name
• datapaths (list) – A list of datapath client_id strings

component_manager_id

createsliver(context, sname, rspec)

GENI AM APIv2 method to reserve resources at this aggregate.

Parameters:

• context – geni-lib context
• sname (str) – Slice name
• rspec (geni.rspec.RSpec) – Valid request RSpec

deleteDNSResourceRecord(context, sname, client_id, record_name, record_type)

deletesliver(context, sname)

GENI AM APIv2 method to delete a resource reservation at this aggregate.

Parameters:

• context – geni-lib context
• sname (str) – Slice name

dropboxFinalize(context, authcode)

Finalize the Dropbox account link for this aggregate.

Parameters:

• context – geni-lib context
• authcode (str) – Authorization code given by Dropbox

dropboxLink(context)

Link your user_urn to a Dropbox account at this aggregate.

Parameters:context – geni-lib context Returns:str – Dropbox authorization URL to paste into web browser

dropboxUpload(context, sname, cvols)

Trigger upload to associated Dropbox account from requested container volumes.

Parameters:

• context – geni-lib context
• sname (str) – Slice name
• cvols (list) – List of (container client-id, volume-id) tuples

dumpFlows(context, sname, datapaths, show_hidden=False)

Get the current flows and flow stats from the requested datapaths.

Parameters:

• context – geni-lib context
• sname (str) – Slice name
• datapaths (list) – A list of datapath client_id strings
• show_hidden (bool) – Show hidden flows (if any)

Returns:

dict – Key/Value dictionary of format { client_id : [(flow_field, ...), ...] }

dumpMACs(context, sname, datapaths)

getAllDNSResourceRecords(context, sname, client_ids)

getLastDNSDHCPops(context, sname, client_ids, number_of_operations, dns_OR_dhcp)

getLeaseInfo(context, sname, client_ids)

getPortInfo(context, sname, datapaths)

getSTPInfo(context, sname, datapaths)

getversion(context)

GENI AM API method to get the version information for this aggregate.

Parameters:context – geni-lib context Returns:dict – Dictionary of key/value pairs with version information from this aggregate.

listresources(context, sname=None, available=False)

GENI AM APIv2 method to get available resources from an aggregate, or resources allocated to a specific sliver.

Parameters:

• context – geni-lib context
• sname (str) – Slice name (optional)
• available (bool) – Only list available resources

Returns:

geni.rspec.RSpec – If sname is provided, listresources will return a manifest rspec for the given slice name. Otherwise, listresources will return the advertisement rspec for the given aggregate.

portDown(context, sname, client_id)

portUp(context, sname, client_id)

renewsliver(context, sname, date)

GENI AM APIv2 method to renew a sliver until the given datetime.

Parameters:

• context – geni-lib context
• sname (str) – Slice name
• date (str) – RFC 3339-compliant date string for new expiration date

Note

Aggregates may have maximum expiration limits, restricting how far in the future you can set your expiration. This call may result in an error in such cases, or success with a sooner future date.

setDHCPSubnet(context, sname, subnet_tuples)

setDeleteLock(context, sname)

Prevent the given sliver from being deleted by another user with the credential.

Note

Locks are cumulative, and removed by calling deletesliver. When the last locking user calls deletesliver, the sliver will be deleted. It is not possible to remove your lock without risking deletion.

Parameters:

• context – geni-lib context
• sname (str) – Slice name

setPortBehaviour(context, sname, port_list)

setPortTrunk(context, sname, port_list)

setPortVLAN(context, sname, port_tuples)

sliverstatus(context, sname)

GENI AM APIv2 method to get the status of a current sliver at the given aggregate.

Parameters:

• context – geni-lib context
• sname (str) – Slice name

Returns:

dict – Mapping of key/value pairs for status information the aggregate supports.

aggregates()

name_to_aggregate()