Resource Actions for the Fujitsu Global Cloud Platform (FGCP)

The following list gives an overview of the resource actions supported by this client API library that can be used in your scripts. This list is likely to be extended in future releases, and any suggestions are welcome in the issue tracker.

Example: [see tests/test_resource.py for more examples]

# Connect with your client certificate to region 'uk'
from fgcp.resource import FGCPVDataCenter
vdc = FGCPVDataCenter('client.pem', 'uk')

# Do typical resource actions
vsystem = vdc.get_vsystem('Python API Demo System')
vsystem.show_status()
for vserver in vsystem.vservers:
    result = vserver.backup(wait=True)
...

Note: this client API library also provides higher-level Client Methods and lower-level API Commands.


FGCPVDataCenter

http://mikespub.net/fgcp_vdatacenter_yuml.png

    from fgcp.resource import FGCPVDataCenter
    vdc = FGCPVDataCenter(key_file='client.pem', region='de', verbose=0, debug=0)

    status = vdc.status()
    #vdc.show_vsystem_status()

    date, usagelist = vdc.get_vsystem_usage(vsysNames=None)
    #vdc.show_vsystem_usage(vsysNames=None)

    vsystems = vdc.list_vsystems()
    #vsystem = vdc.get_vsystem('Python API Demo System')
    vsystem = vdc.get_vsystem('Demo System')
    test_vsystem(vsystem)

    #vsysId = vdc.create_vsystem('Python API Demo System', '2-tier Skeleton', wait=True)
    #result = vdc.destroy_vsystem('Python API Demo System', wait=True)

    publicips = vdc.list_publicips()
    publicip = vdc.get_publicip(publicips[0].address)
    test_publicip(publicip)

    addressranges = vdc.list_addressranges()
    #result = vdc.create_addresspool(pipFrom=None, pipTo=None)
    #result = vdc.add_addressrange(pipFrom, pipTo)
    #result = vdc.delete_addressrange(pipFrom, pipTo)

    vsysdescriptors = vdc.list_vsysdescriptors()
    vsysdescriptor = vdc.get_vsysdescriptor('2-tier Skeleton')
    test_vsysdescriptor(vsysdescriptor)

    diskimages = vdc.list_diskimages()
    diskimages = vdc.list_diskimages(vsysdescriptor)
    diskimage = vdc.get_diskimage('CentOS 5.4 32bit(EN)')
    test_diskimage(diskimage)

    servertypes = vdc.list_servertypes()
    servertypes = vdc.list_servertypes(diskimage)
    servertype = vdc.get_servertype('economy')
    test_servertype(servertype)

    design = vdc.get_vsystem_design('Demo System')
    test_design(design)

FGCPVSystem

