troveclient.v1.instances module

class troveclient.v1.instances.DatastoreLog(manager, info, loaded=False)

Bases: troveclient.base.Resource

A DatastoreLog is a log on the database guest instance.

class troveclient.v1.instances.Instance(manager, info, loaded=False)

Bases: troveclient.base.Resource

An Instance is an opaque instance used to store Database instances.

delete()

Delete the instance.

detach_replica()

Stops the replica database from being replicated to.

force_delete()

Force delete the instance

list_databases()
restart()

Restart the database instance.

class troveclient.v1.instances.InstanceStatus

Bases: object

ACTIVE = 'ACTIVE'
BLOCKED = 'BLOCKED'
BUILD = 'BUILD'
EJECTING = 'EJECTING'
FAILED = 'FAILED'
LOGGING = 'LOGGING'
PROMOTING = 'PROMOTING'
REBOOT = 'REBOOT'
RESIZE = 'RESIZE'
RESTART_REQUIRED = 'RESTART_REQUIRED'
SHUTDOWN = 'SHUTDOWN'
class troveclient.v1.instances.Instances(api)

Bases: troveclient.base.ManagerWithFind

Manage Instance resources.

backups(instance, limit=None, marker=None)

Get the list of backups for a specific instance.

Parameters
  • instance – instance for which to list backups

  • limit – max items to return

  • marker – marker start point

Return type

list of Backups.

configuration(instance)

Get a configuration on instances.

Return type

Instance

create(name, flavor_id=None, volume=None, databases=None, users=None, restorePoint=None, availability_zone=None, datastore=None, datastore_version=None, nics=None, configuration=None, replica_of=None, replica_count=None, modules=None, locality=None, region_name=None, access=None, datastore_version_number=None, **kwargs)

Create (boot) a new instance.

delete(instance)

Delete the specified instance.

Parameters

instance – A reference to the instance to delete

eject_replica_source(instance)

Eject a replica source from its set

Parameters

instance – The Instance (or its ID) of the database instance to eject.

force_delete(instance)

Force delete the specified instance.

Parameters

instance – A reference to the instance to force delete

get(instance)

Get a specific instances.

Return type

Instance

list(limit=None, marker=None, include_clustered=False, detailed=False)

Get a list of all instances.

Return type

list of Instance.

log_action(instance, log_name, enable=None, disable=None, publish=None, discard=None)

Perform action on guest log.

Parameters
  • instance – The Instance (or its ID) of the database instance to get the log for.

  • log_name – The name of <log> to publish

  • enable – Turn on <log>

  • disable – Turn off <log>

  • publish – Publish log to associated container

  • discard – Delete the associated container

Return type

List of DatastoreLog.

log_generator(instance, log_name, lines=50, swift=None)

Return generator to yield the last <lines> lines of guest log.

Parameters
  • instance – The Instance (or its ID) of the database instance to get the log for.

  • log_name – The name of <log> to publish

  • lines – Display last <lines> lines of log (0 for all lines)

  • swift – Connection to swift

Return type

generator function to yield log as chunks.

log_list(instance)

Get a list of all guest logs.

Parameters

instance – The Instance (or its ID) of the database instance to get the log for.

Return type

list of DatastoreLog.

log_save(instance, log_name, filename=None)

Saves a guest log to a file.

Parameters
  • instance – The Instance (or its ID) of the database instance to get the log for.

  • log_name – The name of <log> to publish

Return type

Filename to which log was saved

log_show(instance, log_name)
modify(instance, configuration=None)
module_apply(instance, modules)

Apply modules to an instance.

module_query(instance)

Query an instance about installed modules.

module_remove(instance, module)

Remove a module from an instance.

module_retrieve(instance, directory=None, prefix=None)

Retrieve the module data file from an instance. This includes the contents of the module data file.

modules(instance)

Get the list of modules for a specific instance.

promote_to_replica_source(instance)

Promote a replica to be the new replica_source of its set

Parameters

instance – The Instance (or its ID) of the database instance to promote.

reset_status(instance)

Reset the status of an instance.

Parameters

instance – A reference to the instance

resize_instance(instance, flavor_id)

Resizes an instance with a new flavor.

resize_volume(instance, volume_size)

Resize the volume on an existing instances.

resource_class

alias of troveclient.v1.instances.Instance

restart(instance)

Restart the database instance.

Parameters

instance – The Instance (or its ID) of the database instance to restart.

update(instance, configuration=None, name=None, detach_replica_source=False, remove_configuration=False, is_public=None, allowed_cidrs=None)

Update instance.

The configuration change, detach_replica and access change cannot be updated at the same time.

upgrade(instance, datastore_version)

Upgrades an instance with a new datastore version.