The trove client is the command-line interface (CLI) for the Database API and its extensions. This chapter documents trove version 1.0.5. For help on a specific trove command, enter: $ trove help COMMAND

usage: trove [--version] [--debug] [--os-username <auth-user-name>] [--os-password <auth-password>] [--os-tenant-name <auth-tenant-name>] [--os-tenant-id <auth-tenant-id>] [--os-auth-url <auth-url>] [--os-region-name <region-name>] [--service-type <service-type>] [--service-name <service-name>] [--bypass-url <bypass-url>] [--database-service-name <database-service-name>] [--endpoint-type <endpoint-type>] [--os-database-api-version <database-api-ver>] [--os-cacert <ca-certificate>] [--retries <retries>] [--json] <subcommand> ... backup-create Creates a backup. backup-delete Deletes a backup. backup-list Lists available backups. backup-list-instance Lists available backups for an instance. backup-show Shows details of a backup. configuration-attach Attaches a configuration group to an instance. configuration-create Creates a configuration group. configuration-default Shows the default configuration of an instance. configuration-delete Deletes a configuration group. configuration-detach Detaches a configuration group from an instance. configuration-instances Lists all instances associated with a configuration group. configuration-list Lists all configuration groups. configuration-parameter-list Lists available parameters for a configuration group. configuration-parameter-show Shows details of a configuration parameter. configuration-patch Patches a configuration group. configuration-show Shows details of a configuration group. configuration-update Updates a configuration group. create Creates a new instance. database-create Creates a database on an instance. database-delete Deletes a database. database-list Lists available databases on an instance. datastore-list Lists available datastores. datastore-show Shows details of a datastore. datastore-version-list Lists available versions for a datastore. datastore-version-show Shows details of a datastore version. delete Deletes an instance. flavor-list Lists available flavors. flavor-show Shows details of a flavor. limit-list Lists the limits for a tenant. list Lists all the instances. resize-flavor Resizes the flavor of an instance. resize-volume Resizes the volume size of an instance. restart Restarts the instance. root-enable Enables root for a instance. root-show Gets root enabled status for a instance. secgroup-add-rule Creates a security group rule. secgroup-delete-rule Deletes a security group rule. secgroup-list Lists all security groups. secgroup-show Shows details about a security group. show Shows details of an instance. user-create Creates a user. user-delete Deletes a user from the instance. user-grant-access Grants access to a database(s) for a user. user-list Lists the users for a instance. user-revoke-access Revokes access to a database for a user. user-show Gets a user from the instance. user-show-access Gets a users access from the instance. user-update-attributes Updates a users attributes from the instance. bash-completion Prints arguments for bash_completion. help Displays help about this program or one of its subcommands.

--version show program's version number and exit --debug Print debugging output. --os-username <auth-user-name> Defaults to env[OS_USERNAME]. --os-password <auth-password> Defaults to env[OS_PASSWORD]. --os-tenant-name <auth-tenant-name> Defaults to env[OS_TENANT_NAME]. --os-tenant-id <auth-tenant-id> Defaults to env[OS_TENANT_ID]. --os-auth-url <auth-url> Defaults to env[OS_AUTH_URL]. --os-region-name <region-name> Defaults to env[OS_REGION_NAME]. --service-type <service-type> Defaults to database for most actions. --service-name <service-name> Defaults to env[TROVE_SERVICE_NAME]. --bypass-url <bypass-url> Defaults to env[TROVE_BYPASS_URL]. --database-service-name <database-service-name> Defaults to env[TROVE_DATABASE_SERVICE_NAME]. --endpoint-type <endpoint-type> Defaults to env[TROVE_ENDPOINT_TYPE] or publicURL. --os-database-api-version <database-api-ver> Accepts 1, defaults to env[OS_DATABASE_API_VERSION]. --os-cacert <ca-certificate> Specify a CA bundle file to use in verifying a TLS (https) server certificate. Defaults to env[OS_CACERT]. --retries <retries> Number of retries. --json, --os-json-output Output json instead of prettyprint. Defaults to env[OS_JSON_OUTPUT].

