The novaclient.v1_1.servers Module

Server interface.

class novaclient.v1_1.servers.Server(manager, info, loaded=False)

Bases: novaclient.base.Resource

HUMAN_ID = True

actions()

Actions – Retrieve server actions.

add_fixed_ip(network_id)

Add an IP address on a network.

Parameters:network_id – The ID of the network the IP should be on.

add_floating_ip(address)

Add floating IP to an instance

Parameters:address – The ip address or FloatingIP to add to the instance

add_security_group(security_group)

Add a security group to an instance.

backup(backup_name, backup_type, rotation)

Backup a server instance.

Parameters:

• backup_name – Name of the backup image
• backup_type – The backup type, like ‘daily’ or ‘weekly’
• rotation – Int parameter representing how many backups to keep around.

change_password(password)

Update the password for a server.

confirm_resize()

Confirm that the resize worked, thus removing the original server.

create_image(image_name, metadata=None)

Create an image based on this server.

Parameters:

• image_name – The name to assign the newly create image.
• metadata – Metadata to assign to the image.

delete()

Delete (i.e. shut down and delete the image) this server.

diagnostics()

Diagnostics – Retrieve server diagnostics.

get_console_output(length=None)

Get text console log output from Server.

Parameters:length – The number of lines you would like to retrieve (as int)

get_vnc_console(console_type)

Get vnc console for a Server.

Parameters:console_type – Type of console (‘novnc’ or ‘xvpvnc’)

live_migrate(host, block_migration=False, disk_over_commit=False)

Migrates a running instance to a new machine.

lock()

Lock – Lock the instance from certain operations.

migrate()

Migrate a server to a new host.

networks

Generate a simplified list of addresses

pause()

Pause – Pause the running server.

reboot(reboot_type='SOFT')

Reboot the server.

Parameters:reboot_type – either REBOOT_SOFT for a software-level reboot, or REBOOT_HARD for a virtual power cycle hard reboot.

rebuild(image, password=None, **kwargs)

Rebuild – shut down and then re-image – this server.

Parameters:

• image – the Image (or its ID) to re-image with.
• password – string to set as password on the rebuilt server.

remove_fixed_ip(address)

Remove an IP address.

Parameters:address – The IP address to remove.

remove_floating_ip(address)

Remove floating IP from an instance

Parameters:address – The ip address or FloatingIP to remove

remove_security_group(security_group)

Remova a security group from an instance.

rescue()

Rescue – Rescue the problematic server.

reset_state(state='error')

Reset the state of an instance to active or error.

resize(flavor, **kwargs)

Resize the server’s resources.

Parameters:flavor – the Flavor (or its ID) to resize to.

Until a resize event is confirmed with confirm_resize(), the old server will be kept around and you’ll be able to roll back to the old flavor quickly with revert_resize(). All resizes are automatically confirmed after 24 hours.

resume()

Resume – Resume the suspended server.

revert_resize()

Revert a previous resize, switching back to the old server.

start()

Start – Start the paused server.

stop()

Stop – Stop the running server.

suspend()

Suspend – Suspend the running server.

unlock()

Unlock – Remove instance lock.

unpause()

Unpause – Unpause the paused server.

unrescue()

Unrescue – Unrescue the rescued server.

update(name=None)

Update the name or the password for this server.

Parameters:

• name – Update the server’s name.
• password – Update the root password.

class novaclient.v1_1.servers.ServerManager(api)

Bases: novaclient.v1_1.base.BootingManagerWithFind

actions(server)

Retrieve server actions.

add_fixed_ip(server, network_id)

Add an IP address on a network.

Parameters:

• server – The Server (or its ID) to add an IP to.
• network_id – The ID of the network the IP should be on.

add_floating_ip(server, address)

Add a floating ip to an instance

Parameters:

• server – The Server (or its ID) to add an IP to.
• address – The FloatingIP or string floating address to add.

add_security_group(server, security_group)

Add a Security Group to a instance

Parameters:

• server – ID of the instance.
• security_grou – The name of security group to add.

backup(server, backup_name, backup_type, rotation)

Backup a server instance.

Parameters:

• server – The Server (or its ID) to share onto.
• backup_name – Name of the backup image
• backup_type – The backup type, like ‘daily’ or ‘weekly’
• rotation – Int parameter representing how many backups to keep around.

change_password(server, password)

Update the password for a server.

confirm_resize(server)

Confirm that the resize worked, thus removing the original server.

Parameters:server – The Server (or its ID) to share onto.

create(name, image, flavor, meta=None, files=None, reservation_id=None, min_count=None, max_count=None, security_groups=None, userdata=None, key_name=None, availability_zone=None, block_device_mapping=None, nics=None, scheduler_hints=None, config_drive=None, **kwargs)

Create (boot) a new server.

Parameters:

