Net::OpenStack::Compute - Bindings for the OpenStack Compute API.
version 1.1200
use Net::OpenStack::Compute;
my $compute = Net::OpenStack::Compute->new(
auth_url => 'https://identity.api.rackspacecloud.com/v2.0',
user => 'alejandro',
password => 'password',
region => 'ORD',
);
$compute->create_server({
name => 'server1',
flavorRef => $flav_id,
imageRef => $img_id,
});
This class is an interface to the OpenStack Compute API. Also see the oscompute command line tool.
Methods that take a hashref data param generally expect the corresponding data format as defined by the OpenStack API JSON request objects. See the OpenStack Docs for more information. Methods that return a single resource will return false if the resource is not found. Methods that return an arrayref of resources will return an empty arrayref if the list is empty. Methods that create, modify, or delete resources will throw an exception on failure.
Creates a client.
params:
-
auth_url
Required. The url of the authentication endpoint. For example:
'https://identity.api.rackspacecloud.com/v2.0' -
user
Required.
-
password
Required.
-
region
Optional.
-
project_id
Optional.
-
service_name
Optional.
-
verify_ssl
Optional. Defaults to 1.
-
is_rax_auth
Optional. Defaults to 0.
get_server($id)
Returns the server with the given id or false if it doesn't exist.
get_servers(%params)
params:
-
detail
Optional. Defaults to 0.
-
query
Optional query string to be appended to requests.
Returns an arrayref of all the servers.
get_servers_by_name($name)
Returns an arrayref of servers with the given name. Returns an empty arrayref if there are no such servers.
create_server({ name => $name, flavorRef => $flavor, imageRef => $img_id })
Returns a server hashref.
delete_server($id)
Returns true on success.
rebuild_server($server_id, { imageRef => $img_id })
Returns a server hashref.
set_password($server_id, $new_password)
Returns true on success.
get_vnc_console($server_id[, $type=novnc])
Returns a url to the server's VNC console
get_networks($id)
Returns a network list . =head2 get_image
get_image($id)
Returns an image hashref.
get_images(%params)
params:
-
detail
Optional. Defaults to 0.
-
query
Optional query string to be appended to requests.
Returns an arrayref of all the images.
create_image($server_id, { name => 'bob' })
Returns an image hashref.
delete_image($id)
Returns true on success.
get_flavor($id)
Returns a flavor hashref.
get_flavors(%params)
params:
-
detail
Optional. Defaults to 0.
-
query
Optional query string to be appended to requests.
Returns an arrayref of all the flavors.
token()
Returns the OpenStack Compute API auth token.
base_url()
Returns the base url for the OpenStack Compute API, which is returned by the server after authenticating.
Naveed Massjouni [email protected]
This software is copyright (c) 2011 by Naveed Massjouni.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.