Configuration parameters#

This section describes the following API operations that are supported for configuration parameters.

List configuration parameters#

GET /{version}/{accountId}/datastores/{datastoreId}/versions/{versionId}/parameters

Lists configuration parameters that may be configured on the system.

This table shows the possible response codes for this operation:

Response Code

Name

Description

200

Success

Request succeeded.

400

Bad Request

The request is missing one or more elements, or the values of some elements are invalid.

401

Unauthorized

You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.

403

Forbidden

You are denied access to the requested resource.

404

Not Found

The requested item was not found.

405

badMethod

The specified method is not allowed for the given resource.

413

Over Limit

The number of items returned is above the allowed limit.

422

unprocessableEntity

The item cannot be processed.

500

instanceFault

The instance has experienced a fault.

501

notImplemented

The server does not support the functionality required to fulfill the request.

503

Service Unavailable

The service is not available.

Request#

This table shows the URI parameters for the request:

Name

Type

Description

{accountId}

String

The account ID of the owner of the specified instance.

{datastoreId}

String

The ID for the specified datastore.

{versionId}

String

The version for the specified datastore.

This operation does not accept a request body.

Example List configuration parameters: JSON request

The following example shows the List configuration parameters request:

GET /v1.0/1234/datastores/a00000a0-00a0-0a00-00a0-000a000000aa/versions/b00000b0-00b0-0b00-00b0-000b000000bb/parameters HTTP/1.1
User-Agent: python-troveclient
Host: ord.databases.api.rackspacecloud.com
X-Auth-Token: 87c6033c-9ff6-405f-943e-2deb73f278b7
Accept: application/json
Content-Type: application/json

Response#

Example List configuration parameters: JSON response

The following example shows the List configuration parameters response:

HTTP/1.1 200 OK
Content-Type: application/json
Via: 1.1 Repose (Repose/2.6.7)
Content-Length: 3400
Date: Thu, 13 Feb 2014 21:47:15 GMT
Server: Jetty(8.0.y.z-SNAPSHOT)