http://mikespub.net/fgcp_vsystem_yuml.png

    #vsystem = vdc.get_vsystem('Python API Demo System')

    status = vsystem.status()

    date, usage = vsystem.get_usage()

    info = vsystem.get_status()
    vsystem.show_status()

    #result = vsystem.start(wait=True)
    #result = vsystem.stop(wait=True, force=None)

    #result = vsystem.update(vsysName='New Demo System', cloudCategory='PUBLIC')

    inventory = vsystem.get_inventory()

    vservers = vsystem.list_vservers()
    for vserver in vsystem.vservers:
        pass
    #vserver = vsystem.get_vserver('Server1')
    vserver = vsystem.get_vserver('DB1')
    test_vserver(vserver)

    #vserverId = vsystem.create_vserver('My New Server', 'economy', 'CentOS 5.4 32bit(EN)', 'DMZ')
    #result = vsystem.start_vserver('My New Server', wait=True)
    #result = vsystem.stop_vserver('My New Server', wait=True)
    #result = vsystem.destroy_vserver('My New Server', wait=True)

    vdisks = vsystem.list_vdisks()
    for vdisk in vsystem.vdisks:
        pass
    vdisk = vsystem.get_vdisk('DISK1')
    test_vdisk(vdisk)
    #result = vsystem.create_vdisk('DISK2', size=1500, wait=True)
    #result = vsystem.attach_vdisk('DISK2', 'My New Server', wait=True)
    #result = vsystem.detach_vdisk('DISK2', 'My New Server', wait=True)
    #result = vsystem.destroy_vdisk('DISK2', wait=True)

    test_vserver_vdisk(vserver, vdisk)

    firewalls = vsystem.list_firewalls()
    for firewall in vsystem.firewalls:
        pass
    firewall = vsystem.get_firewall('Firewall')
    test_firewall(firewall)

    loadbalancers = vsystem.list_loadbalancers()
    for loadbalancer in vsystem.loadbalancers:
        pass
    loadbalancer = vsystem.get_loadbalancer('SLB1')
    test_loadbalancer(loadbalancer)
    #result = vsystem.create_loadbalancer('SLB2', 'DMZ', wait=True)

    publicips = vsystem.list_publicips()
    for publicip in vsystem.publicips:
        pass
    publicip = vsystem.get_publicip(publicips[0].address)
    test_publicip(publicip)
    #result = vsystem.allocate_publicip(wait=True)

    vnets = vsystem.list_vnets()
    for vnet in vsystem.vnets:
        pass

    console = vsystem.get_console_url(vnets[0])

    #vsystem.vsysName = 'Copy of %s' % vsystem.vsysName
    #result = vsystem.create()

    #result = vsystem.detroy(wait=True)

FGCPVServer

http://mikespub.net/fgcp_vserver_yuml.png

    #vserver = vsystem.get_vserver('WepApp1')

    status = vserver.status()

    #result = vserver.start(wait=True)
    #result = vserver.stop(wait=True, force=None)

    #result = vserver.update(vserverName='New Server', vserverType='economy')

    config = vserver.get_configuration()
    vdisks = vserver.list_vdisks()
    for vdisk in vdisks:
        test_vdisk(vdisk)
        break
    #result = vserver.attach_vdisk(vdisk)
    #result = vserver.detach_vdisk(vdisk)

    vnics = vserver.list_vnics()
    for vnic in vnics:
        test_vnic(vnic)
        break

    backups = vserver.list_backups(timeZone=None, countryCode=None)
    for backup in backups:
        test_backup(backup)
        break
    #result = vserver.backup(wait=True)

    initialpwd = vserver.get_password()

    #vserver.vserverName = 'Copy of %s' % vserver.vserverName
    #result = vserver.create()

    #result = vserver.detroy(wait=True)

FGCPVDisk

http://mikespub.net/fgcp_vdisk_yuml.png

    status = vdisk.status()

    backups = vdisk.list_backups(timeZone=None, countryCode=None)
    for backup in backups:
        test_backup(backup)
        break
    #result = vdisk.backup(wait=True)

    #result = vdisk.update(vdiskName='New Disk')

    #result = vdisk.attach(vserver)
    #result = vdisk.detach(vserver)

    #vdisk.vdiskName = 'Copy of %s' % vdisk.vdiskName
    #result = vdisk.create()

    #result = vdisk.detroy(wait=True)

FGCPBackup

    #backup.restore(wait=True)
    #backup.destroy()

FGCPFirewall

http://mikespub.net/fgcp_firewall_yuml.png

    status = firewall.status()
    #result = firewall.start(wait=True)
    #result = firewall.stop(wait=True)

    #efmName = firewall.efmName
    #result = firewall.update(efmName=efmName)

    backups = firewall.list_backups(timeZone=None, countryCode=None)
    #result = firewall.backup(wait=True)

    nat_rules = firewall.get_nat_rules()
    #result = firewall.set_nat_rules(rules=nat_rules)

    dns = firewall.get_dns()
    #result = firewall.set_dns(dnstype='AUTO', primary=None, secondary=None)

    policies = firewall.get_policies(from_zone=None, to_zone=None)
    #result = firewall.set_policies(log='On', policies=policies)

    logs = firewall.get_log(num=10, orders=None)

    limit_policies = firewall.get_limit_policies(from_zone=None, to_zone=None)

    update_info = firewall.get_update_info()
    #result = firewall.apply_update()
    #result = firewall.revert_update()