usage: trove backup-create <name> <instance> [--description <description>] [--parent <parent>] Creates a backup. <name> Name of the backup. <instance> UUID of the instance. --description <description> An optional description for the backup. --parent <parent> Optional UUID of the parent backup to perform an incremental backup from.

usage: trove backup-delete <backup> Deletes a backup. <backup> ID of the backup.

usage: trove backup-list [--limit <limit>] Lists available backups. --limit <limit> Return up to N number of the most recent backups.

usage: trove backup-list-instance [--limit <limit>] <instance> Lists available backups for an instance. <instance> ID of the instance. --limit <limit> Return up to N number of the most recent backups.

usage: trove backup-show <backup> Shows details of a backup. <backup> ID of the backup.

usage: trove configuration-attach <configuration> <instance> Attaches a configuration group to an instance. <configuration> UUID of the configuration group to attach to the instance. <instance> UUID of the instance.

usage: trove configuration-create <name> <values> [--datastore <datastore>] [--datastore_version <datastore_version>] [--description <description>] Creates a configuration group. <name> Name of the configuration group. <values> Dictionary of the values to set. --datastore <datastore> Datastore assigned to the configuration group. --datastore_version <datastore_version> Datastore version UUID assigned to the configuration group. --description <description> An optional description for the configuration group.

usage: trove configuration-default <instance> Shows the default configuration of an instance. <instance> UUID of the instance.

usage: trove configuration-delete <configuration_group> Deletes a configuration group. <configuration_group> ID of the configuration group.

usage: trove configuration-detach <instance> Detaches a configuration group from an instance. <instance> UUID of the instance.

usage: trove configuration-instances <configuration_group> Lists all instances associated with a configuration group. <configuration_group> ID of the configuration group.

usage: trove configuration-list Lists all configuration groups.

usage: trove configuration-parameter-list <datastore_version> [--datastore <datastore>] Lists available parameters for a configuration group. <datastore_version> Datastore version name or UUID assigned to the configuration group. --datastore <datastore> UUID or name of the datastore to list configuration parameters for. Optional if UUID of the datastore_version is provided.

usage: trove configuration-parameter-show <datastore_version> <parameter> [--datastore <datastore>] Shows details of a configuration parameter. <datastore_version> Datastore version name or UUID assigned to the configuration group. <parameter> Name of the configuration parameter. --datastore <datastore> UUID or name of the datastore to list configuration parameters for. Optional if UUID of the datastore_version is provided.

usage: trove configuration-patch <configuration_group> <values> Patches a configuration group. <configuration_group> ID of the configuration group. <values> Dictionary of the values to set.

usage: trove configuration-show <configuration_group> Shows details of a configuration group. <configuration_group> ID of the configuration group.

usage: trove configuration-update <configuration_group> <values> [--name <name>] [--description <description>] Updates a configuration group. <configuration_group> ID of the configuration group. <values> Dictionary of the values to set. --name <name> Name of the configuration group. --description <description> An optional description for the configuration group.

usage: trove create <name> <flavor_id> [--size <size>] [--databases <databases> [<databases> ...]] [--users <users> [<users> ...]] [--backup <backup>] [--availability_zone <availability_zone>] [--datastore <datastore>] [--datastore_version <datastore_version>] [--nic <net-id=net-uuid,v4-fixed-ip=ip-addr,port-id=port-uuid>] [--configuration <configuration>] Creates a new instance. <name> Name of the instance. <flavor_id> Flavor of the instance. --size <size> Size of the instance disk in GB. --databases <databases> [<databases> ...] Optional list of databases. --users <users> [<users> ...] Optional list of users in the form user:password. --backup <backup> A backup UUID. --availability_zone <availability_zone> The Zone hint to give to nova. --datastore <datastore> A datastore name or UUID. --datastore_version <datastore_version> A datastore version name or UUID. --nic <net-id=net-uuid,v4-fixed-ip=ip-addr,port-id=port-uuid> Create a NIC on the instance. Specify option multiple times to create multiple NICs. net-id: attach NIC to network with this UUID (required, if no port-id specified), v4-fixed-ip: IPv4 fixed address for NIC (optional), port-id: attach NIC to port with this UUID (required, if no net-id specified). --configuration <configuration> UUID of the configuration group to attach to the instance.