{
    "configuration-parameters": [
        {
            "max": 1,
            "min": 0,
            "name": "innodb_file_per_table",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 0,
            "name": "key_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 2,
            "name": "connect_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 0,
            "name": "join_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 32768,
            "name": "sort_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 68719476736,
            "min": 0,
            "name": "innodb_buffer_pool_size",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 2,
            "min": 0,
            "name": "innodb_flush_log_at_trx_commit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 1048576,
            "name": "innodb_log_buffer_size",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 10,
            "name": "innodb_open_files",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 1000,
            "min": 0,
            "name": "innodb_thread_concurrency",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 0,
            "name": "sync_binlog",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "auto_increment_increment",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "auto_increment_offset",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 0,
            "name": "bulk_insert_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "expire_logs_days",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "interactive_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1073741824,
            "min": 1024,
            "name": "max_allowed_packet",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "max_connect_errors",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "max_connections",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 4,
            "name": "myisam_sort_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 100000,
            "min": 1,
            "name": "max_user_connections",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 100000,
            "min": 1,
            "name": "server_id",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 31536000,
            "min": 1,
            "name": "wait_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "character_set_filesystem",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "character_set_server",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "collation_server",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 18446744073709547520,
            "min": 10,
            "name": "ft_max_word_len",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "ft_min_word_len",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 16384,
            "min": 0,
            "name": "thread_cache_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 0,
            "name": "query_cache_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 2,
            "min": 0,
            "name": "query_cache_type",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 524288,
            "min": 256,
            "name": "table_definition_cache",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 0,
            "name": "open-files-limit",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 524288,
            "min": 1,
            "name": "table_open_cache",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "default_time_zone",
            "restart_required": true,
            "type": "string"
        },
        {
            "max": 2,
            "min": 0,
            "name": "completion_type",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 2,
            "min": 0,
            "name": "concurrent_insert",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "default-storage-engine",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 7,
            "min": 0,
            "name": "default_week_format",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "delay_key_write",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "delayed_insert_limit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 31536000,
            "min": 1,
            "name": "delayed_insert_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "delayed_queue_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 30,
            "min": 0,
            "name": "div_precision_increment",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "event_scheduler",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "flush",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 31536000,
            "min": 0,
            "name": "flush_time",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "ft_boolean_syntax",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 1000,
            "min": 0,
            "name": "ft_query_expansion_limit",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "general_log",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 4,
            "name": "group_concat_max_len",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 100,
            "name": "key_cache_age_threshold",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 100,
            "min": 1,
            "name": "key_cache_division_limit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "log_output",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 1,
            "min": 0,
            "name": "log_queries_not_using_indexes",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "log_slow_admin_statements",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "log_slow_queries",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 31536000,
            "min": 0,
            "name": "long_query_time",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "low_priority_updates",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 2,
            "min": 0,
            "name": "lower_case_table_names",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 16384,
            "min": 0,
            "name": "max_delayed_threads",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 0,
            "name": "max_error_count",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1844674407370954752,
            "min": 16384,
            "name": "max_heap_table_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967295,
            "min": 1,
            "name": "max_join_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 8388608,
            "min": 4,
            "name": "max_length_for_sort_data",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1048576,
            "min": 0,
            "name": "max_prepared_stmt_count",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "max_seeks_for_key",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 8388608,
            "min": 4,
            "name": "max_sort_length",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "max_write_lock_count",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 0,
            "name": "min_examined_rows_limit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 9223372036854775807,
            "min": 0,
            "name": "myisam_max_sort_file_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "myisam_stats_method",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 31536000,
            "min": 1,
            "name": "net_read_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "net_retry_count",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 31536000,
            "min": 1,
            "name": "net_write_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "old_alter_table",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "old_style_user_limits",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "old_passwords",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "optimizer_prune_level",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 62,
            "min": 0,
            "name": "optimizer_search_depth",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1073741824,
            "min": 1024,
            "name": "preload_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 0,
            "name": "query_cache_limit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "query_cache_wlock_invalidate",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 8192,
            "name": "query_prealloc_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 4096,
            "name": "range_alloc_block_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 2147479552,
            "min": 8200,
            "name": "read_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 2147483647,
            "min": 8200,
            "name": "read_rnd_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "secure_auth",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 31536000,
            "min": 0,
            "name": "slow_launch_time",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "slow_query_log",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "sql_mode",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 1,
            "min": 0,
            "name": "sync_frm",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 131072,
            "name": "thread_stack",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709551615,
            "min": 1024,
            "name": "tmp_table_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "transaction-isolation",
            "restart_required": true,
            "type": "string"
        },
        {
            "max": 1,
            "min": 0,
            "name": "updatable_views_with_limit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "innodb_adaptive_hash_index",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 2,
            "min": 0,
            "name": "innodb_autoinc_lock_mode",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 1000,
            "min": 0,
            "name": "innodb_commit_concurrency",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967295,
            "min": 1,
            "name": "innodb_concurrency_tickets",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "innodb_file_format",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 1073741824,
            "min": 1,
            "name": "innodb_lock_wait_timeout",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "innodb_locks_unsafe_for_binlog",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 100,
            "min": 0,
            "name": "innodb_max_dirty_pages_pct",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967295,
            "min": 0,
            "name": "innodb_max_purge_lag",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 95,
            "min": 5,
            "name": "innodb_old_blocks_pct",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967295,
            "min": 0,
            "name": "innodb_old_blocks_time",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "innodb_rollback_on_timeout",
            "restart_required": true,
            "type": "integer"
        },
        {
            "name": "innodb_stats_method",
            "restart_required": false,
            "type": "string"
        },
        {
            "max": 1,
            "min": 0,
            "name": "innodb_stats_on_metadata",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709551615,
            "min": 1,
            "name": "innodb_stats_sample_pages",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "innodb_strict_mode",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967295,
            "min": 0,
            "name": "innodb_sync_spin_loops",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709551615,
            "min": 1,
            "name": "innodb_thread_sleep_delay",
            "restart_required": false,
            "type": "integer"
        }
    ]
}

List configuration parameter details#

GET /{version}/{accountId}/datastores/{datastoreId}/versions/{versionId}/parameters/{parameterId}

Lists the details of a specified configuration parameter that may be configured on the system.

This table shows the possible response codes for this operation:

Response Code

Name

Description

200

Success

Request succeeded.

400

Bad Request

The request is missing one or more elements, or the values of some elements are invalid.

401

Unauthorized

You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.

403

Forbidden

You are denied access to the requested resource.

404

Not Found

The requested item was not found.

405

badMethod

The specified method is not allowed for the given resource.

413

Over Limit

The number of items returned is above the allowed limit.

422

unprocessableEntity

The item cannot be processed.

500

instanceFault

The instance has experienced a fault.

501

notImplemented

The server does not support the functionality required to fulfill the request.

503

Service Unavailable

The service is not available.

Request#

This table shows the URI parameters for the request:

Name

Type

Description

{accountId}

String

The account ID of the owner of the specified instance.

{datastoreId}

String