FGCPLoadBalancer

http://mikespub.net/fgcp_loadbalancer_yuml.png

    status = loadbalancer.status()

    #result = loadbalancer.start(wait=True)
    #result = loadbalancer.stop(wait=True)

    #efmName = loadbalancer.efmName
    #result = loadbalancer.update(efmName=efmName)

    backups = loadbalancer.list_backups(timeZone=None, countryCode=None)
    for backup in backups:
        test_backup(backup)
        break
    #result = loadbalancer.backup(wait=True)

    rules = loadbalancer.get_rules()
    #result = loadbalancer.set_rules(groups=rules.groups, force=None, webAccelerator=None)
    #vserver1 = vsystem.get_vserver('WebApp1')
    #vserver2 = vsystem.get_vserver('WebApp2')
    #loadbalancer.add_group(id=10, protocol='http', targets=[vserver1, vserver2])
    #loadbalancer.delete_group(id=20)

    load_stats = loadbalancer.get_load_stats()
    #result = loadbalancer.clear_load_stats()
    error_stats = loadbalancer.get_error_stats()
    #result = loadbalancer.clear_error_stats()

    servercerts = loadbalancer.list_servercerts(detail=None)
    #result = loadbalancer.add_cert(certNum=5, filePath="server.pfx", passphrase='changeit')
    #result = loadbalancer.set_cert(certNum=5, groupId=10)
    #result = loadbalancer.release_cert(certNum=10)
    #result = loadbalancer.delete_cert(certNum=10, force=None)
    ccacerts = loadbalancer.list_ccacerts(detail=None)
    #result = loadbalancer.add_cca(ccacertNum=101, filePath='cacert.crt')
    #result = loadbalancer.delete_cca(ccacertNum=101)
    cert_list = loadbalancer.get_cert_list(certCategory=None, detail=None)

    #result = loadbalancer.start_maintenance(groupId=10, ipAddress='192.168.0.13', time=None, unit=None)
    #result = loadbalancer.stop_maintenance(groupId=10, ipAddress='192.168.0.13')

    update_info = loadbalancer.get_update_info()
    #result = loadbalancer.apply_update()
    #result = loadbalancer.revert_update()

    #result = loadbalancer.detroy()

FGCPPublicIP

    status = publicip.status()
    #result = publicip.attach(wait=True)
    #result = publicip.detach(wait=True)
    #result = publicip.free(wait=True)

FGCPAddressRange


FGCPVSysDescriptor

http://mikespub.net/fgcp_vsysdescriptor_yuml.png

    diskimages = vsysdescriptor.list_diskimages()
    #vsysId = vsysdescriptor.create_vsystem('Python API Demo System', wait=True)

    #vsysdescriptor.update(vsysdescriptorName='New VSYSDescriptor',
	#	description='This is a new vsysdescriptor', keyword='2-tier Skeleton')

FGCPDiskImage

http://mikespub.net/fgcp_diskimage_yuml.png

    softwares = diskimage.list_softwares()
    servertypes = diskimage.list_servertypes()

    #diskimage.update(diskimageName='New Disk Image', description='This is a new disk image')

FGCPServerType


FGCPDesign

    #design = vdc.get_vsystem_design()

    #vsystem = design.load_file('fgcp_demo_system.txt')
    vsystem = design.load_vsystem('Demo System')
    #result = design.build_vsystem('My New VSystem')
    design.save_file('new_demo_system.txt')
    design.load_file('new_demo_system.txt')

Note: this client API library also provides higher-level Client Methods and lower-level API Commands.

Content: index  ClientMethods.html  ResourceActions.html  APICommands.html  ClassDiagrams.html  TestServer.html  RelayServer.html  LibcloudDriver.html  REST_API.html  pydoc fgcp  pydoc fgcp.libcloud  pydoc tests