For details on how to use compute, see Using OpenStack Compute
The compute high-level interface is available through the compute
member of a Connection
object. The
compute
member will only be added if the service is detected.
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)¶create_server
(**attrs)¶Create a new Server from attributes
Parameters: | attrs (dict) – Keyword arguments which will be used to create a
Server . |
---|---|
Returns: | The results of Server creation |
Return type: | Server |
update_server
(server, **attrs)¶Update a server
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Attrs kwargs: | The attributes to update on the server represented
by server . |
Returns: | The updated server |
Return type: | Server |
delete_server
(server, ignore_missing=True, force=False)¶Delete a server
Parameters: |
|
---|---|
Returns: |
|
get_server
(server)¶Get a single Server
Parameters: | server – The value can be the ID of a server or a
Server instance. |
---|---|
Returns: | One Server |
Raises: | ResourceNotFound
when no resource can be found. |
find_server
(name_or_id, ignore_missing=True)¶Find a single Server
Parameters: |
|
---|---|
Returns: | One |
servers
(details=True, **query)¶Retrieve a generator of servers
Parameters: |
|
---|---|
Returns: | A generator of server instances. |
get_server_metadata
(server)¶Return a dictionary of metadata for a server
Parameters: | server – Either the ID of a server or a
Server or
ServerDetail
instance. |
---|---|
Returns: | A Server with only the
server’s metadata. All keys and values are Unicode text. |
Return type: | Server |
set_server_metadata
(server, **metadata)¶Update metadata for a server
Parameters: |
|
---|---|
Returns: | A |
Return type: |
delete_server_metadata
(server, keys)¶Delete metadata for a server
Note: This method will do a HTTP DELETE request for every key in keys.
Parameters: |
|
---|---|
Return type: |
|
wait_for_server
(server, status='ACTIVE', failures=['ERROR'], interval=2, wait=120)¶create_server_image
(server, name, metadata=None)¶Create an image from a server
Parameters: |
|
---|---|
Returns: | None |
backup_server
(server, name, backup_type, rotation)¶Backup a server
Parameters: |
|
---|---|
Returns: | None |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)add_fixed_ip_to_server
(server, network_id)¶Adds a fixed IP address to a server instance.
Parameters: |
|
---|---|
Returns: | None |
remove_fixed_ip_from_server
(server, address)¶Removes a fixed IP address from a server instance.
Parameters: |
|
---|---|
Returns: | None |
add_floating_ip_to_server
(server, address, fixed_address=None)¶Adds a floating IP address to a server instance.
Parameters: |
|
---|---|
Returns: | None |
remove_floating_ip_from_server
(server, address)¶Removes a floating IP address from a server instance.
Parameters: |
|
---|---|
Returns: | None |
add_security_group_to_server
(server, security_group)¶Add a security group to a server
Parameters: |
|
---|---|
Returns: | None |
remove_security_group_from_server
(server, security_group)¶Remove a security group from a server
Parameters: |
|
---|---|
Returns: | None |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)start_server
(server)¶Starts a stopped server and changes its state to ACTIVE
.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
stop_server
(server)¶Stops a running server and changes its state to SHUTOFF
.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
suspend_server
(server)¶Suspends a server and changes its status to SUSPENDED
.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
resume_server
(server)¶Resumes a suspended server and changes its status to ACTIVE
.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
reboot_server
(server, reboot_type)¶Reboot a server
Parameters: |
|
---|---|
Returns: | None |
shelve_server
(server)¶Shelves a server.
All associated data and resources are kept but anything still in memory is not retained. Policy defaults enable only users with administrative role or the owner of the server to perform this operation. Cloud provides could change this permission though.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
unshelve_server
(server)¶Unselves or restores a shelved server.
Policy defaults enable only users with administrative role or the owner of the server to perform this operation. Cloud provides could change this permission though.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
lock_server
(server)¶Locks a server.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
unlock_server
(server)¶Unlocks a locked server.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
pause_server
(server)¶Pauses a server and changes its status to PAUSED
.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
unpause_server
(server)¶Unpauses a paused server and changes its status to ACTIVE
.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
rescue_server
(server, admin_pass=None, image_ref=None)¶Puts a server in rescue mode and changes it status to RESCUE
.
Parameters: |
|
---|---|
Returns: | None |
unrescue_server
(server)¶Unrescues a server and changes its status to ACTIVE
.
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
evacuate_server
(server, host=None, admin_pass=None, force=None)¶Evacuates a server from a failed host to a new host.
Parameters: |
|
---|---|
Returns: | None |
migrate_server
(server)¶Migrate a server from one host to another
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
get_server_console_output
(server, length=None)¶Return the console output for a server.
Parameters: |
|
---|---|
Returns: | The console output as a dict. Control characters will be escaped to create a valid JSON string. |
live_migrate_server
(server, host=None, force=False)¶Migrate a server from one host to target host
Parameters: |
|
---|---|
Returns: | None |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)resize_server
(server, flavor)¶Resize a server
Parameters: | |
---|---|
Returns: | None |
confirm_server_resize
(server)¶Confirm a server resize
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
revert_server_resize
(server)¶Revert a server resize
Parameters: | server – Either the ID of a server or a
Server instance. |
---|---|
Returns: | None |
rebuild_server
(server, name, admin_password, **attrs)¶Rebuild a server
Parameters: |
|
---|---|
Returns: | The rebuilt |
reset_server_state
(server, state)¶Reset the state of server
Parameters: |
|
---|---|
Returns: | None |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)images
(details=True, **query)¶Return a generator of images
Parameters: |
|
---|---|
Returns: | A generator of image objects |
get_image
(image)¶Get a single image
Parameters: | image – The value can be the ID of an image or a
Image instance. |
---|---|
Returns: | One Image |
Raises: | ResourceNotFound
when no resource can be found. |
find_image
(name_or_id, ignore_missing=True)¶Find a single image
Parameters: |
|
---|---|
Returns: | One |
delete_image
(image, ignore_missing=True)¶Delete an image
Parameters: |
|
---|---|
Returns: |
|
get_image_metadata
(image)¶Return a dictionary of metadata for an image
Parameters: | image – Either the ID of an image or a
Image or
ImageDetail
instance. |
---|---|
Returns: | A Image with only the
image’s metadata. All keys and values are Unicode text. |
Return type: | Image |
set_image_metadata
(image, **metadata)¶Update metadata for an image
Parameters: |
|
---|---|
Returns: | A |
Return type: |
delete_image_metadata
(image, keys)¶Delete metadata for an image
Note: This method will do a HTTP DELETE request for every key in keys.
Parameters: |
|
---|---|
Return type: |
|
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)create_flavor
(**attrs)¶Create a new Flavor from attributes
Parameters: | attrs (dict) – Keyword arguments which will be used to create a
Flavor . |
---|---|
Returns: | The results of Flavor creation |
Return type: | Flavor |
delete_flavor
(flavor, ignore_missing=True)¶Delete a Flavor
Parameters: |
|
---|---|
Returns: |
|
get_flavor
(flavor)¶Get a single Flavor
Parameters: | flavor – The value can be the ID of a flavor or a
Flavor instance. |
---|---|
Returns: | One Flavor |
Raises: | ResourceNotFound
when no resource can be found. |
find_flavor
(name_or_id, ignore_missing=True)¶Find a single Flavor
Parameters: |
|
---|---|
Returns: | One |
flavors
(details=True, **query)¶Retrieve a generator of all Flavor
Parameters: |
|
---|---|
Returns: | A generator of Flavor instances. |
Return type: |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)services
()¶Return a generator of service
Returns: | A generator of service |
---|---|
Return type: | class: ~openstack.compute.v2.service.Service |
enable_service
(service, host, binary)¶Enable a service
Parameters: |
|
---|---|
Returns: | None |
disable_service
(service, host, binary, disabled_reason=None)¶Disable a service
Parameters: |
|
---|---|
Returns: | None |
force_service_down
(service, host, binary)¶Force a service down
Parameters: |
|
---|---|
Returns: | None |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)create_volume_attachment
(server, **attrs)¶Create a new volume attachment from attributes
Parameters: |
|
---|---|
Returns: | The results of volume attachment creation |
Return type: |
|
update_volume_attachment
(volume_attachment, server, **attrs)¶update a volume attachment
Parameters: |
|
---|---|
Returns: |
|
delete_volume_attachment
(volume_attachment, server, ignore_missing=True)¶Delete a volume attachment
Parameters: |
|
---|---|
Returns: |
|
get_volume_attachment
(volume_attachment, server, ignore_missing=True)¶Get a single volume attachment
Parameters: |
|
---|---|
Returns: | One
|
Raises: |
|
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)create_keypair
(**attrs)¶Create a new keypair from attributes
Parameters: | attrs (dict) – Keyword arguments which will be used to create
a Keypair ,
comprised of the properties on the Keypair class. |
---|---|
Returns: | The results of keypair creation |
Return type: | Keypair |
delete_keypair
(keypair, ignore_missing=True)¶Delete a keypair
Parameters: |
|
---|---|
Returns: |
|
get_keypair
(keypair)¶Get a single keypair
Parameters: | keypair – The value can be the ID of a keypair or a
Keypair
instance. |
---|---|
Returns: | One Keypair |
Raises: | ResourceNotFound
when no resource can be found. |
find_keypair
(name_or_id, ignore_missing=True)¶Find a single keypair
Parameters: |
|
---|---|
Returns: | One |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)create_server_group
(**attrs)¶Create a new server group from attributes
Parameters: | attrs (dict) – Keyword arguments which will be used to create
a ServerGroup ,
comprised of the properties on the ServerGroup class. |
---|---|
Returns: | The results of server group creation |
Return type: | ServerGroup |
delete_server_group
(server_group, ignore_missing=True)¶Delete a server group
Parameters: |
|
---|---|
Returns: |
|
get_server_group
(server_group)¶Get a single server group
Parameters: | server_group – The value can be the ID of a server group or a
ServerGroup
instance. |
---|---|
Returns: | A ServerGroup object. |
Raises: | ResourceNotFound
when no resource can be found. |
find_server_group
(name_or_id, ignore_missing=True)¶Find a single server group
Parameters: |
|
---|---|
Returns: | One |
server_groups
(**query)¶Return a generator of server groups
Parameters: | **query (kwargs) – Optional query parameters to be sent to limit the resources being returned. |
---|---|
Returns: | A generator of ServerGroup objects |
Return type: | ServerGroup |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)create_server_interface
(server, **attrs)¶Create a new server interface from attributes
Parameters: |
|
---|---|
Returns: | The results of server interface creation |
Return type: |
delete_server_interface
(server_interface, server=None, ignore_missing=True)¶Delete a server interface
Parameters: |
|
---|---|
Returns: |
|
get_server_interface
(server_interface, server=None)¶Get a single server interface
Parameters: |
|
---|---|
Returns: | One
|
Raises: |
|
server_interfaces
(server)¶Return a generator of server interfaces
Parameters: | server – The server can be either the ID of a server or a
Server . |
---|---|
Returns: | A generator of ServerInterface objects |
Return type: | ServerInterface |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)availability_zones
(details=False)¶Return a generator of availability zones
Parameters: | details (bool) – Return extra details about the availability zones. This defaults to False as it generally requires extra permission. |
---|---|
Returns: | A generator of availability zone |
Return type: | AvailabilityZone |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)get_limits
()¶Retrieve limits that are applied to the project’s account
Returns: | A Limits object, including both
AbsoluteLimits and
RateLimits |
---|---|
Return type: | Limits |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)get_hypervisor
(hypervisor)¶Get a single hypervisor
Parameters: | hypervisor – The value can be the ID of a hypervisor or a
Hypervisor
instance. |
---|---|
Returns: | A Hypervisor object. |
Raises: | ResourceNotFound
when no resource can be found. |
find_hypervisor
(name_or_id, ignore_missing=True)¶Find a hypervisor from name or id to get the corresponding info
Parameters: | name_or_id – The name or id of a hypervisor |
---|---|
Returns: | One: class:~openstack.compute.v2.hypervisor.Hypervisor object or None |
hypervisors
()¶Return a generator of hypervisor
Returns: | A generator of hypervisor |
---|---|
Return type: | class: ~openstack.compute.v2.hypervisor.Hypervisor |
openstack.compute.v2._proxy.
Proxy
(session=None, task_manager=None, *args, **kwargs)find_extension
(name_or_id, ignore_missing=True)¶Find a single Extension
Parameters: |
|
---|---|
Returns: | One |
extensions
(details=True, **query)¶Retrieve a generator of all Extension
Parameters: | |
---|---|
Returns: | A generator of Extension instances. |
Return type: |
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.