The ID for the specified datastore.

{versionId}

String

The version for the specified datastore.

{parameterId}

String

The parameter that may be configured for the specified datastore and version.

This operation does not accept a request body.

Example List configuration parameter details: JSON request

The following example shows the List configuration parameter details request:

GET /v1.0/1234/datastores/a00000a0-00a0-0a00-00a0-000a000000aa/versions/b00000b0-00b0-0b00-00b0-000b000000bb/parameters/innodb_file_per_table HTTP/1.1
User-Agent: python-troveclient
Host: ord.databases.api.rackspacecloud.com
X-Auth-Token: 87c6033c-9ff6-405f-943e-2deb73f278b7
Accept: application/json
Content-Type: application/json

Response#

Example List configuration parameter details: JSON response

The following example shows the List configuration parameter details response:

HTTP/1.1 200 OK
Content-Type: application/json
Via: 1.1 Repose (Repose/2.6.7)
Content-Length: 98
Date: Thu, 13 Feb 2014 21:47:15 GMT
Server: Jetty(8.0.y.z-SNAPSHOT)

{
    "max": 1,
    "min": 0,
    "name": "innodb_file_per_table",
    "restart_required": true,
    "type": "integer"
}

List configuration parameters without datastore#

GET /{version}/{accountId}/datastores/versions/{versionId}/parameters

Lists the configuration parameters that may be configured on the system without specifying a datastore.

This table shows the possible response codes for this operation:

Response Code

Name

Description

200

Success

Request succeeded.

400

Bad Request

The request is missing one or more elements, or the values of some elements are invalid.

401

Unauthorized

You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.

403

Forbidden

You are denied access to the requested resource.

404

Not Found

The requested item was not found.

405

badMethod

The specified method is not allowed for the given resource.

413

Over Limit

The number of items returned is above the allowed limit.

422

unprocessableEntity

The item cannot be processed.

500

instanceFault

The instance has experienced a fault.

501

notImplemented

The server does not support the functionality required to fulfill the request.

503

Service Unavailable

The service is not available.

Request#

This table shows the URI parameters for the request:

Name

Type

Description

{accountId}

String

The account ID of the owner of the specified instance.

{versionId}

String

The version for the specified datastore.

This operation does not accept a request body.

Example List configuration parameters without datastore: JSON request

The following example shows the List configuration parameters without datastore request:

GET /v1.0/1234/datastores/versions/b00000b0-00b0-0b00-00b0-000b000000bb/parameters HTTP/1.1
User-Agent: python-troveclient
Host: ord.databases.api.rackspacecloud.com
X-Auth-Token: 87c6033c-9ff6-405f-943e-2deb73f278b7
Accept: application/json
Content-Type: application/json

Response#

Example List configuration parameters without datastore: JSON response

The following example shows the List configuration parameters without datastore response:

HTTP/1.1 200 OK
Content-Type: application/json
Via: 1.1 Repose (Repose/2.6.7)
Content-Length: 3400
Date: Thu, 13 Feb 2014 21:47:15 GMT
Server: Jetty(8.0.y.z-SNAPSHOT)

{
    "configuration-parameters": [
        {
            "max": 1,
            "min": 0,
            "name": "innodb_file_per_table",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "autocommit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1,
            "min": 0,
            "name": "local_infile",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 0,
            "name": "key_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "connect_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 0,
            "name": "join_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 32768,
            "name": "sort_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 68719476736,
            "min": 0,
            "name": "innodb_buffer_pool_size",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 2,
            "min": 0,
            "name": "innodb_flush_log_at_trx_commit",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 1048576,
            "name": "innodb_log_buffer_size",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 4294967296,
            "min": 10,
            "name": "innodb_open_files",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 1000,
            "min": 0,
            "name": "innodb_thread_concurrency",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 0,
            "name": "sync_binlog",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "auto_increment_increment",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "auto_increment_offset",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 0,
            "name": "bulk_insert_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "expire_logs_days",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "interactive_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 1073741824,
            "min": 1024,
            "name": "max_allowed_packet",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 1,
            "name": "max_connect_errors",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 65535,
            "min": 1,
            "name": "max_connections",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 18446744073709547520,
            "min": 4,
            "name": "myisam_sort_buffer_size",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 100000,
            "min": 1,
            "name": "max_user_connections",
            "restart_required": false,
            "type": "integer"
        },
        {
            "max": 100000,
            "min": 1,
            "name": "server_id",
            "restart_required": true,
            "type": "integer"
        },
        {
            "max": 31536000,
            "min": 1,
            "name": "wait_timeout",
            "restart_required": false,
            "type": "integer"
        },
        {
            "name": "character_set_client",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "character_set_connection",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "character_set_database",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "character_set_filesystem",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "character_set_results",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "character_set_server",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "collation_connection",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "collation_database",
            "restart_required": false,
            "type": "string"
        },
        {
            "name": "collation_server",
            "restart_required": false,
            "type": "string"
        }
    ]
}