• name – Something to name the server.
• image – The Image to boot with.
• flavor – The Flavor to boot onto.
• meta – A dict of arbitrary key/value metadata to store for this server. A maximum of five entries is allowed, and both keys and values must be 255 characters or less.
• files – A dict of files to overrwrite on the server upon boot. Keys are file names (i.e. /etc/passwd) and values are the file contents (either as a string or as a file-like object). A maximum of five entries is allowed, and each file must be 10k or less.
• userdata – user data to pass to be exposed by the metadata server this can be a file type object as well or a string.
• reservation_id – a UUID for the set of servers being requested.
• key_name – (optional extension) name of previously created keypair to inject into the instance.
• availability_zone – Name of the availability zone for instance placement.
• block_device_mapping – (optional extension) A dict of block device mappings for this server.
• nics – (optional extension) an ordered list of nics to be added to this server, with information about connected networks, fixed ips, port etc.
• scheduler_hints – (optional extension) arbitrary key-value pairs specified by the client to help boot an instance
• config_drive – (optional extension) value for config drive either boolean, or volume-id

create_image(server, image_name, metadata=None)

Snapshot a server.

Parameters:

• server – The Server (or its ID) to share onto.
• image_name – Name to give the snapshot image
• meta – Metadata to give newly-created image entity

delete(server)

Delete (i.e. shut down and delete the image) this server.

delete_meta(server, keys)

Delete metadata from an server :param server: The Server to add metadata to :param keys: A list of metadata keys to delete from the server

diagnostics(server)

Retrieve server diagnostics.

get(server)

Get a server.

Parameters:server – ID of the Server to get. Return type:Server

get_console_output(server, length=None)

Get text console log output from Server.

Parameters:

• server – The Server (or its ID) whose console output you would like to retrieve.
• length – The number of tail loglines you would like to retrieve.

get_vnc_console(server, console_type)

Get a vnc console for an instance

Parameters:

• server – The Server (or its ID) to add an IP to.
• console_type – Type of vnc console to get (‘novnc’ or ‘xvpvnc’)

list(detailed=True, search_opts=None)

Get a list of servers. Optional detailed returns details server info. Optional reservation_id only returns instances with that reservation_id.

Return type:list of Server

live_migrate(server, host, block_migration, disk_over_commit)

Migrates a running instance to a new machine.

Parameters:

• server – instance id which comes from nova list.
• host – destination host name.
• block_migration – if True, do block_migration.
• disk_over_commit – if True, Allow overcommit.

lock(server)

Lock the server.

migrate(server)

Migrate a server to a new host.

Parameters:server – The Server (or its ID).

pause(server)

Pause the server.

reboot(server, reboot_type='SOFT')

Reboot a server.

Parameters:

• server – The Server (or its ID) to share onto.
• reboot_type – either REBOOT_SOFT for a software-level reboot, or REBOOT_HARD for a virtual power cycle hard reboot.

rebuild(server, image, password=None, **kwargs)

Rebuild – shut down and then re-image – a server.

Parameters:

• server – The Server (or its ID) to share onto.
• image – the Image (or its ID) to re-image with.
• password – string to set as password on the rebuilt server.

remove_fixed_ip(server, address)

Remove an IP address.

Parameters:

• server – The Server (or its ID) to add an IP to.
• address – The IP address to remove.

remove_floating_ip(server, address)

Remove a floating IP address.

Parameters:

• server – The Server (or its ID) to remove an IP from.
• address – The FloatingIP or string floating address to remove.

remove_security_group(server, security_group)

Add a Security Group to a instance

Parameters:

• server – ID of the instance.
• security_grou – The name of security group to remove.

rescue(server)

Rescue the server.

reset_state(server, state='error')

Reset the state of an instance to active or error.

Parameters:

• server – ID of the instance to reset the state of.
• state – Desired state; either ‘active’ or ‘error’. Defaults to ‘error’.

resize(server, flavor, **kwargs)

Resize a server’s resources.

Parameters:

• server – The Server (or its ID) to share onto.
• flavor – the Flavor (or its ID) to resize to.

Until a resize event is confirmed with confirm_resize(), the old server will be kept around and you’ll be able to roll back to the old flavor quickly with revert_resize(). All resizes are automatically confirmed after 24 hours.

resource_class

alias of Server

resume(server)

Resume the server.

revert_resize(server)

Revert a previous resize, switching back to the old server.

Parameters:server – The Server (or its ID) to share onto.

set_meta(server, metadata)

Set a servers metadata :param server: The Server to add metadata to :param metadata: A dict of metadata to add to the server

start(server)

Start the server.

stop(server)

Stop the server.

suspend(server)

Suspend the server.

unlock(server)

Unlock the server.

unpause(server)

Unpause the server.

unrescue(server)

Unrescue the server.

update(server, name=None)

Update the name or the password for a server.

Parameters:

• server – The Server (or its ID) to update.
• name – Update the server’s name.