usage: trove database-create <instance> <name> [--character_set <character_set>] [--collate <collate>] Creates a database on an instance. <instance> UUID of the instance. <name> Name of the database. --character_set <character_set> Optional character set for database. --collate <collate> Optional collation type for database.

usage: trove database-delete <instance> <database> Deletes a database. <instance> UUID of the instance. <database> Name of the database.

usage: trove database-list <instance> Lists available databases on an instance. <instance> UUID of the instance.

usage: trove datastore-list Lists available datastores.

usage: trove datastore-show <datastore> Shows details of a datastore. <datastore> ID of the datastore.

usage: trove datastore-version-list <datastore> Lists available versions for a datastore. <datastore> ID of the datastore.

usage: trove datastore-version-show <datastore_version> [--datastore <datastore>] Shows details of a datastore version. <datastore_version> ID of the datastore version. --datastore <datastore> ID or name of the datastore. Optional if UUID of the datastore_version is provided.

usage: trove delete <instance> Deletes an instance. <instance> ID of the instance.

usage: trove flavor-list Lists available flavors.

usage: trove flavor-show <flavor> Shows details of a flavor. <flavor> ID of the flavor.

usage: trove limit-list Lists the limits for a tenant.

usage: trove list Lists all the instances.

usage: trove resize-flavor <instance> <flavor_id> Resizes the flavor of an instance. <instance> UUID of the instance. <flavor_id> Flavor of the instance.

usage: trove resize-volume <instance> <size> Resizes the volume size of an instance. <instance> UUID of the instance. <size> Size of the instance disk in GB.

usage: trove restart <instance> Restarts the instance. <instance> UUID of the instance.

usage: trove root-enable <instance> Enables root for a instance. <instance> UUID of the instance.

usage: trove root-show <instance> Gets root enabled status for a instance. <instance> UUID of the instance.

usage: trove secgroup-add-rule <security_group> <cidr> Creates a security group rule. <security_group> Security group name. <cidr> CIDR address.

usage: trove secgroup-delete-rule <security_group_rule> Deletes a security group rule. <security_group_rule> Name of security group rule.

usage: trove secgroup-list Lists all security groups.

usage: trove secgroup-show <security_group> Shows details about a security group. <security_group> ID of the security group.

usage: trove show <instance> Shows details of an instance. <instance> ID of the instance.

usage: trove user-create <instance> <name> <password> [--host <host>] [--databases <databases> [<databases> ...]] Creates a user. <instance> UUID of the instance. <name> Name of user. <password> Password of user. --host <host> Optional host of user. --databases <databases> [<databases> ...] Optional list of databases.

usage: trove user-delete [--host <host>] <instance> <name> Deletes a user from the instance. <instance> UUID of the instance. <name> Name of user. --host <host> Optional host of user.

usage: trove user-grant-access <instance> <name> <databases> [<databases> ...] [--host <host>] Grants access to a database(s) for a user. <instance> UUID of the instance. <name> Name of user. <databases> List of databases. --host <host> Optional host of user.

usage: trove user-list <instance> Lists the users for a instance. <instance> UUID of the instance.

usage: trove user-revoke-access [--host <host>] <instance> <name> <database> Revokes access to a database for a user. <instance> UUID of the instance. <name> Name of user. <database> A single database. --host <host> Optional host of user.

usage: trove user-show [--host <host>] <instance> <name> Gets a user from the instance. <instance> UUID of the instance. <name> Name of user. --host <host> Optional host of user.

usage: trove user-show-access [--host <host>] <instance> <name> Gets a users access from the instance. <instance> UUID of the instance. <name> Name of user. --host <host> Optional host of user.

usage: trove user-update-attributes <instance> <name> [--host <host>] [--new_name <new_name>] [--new_password <new_password>] [--new_host <new_host>] Updates a users attributes from the instance. <instance> UUID of the instance. <name> Name of user. --host <host> Optional host of user. --new_name <new_name> Optional new name of user. --new_password <new_password> Optional new password of user. --new_host <new_host> Optional new host of user.