List configuration parameter details without datastore#

GET /{version}/{accountId}/datastores/versions/{versionId}/parameters/{parameterId}

Lists the details of a specified configuration parameter that may be configured on the system without specifying a datastore.

This table shows the possible response codes for this operation:

Response Code

Name

Description

200

Success

Request succeeded.

400

Bad Request

The request is missing one or more elements, or the values of some elements are invalid.

401

Unauthorized

You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.

403

Forbidden

You are denied access to the requested resource.

404

Not Found

The requested item was not found.

405

badMethod

The specified method is not allowed for the given resource.

413

Over Limit

The number of items returned is above the allowed limit.

422

unprocessableEntity

The item cannot be processed.

500

instanceFault

The instance has experienced a fault.

501

notImplemented

The server does not support the functionality required to fulfill the request.

503

Service Unavailable

The service is not available.

Request#

This table shows the URI parameters for the request:

Name

Type

Description

{accountId}

String

The account ID of the owner of the specified instance.

{versionId}

String

The version for the specified datastore.

{parameterId}

String

The parameter that may be configured for the specified datastore and version.

This operation does not accept a request body.

Example List configuration parameter details without datastore: JSON request

The following example shows the List configuration parameter details without datastore request:

GET /v1.0/1234/datastores/versions/b00000b0-00b0-0b00-00b0-000b000000bb/parameters/innodb_file_per_table HTTP/1.1
User-Agent: python-troveclient
Host: ord.databases.api.rackspacecloud.com
X-Auth-Token: 87c6033c-9ff6-405f-943e-2deb73f278b7
Accept: application/json
Content-Type: application/json

Response#

Example List configuration parameter details without datastore: JSON response

The following example shows the List configuration parameter details without datastore response:

HTTP/1.1 200 OK
Content-Type: application/json
Via: 1.1 Repose (Repose/2.6.7)
Content-Length: 98
Date: Thu, 13 Feb 2014 21:47:15 GMT
Server: Jetty(8.0.y.z-SNAPSHOT)

{
    "max": 1,
    "min": 0,
    "name": "innodb_file_per_table",
    "restart_required": true,
    "type": "integer"
}

List verbose default configuration parameters#

GET /{version}/{accountId}/datastore/version/{versionId}/configuration/{flavorId}

Lists the default configuration parameters for a datastore version flavor.

This table shows the possible response codes for this operation:

Response Code

Name

Description

200

Success

Request succeeded.

400

Bad Request

The request is missing one or more elements, or the values of some elements are invalid.

401

Unauthorized

You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.

403

Forbidden

You are denied access to the requested resource.

404

Not Found

The requested item was not found.

405

badMethod

The specified method is not allowed for the given resource.

413

Over Limit

The number of items returned is above the allowed limit.

422

unprocessableEntity

The item cannot be processed.

500

instanceFault

The instance has experienced a fault.

501

notImplemented

The server does not support the functionality required to fulfill the request.

503

Service Unavailable

The service is not available.

Request#

This table shows the URI parameters for the request:

Name

Type

Description

{accountId}

String

The account ID of the owner of the specified instance.

{versionId}

String

The version for the specified datastore.

{flavorId}

String

The flavor ID for the specified flavor.

This operation does not accept a request body.

Example List verbose default configuration parameters: JSON request

The following example shows the List verbose default configuration parameters request:

GET /v1.0/1234/datastore/version/c11500fb-a034-4116-9f6b-4e0b32cea39d/configuration/9 HTTP/1.1
User-Agent: python-troveclient
Host: ord.databases.api.rackspacecloud.com
X-Auth-Token: 87c6033c-9ff6-405f-943e-2deb73f278b7
Accept: application/json
Content-Type: application/json

Response#

Example List verbose default configuration parameters: JSON response

The following example shows the List verbose default configuration parameters response:

{
   "datastore":"mysql",
   "datastore_version":"5.6",
   "flavor":9,
   "configuration":{
      "tmp_table_size":{
         "default":"16M",
         "max":18446744073709551615,
         "restart_required":false,
         "type":"integer",
         "min":1024
      },
      "innodb_log_files_in_group":{
         "default":"2"
      },
      "join_buffer_size":{
         "default":"1M",
         "max":4294967296,
         "restart_required":false,
         "type":"integer",
         "min":0
      },
      "skip-external-locking":{
         "default":"1"
      },
      "innodb_checksum_algorithm":{
         "default":"crc32"
      },
      "read_rnd_buffer_size":{
         "default":"1M",
         "max":2147483647,
         "restart_required":false,
         "type":"integer",
         "min":8200
      },
      "skip_name_resolve":{
         "default":"1"
      },
      "max_heap_table_size":{
         "default":"16M",
         "max":1844674407370954752,
         "restart_required":false,
         "type":"integer",
         "min":16384
      },
      "port":{
         "default":"3306"
      },
      "tmpdir":{
         "default":"/var/tmp"
      },
      "pid_file":{
         "default":"/var/run/mysqld/mysqld.pid"
      },
      "myisam-recover":{
         "default":"BACKUP"
      },
      "server_id":{
         "default":"559004"
      },
      "innodb_buffer_pool_size":{
         "default":"175M",
         "max":68719476736,
         "restart_required":true,
         "type":"integer",
         "min":0
      },
      "basedir":{
         "default":"/usr"
      },
      "max_allowed_packet":{
         "default":"16M",
         "max":1073741824,
         "restart_required":false,
         "type":"integer",
         "min":1024
      },
      "datadir":{
         "default":"/var/lib/mysql"
      },
      "innodb_log_buffer_size":{
         "default":"8M",
         "max":4294967296,
         "restart_required":true,
         "type":"integer",
         "min":1048576
      },
      "max_connections":{
         "default":"40",
         "max":65535,
         "restart_required":false,
         "type":"integer",
         "min":1
      },
      "table_open_cache":{
         "default":"4096",
         "max":524288,
         "restart_required":false,
         "type":"integer",
         "min":1
      },
      "connect_timeout":{
         "default":"15",
         "max":65535,
         "restart_required":false,
         "type":"integer",
         "min":2
      },
      "query_cache_type":{
         "default":"1",
         "max":2,
         "restart_required":false,
         "type":"integer",
         "min":0
      },
      "max_connect_errors":{
         "default":"10000",
         "max":18446744073709547520,
         "restart_required":false,
         "type":"integer",
         "min":1
      },
      "local-infile":{
         "default":"0"
      },
      "innodb_log_file_size":{
         "default":"256M"
      },
      "innodb_thread_concurrency":{
         "default":"0",
         "max":1000,
         "restart_required":false,
         "type":"integer",
         "min":0
      },
      "thread_stack":{
         "default":"192K",
         "max":18446744073709547520,
         "restart_required":false,
         "type":"integer",
         "min":131072
      },
      "query_cache_limit":{
         "default":"1M",
         "max":18446744073709547520,
         "restart_required":false,
         "type":"integer",
         "min":0
      },
      "wait_timeout":{
         "default":"3600",
         "max":31536000,
         "restart_required":false,
         "type":"integer",
         "min":1
      },
      "user":{
         "default":"mysql"
      },
      "query_cache_size":{
         "default":"8M",
         "max":18446744073709547520,
         "restart_required":false,
         "type":"integer",
         "min":0
      },
      "innodb_data_file_path":{
         "default":"ibdata1:10M:autoextend"
      },
      "performance_schema":{
         "default":"off"
      },
      "default_storage_engine":{
         "default":"innodb"
      },
      "log-error":{
         "default":"/var/log/mysql/mysqld.log"
      },
      "sort_buffer_size":{
         "default":"256K",
         "max":18446744073709547520,
         "restart_required":false,
         "type":"integer",
         "min":32768
      },
      "innodb_buffer_pool_instances":{
         "default":"1"
      },
      "read_buffer_size":{
         "default":"256K",
         "max":2147479552,
         "restart_required":false,
         "type":"integer",
         "min":8200
      },
      "open_files_limit":{
         "default":"8192"
      },
      "innodb_io_capacity":{
         "default":"200"
      },
      "innodb_file_per_table":{
         "default":"1",
         "max":1,
         "restart_required":true,
         "type":"integer",
         "min":0
      },
      "innodb_open_files":{
         "default":"8192",
         "max":4294967296,
         "restart_required":true,
         "type":"integer",
         "min":10
      },
      "key_buffer_size":{
         "default":"50M",
         "max":4294967296,
         "restart_required":false,
         "type":"integer",
         "min":0
      },
      "innodb_io_capacity_max":{
         "default":"400               # 2 x innodb_io_capacity"
      }
   }
}