NAME
Ceph::RadosGW::Admin - Bindings for the rados gateway admin api.
VERSION
version 0.2
SYNOPSIS
my $admin = Ceph::RadosGW::Admin->new(
access_key => 'not really secret',
secret_key => 'actually secret',
url => 'https://your.rados.gateway.com/',
);
my $user = $admin->create_user(
uid => 'myusername',
display_name => 'my user name',
);
# they're really evil, suspending them should be enough
$user->suspended(1);
$user->save;
# nah, they're really evil
$user->delete;
my $otheruser = $admin->get_user(uid => 'other');
my @keys = $otheruser->keys();
my @keys_plus_one = $otheruser->create_key();
$otheruser->delete_key(access_key => $keys[0]->{access_key});
my @buckets = $otheruser->get_bucket_info();
DESCRIPTION
This module provides an interface to the Admin OPs
interface of a
ceph rados gateway. It is at this time incomplete, with only the parts
needed by the authors implemented. Patches for the rest of the
functionality are encouraged.
METHODS
get_user
Returns a Ceph::RadosGW::Admin::User object representing the given uid.
Dies if the user does not exist.
Example:
my $user = $admin->get_user(uid => 'someuserhere');
create_user
Makes a new user on the rados gateway, and returns a
Ceph::RadosGW::Admin::User object representing that user.
Dies on failure.
Example:
my $new_user = $admin->create_user(
uid => 'username',
display_name => 'Our New User',
);
TODO
* The docs are pretty middling at the moment.
* This module has only been tested against the Dumpling release of
ceph.
AUTHORS
Chris Reinhardt
crein@cpan.org
Mark Ng
cpan@markng.co.uk
COPYRIGHT
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included
with this module.
SEE ALSO
perl(1), Admin OPs API
Ceph