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
.
- 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
- 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)¶
This method is deprecated, use update instead.
- 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.