--- updatedAt: 2026-08-18T13:22:17.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/linode-api/llms.txt --- # List Valkey Managed Database advanced parameters __Limited availability__ Lists all advanced parameters you can apply to a Valkey Managed Database, via our partner [Aiven](https://aiven.io/docs/products/valkey/reference/advanced-params). > 📘 > > Aiven may offer other parameters, but Akamai Managed Databases only supports the ones listed in this operation. **Permissions and scopes** To call this operation, you need the following: - **Identity and access permissions**. Your user needs these roles assigned. [Learn more](https://techdocs.akamai.com/cloud-computing/docs/identity-access-cm-available-roles). - Roles: `database_viewer` - **OAuth scopes**. Your user needs these scopes assigned. [Learn more](https://techdocs.akamai.com/linode-api/reference/get-started#oauth). - Scopes: `databases:read_only` # OpenAPI definition ```json { "components": { "securitySchemes": { "oauth": { "flows": { "authorizationCode": { "authorizationUrl": "https://login.linode.com/oauth/authorize", "scopes": { "account:read_only": "Allows access to GET information about your account.", "account:read_write": "Allows access to all endpoints related to your account.", "child_account:read_only": "Allows access to GET information about deprecated parent/child operations.", "child_account:read_write": "Allows access to deprecated parent/child operations.", "databases:read_only": "Allows access to GET information about databases.", "databases:read_write": "Allows access to all endpoints related to databases.", "domains:read_only": "Allows access to GET Domains on your account.", "domains:read_write": "Allows access to all Domain endpoints.", "events:read_only": "Allows access to GET your Events.", "events:read_write": "Allows access to all endpoints related to your Events.", "firewall:read_only": "Allows access to GET information about your Firewalls.", "firewall:read_write": "Allows access to all Firewall endpoints.", "images:read_only": "Allows access to GET your Images.", "images:read_write": "Allows access to all endpoints related to your Images.", "ips:read_only": "Allows access to GET your ips.", "ips:read_write": "Allows access to all endpoints related to your ips.", "linodes:read_only": "Allows access to GET Linodes on your account.", "linodes:read_write": "Allow access to all endpoints related to your Linodes.", "lke:read_only": "Allows access to GET LKE Clusters on your account.", "lke:read_write": "Allows access to all endpoints related to LKE Clusters on your account.", "longview:read_only": "Allows access to GET your Longview Clients.", "longview:read_write": "Allows access to all endpoints related to your Longview Clients.", "monitor:read_only": "Allows access to Monitor (Akamai Cloud Pulse) data.", "monitor:read_write": "Allows access to GET Monitor (Akamai Cloud Pulse) data.", "nodebalancers:read_only": "Allows access to GET NodeBalancers on your account.", "nodebalancers:read_write": "Allows access to all NodeBalancer endpoints.", "object_storage:read_only": "Allows access to GET information related to your Object Storage.", "object_storage:read_write": "Allows access to all Object Storage endpoints.", "stackscripts:read_only": "Allows access to GET your StackScripts.", "stackscripts:read_write": "Allows access to all endpoints related to your StackScripts.", "volumes:read_only": "Allows access to GET your Volumes.", "volumes:read_write": "Allows access to all endpoints related to your Volumes.", "vpc:read_write": "Allows access to all endpoints related to VPC and Subnet creation, updating, and deletion." }, "tokenUrl": "https://login.linode.com/oauth/token" } }, "type": "oauth2" }, "personalAccessToken": { "scheme": "bearer", "type": "http" } } }, "externalDocs": { "description": "See documentation for Akamai's Linode API", "url": "https://techdocs.akamai.com/linode-api/reference" }, "info": { "description": "\"[Read the API documentation](https://techdocs.akamai.com/linode-api/reference/api).\"", "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Databases", "version": "4.229.1" }, "openapi": "3.0.1", "paths": { "/{apiVersion}/databases/valkey/config": { "get": { "description": "__Limited availability__ Lists all advanced parameters you can apply to a Valkey Managed Database, via our partner [Aiven](https://aiven.io/docs/products/valkey/reference/advanced-params).\n\n> 📘\n>\n> Aiven may offer other parameters, but Akamai Managed Databases only supports the ones listed in this operation.\n\n\n**Permissions and scopes**\n\nTo call this operation, you need the following:\n\n- **Identity and access permissions**. Your user needs these roles assigned. [Learn more](https://techdocs.akamai.com/cloud-computing/docs/identity-access-cm-available-roles).\n - Roles: `database_viewer`\n- **OAuth scopes**. Your user needs these scopes assigned. [Learn more](https://techdocs.akamai.com/linode-api/reference/get-started#oauth).\n\n - Scopes: `databases:read_only`", "externalDocs": { "description": "See documentation for this operation in Akamai's Linode API", "url": "https://techdocs.akamai.com/linode-api/reference/get-databases-valkey-config" }, "operationId": "get-databases-valkey-config", "responses": { "200": { "content": { "application/json": { "example": { "backup_hour": { "description": "The hour of day (in UTC) when backup for the service is started. New backup is only started if previous backup has already completed.", "example": 3, "maximum": 23, "minimum": 0, "requires_restart": false, "type": [ "integer", "null" ] }, "backup_minute": { "description": "The minute of an hour when backup for the service is started. New backup is only started if previous backup has already completed.", "example": 30, "maximum": 59, "minimum": 0, "requires_restart": false, "type": [ "integer", "null" ] }, "frequent_snapshots": { "default": true, "description": "When enabled, Valkey will create frequent local RDB snapshots. When disabled, Valkey will only take RDB snapshots when a backup is created, based on the backup schedule. This setting is ignored when `valkey_persistence` is set to `off`.", "requires_restart": false, "type": "boolean" }, "valkey_acl_channels_default": { "description": "Determines default pub/sub channels' ACL for new users if ACL is not supplied. When this option is not defined, all_channels is assumed to keep backward compatibility. This option doesn't affect Valkey configuration acl-pubsub-default.", "enum": [ "allchannels", "resetchannels" ], "requires_restart": false, "type": "string" }, "valkey_active_expire_effort": { "default": 1, "description": "Valkey reclaims expired keys both when accessed and in the background. The background process scans for expired keys to free memory. Increasing the active-expire-effort setting (default 1, max 10) uses more CPU to reclaim expired keys faster, reducing memory usage but potentially increasing latency.", "maximum": 10, "minimum": 1, "requires_restart": false, "type": "integer" }, "valkey_activedefrag": { "default": false, "description": "Enable active memory defragmentation. When enabled, Valkey relocates objects off sparsely-used memory pages to reduce fragmentation and return memory to the operating system. Defragmentation runs on the main thread and consumes CPU, so it may increase latency under load.", "requires_restart": false, "type": "boolean" }, "valkey_lfu_decay_time": { "default": 1, "description": "LFU maxmemory-policy counter decay time in minutes", "maximum": 120, "minimum": 1, "requires_restart": false, "type": "integer" }, "valkey_lfu_log_factor": { "default": 10, "description": "Counter logarithm factor for volatile-lfu and allkeys-lfu maxmemory-policies", "maximum": 100, "minimum": 0, "requires_restart": false, "type": "integer" }, "valkey_maxmemory_policy": { "default": "noeviction", "description": "Valkey maxmemory-policy", "enum": [ "noeviction", "allkeys-lru", "volatile-lru", "allkeys-random", "volatile-random", "volatile-ttl", "volatile-lfu", "allkeys-lfu" ], "requires_restart": false, "type": [ "string", "null" ] }, "valkey_number_of_databases": { "description": "Set number of Valkey databases. Changing this will cause a restart of the Valkey service.", "example": 16, "maximum": 128, "minimum": 1, "requires_restart": true, "type": "integer" }, "valkey_persistence": { "description": "When persistence is 'rdb', Valkey does RDB dumps each 10 minutes if any key is changed. Also RDB dumps are done according to backup schedule for backup purposes. When persistence is 'off', no RDB dumps and backups are done, so data can be lost at any moment if service is restarted for any reason, or if service is powered off. Also service can't be forked.", "enum": [ "off", "rdb" ], "requires_restart": true, "type": "string" }, "valkey_pubsub_client_output_buffer_limit": { "description": "Set output buffer limit for pub / sub clients in MB. The value is the hard limit, the soft limit is 1/4 of the hard limit. When setting the limit, be mindful of the available memory in the selected service plan.", "example": 64, "maximum": 512, "minimum": 32, "requires_restart": false, "type": "integer" }, "valkey_timeout": { "default": 300, "description": "Valkey idle connection timeout in seconds", "maximum": 2073600, "minimum": 0, "requires_restart": false, "type": "integer" } }, "schema": { "additionalProperties": false, "description": "Available [advanced parameters](https://aiven.io/docs/products/valkey/reference/advanced-params) for a Valkey Managed Database.", "properties": { "backup_hour": { "additionalProperties": false, "description": "Details of the `backup_hour` parameter, per Aiven's specifications.", "properties": { "description": { "description": "The description for this parameter.", "type": "string" }, "example": { "description": "An example value for this parameter.", "type": "integer" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "Possible types of the `backup_hour` parameter.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "backup_minute": { "additionalProperties": false, "description": "Details of the `backup_minute` parameter, per Aiven's specifications.", "properties": { "description": { "description": "The description for this parameter.", "type": "string" }, "example": { "description": "An example value for this parameter.", "type": "integer" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "Possible types of the `backup_hour` parameter.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "frequent_snapshots": { "additionalProperties": false, "description": "Details of the `frequent_snapshots` parameter, per Aiven's specifications.", "properties": { "default": { "description": "Specifies the default value of the `frequent_snapshots` parameters.", "type": "boolean" }, "description": { "description": "The description for this parameter.", "type": "string" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_acl_channel_default": { "additionalProperties": false, "description": "Details of the `valkey_acl_channel_default` parameter, per Aiven's specifications.", "properties": { "description": { "description": "The description for this parameter.", "type": "string" }, "enum": { "description": "Possible values of the `valkey_acl_channel_default` parameter, per Aiven's specifications.", "items": { "type": "string" }, "type": "array" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_acl_channels_default": { "additionalProperties": false, "description": "Details of the `valkey_acl_channels_default` parameter, per Aiven's specifications.", "properties": { "description": { "description": "The description for this parameter.", "type": "string" }, "enum": { "description": "Possible values of the `valkey_acl_channels_default` parameter.", "items": { "enum": [ "allchannels", "resetchannels" ], "type": "string" }, "type": "array" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_active_expire_effort": { "additionalProperties": false, "description": "Details of the `valkey_active_expire_effort` parameter, per Aiven's specifications.", "properties": { "default": { "description": "Specifies the default value of the `valkey_active_expire_effort` parameter.", "type": "integer" }, "description": { "description": "The description for this parameter.", "type": "string" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_activedefrag": { "additionalProperties": false, "description": "Details of the `valkey_activedefrag` parameter, per Aiven's specifications.", "properties": { "default": { "description": "Specifies the default value of the `frequent_snapshots` parameters.", "type": "boolean" }, "description": { "description": "The description for this parameter.", "type": "string" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_lfu_decay_time": { "additionalProperties": false, "description": "Details of the `valkey_lfu_decay_time` parameter, per Aiven's specifications.", "properties": { "default": { "description": "Specifies the default value of the `valkey_lfu_decay_time` parameter.", "type": "integer" }, "description": { "description": "The description for this parameter.", "type": "string" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_lfu_log_factor": { "additionalProperties": false, "description": "Details of the `valkey_lfu_log_factor` parameter, per Aiven's specifications.", "properties": { "default": { "description": "Specifies the default value of the `valkey_lfu_log_factor` parameter.", "type": "integer" }, "description": { "description": "The description for this parameter.", "type": "string" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_maxmemory_policy": { "additionalProperties": false, "description": "Details of the `valkey_maxmemory_policy` parameter, per Aiven's specifications.", "properties": { "default": { "description": "Specifies the default value of the `valkey_maxmemory_policy` parameter.", "type": "string" }, "description": { "description": "The description for this parameter.", "type": "string" }, "enum": { "description": "Possible values of the `valkey_maxmemory_policy` parameter. To learn more about them, see [Valkey Key eviction](https://valkey.io/topics/lru-cache/) documentation.", "items": { "enum": [ "noeviction", "allkeys-lru", "allkeys-lfu", "volatile-lru", "volatile-lfu", "volatile-ttl", "allkeys-random", "volatile-random" ], "type": "string" }, "type": "array" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "Possible types of the `valkey_maxmemory_policy` parameter.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "valkey_number_of_databases": { "additionalProperties": false, "description": "Details of the `valkey_number_of_databases` parameter, per Aiven's specifications.", "properties": { "description": { "description": "The description for this parameter.", "type": "string" }, "example": { "description": "An example value for this parameter.", "type": "integer" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_persistence": { "additionalProperties": false, "description": "Details of the `valkey_persistence` parameter, per Aiven's specifications.\n> 🚧\n>\n> If you disable this parameter, you won't be able to fork and restore a database cluster from its backup snapshot.", "properties": { "description": { "description": "The description for this parameter.", "type": "string" }, "enum": { "description": "Possible values of the `valkey_persistence` parameter.", "items": { "enum": [ "rdb", "off" ], "type": "string" }, "type": "array" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_pubsub_client_output_buffer_limit": { "additionalProperties": false, "description": "Details of the `valkey_pubsub_client_output_buffer_limit` parameter, per Aiven's specifications.", "properties": { "description": { "description": "The description for this parameter.", "type": "string" }, "example": { "description": "An example value for this parameter.", "type": "integer" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" }, "valkey_timeout": { "additionalProperties": false, "description": "Details of the `valkey_timeout` parameter, per Aiven's specifications.", "properties": { "default": { "description": "Specifies the default value of the `valkey_timeout` parameter.", "type": "integer" }, "description": { "description": "The description for this parameter.", "type": "string" }, "maximum": { "description": "The maximum value allowed for this parameter.", "type": "integer" }, "minimum": { "description": "The minimum value allowed for this parameter.", "type": "integer" }, "requires_restart": { "description": "Specifies if a change to this parameter requires a restart of the Valkey database.", "type": "boolean" }, "type": { "description": "The format of this object.", "type": "string" } }, "type": "object" } }, "type": "object", "x-akamai": { "file-path": "schemas/database-valkey-config-200.yaml" } } } }, "description": "Valkey Managed Database advanced parameters." }, "default": { "content": { "application/json": { "example": { "errors": [ { "reason": "Invalid JSON" } ] }, "schema": { "additionalProperties": false, "properties": { "errors": { "description": "Any warnings associated with a response.", "items": { "additionalProperties": false, "description": "An object for describing a single error that occurred during the processing of a request.", "properties": { "field": { "description": "The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as `null` if the error is not specific to any single element of the request.", "example": "fieldname", "type": "string" }, "reason": { "description": "What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to [Open a support ticket](https://techdocs.akamai.com/linode-api/reference/post-ticket) or perform some other action before you can complete the request successfully.", "example": "fieldname must be a valid value", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/error-object.yaml" } }, "type": "array" } }, "type": "object" } } }, "description": "See [Errors](https://techdocs.akamai.com/linode-api/reference/errors) for the range of possible error response codes." } }, "security": [ { "personalAccessToken": [] }, { "oauth": [ "databases:read_only" ] } ], "summary": "List Valkey Managed Database advanced parameters", "tags": [ "Valkey" ], "x-akamai": { "status": "LA" }, "x-linode-cli-action": "valkey-config-view", "x-linode-grant": "read_only", "x-linode-iam": [ { "roles": [ "database_viewer" ] } ] }, "parameters": [ { "description": "__Enum__ Call either the `v4` URL, or `v4beta` for operations still in Beta.", "in": "path", "name": "apiVersion", "required": true, "schema": { "enum": [ "v4", "v4beta" ], "example": "v4", "type": "string" }, "x-akamai": { "file-path": "parameters/api-version-path.yaml" } } ], "x-akamai": { "file-path": "paths/valkey-config.yaml", "path-info": "/{apiVersion}/databases/valkey/config" }, "x-linode-cli-command": "databases" } }, "servers": [ { "url": "https://api.linode.com" } ], "tags": [ { "description": "Managed Databases is Akamai's fully-managed, high-performance database service. Use these operations to create and manage clusters for Valkey engine databases.", "name": "Valkey" } ], "x-akamai": { "auth-type": "OAUTH", "file-path": "databases.yaml" }, "x-readme": { "apply-tag-changes": true, "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [Create or restore a Valkey Managed Database](https://techdocs.akamai.com/linode-api/reference/post-databases-valkey-instances.md) * [List Valkey Managed Databases](https://techdocs.akamai.com/linode-api/reference/get-databases-valkey-instances.md) * [Get a Valkey Managed Database](https://techdocs.akamai.com/linode-api/reference/get-databases-valkey-instance.md) * [Update a Valkey Managed Database](https://techdocs.akamai.com/linode-api/reference/put-databases-valkey-instance.md) * [Delete a Valkey Managed Database](https://techdocs.akamai.com/linode-api/reference/delete-databases-valkey-instance.md) * [Get Valkey Managed Database credentials](https://techdocs.akamai.com/linode-api/reference/get-databases-valkey-instance-credentials.md) * [Reset Valkey Managed Database credentials](https://techdocs.akamai.com/linode-api/reference/post-databases-valkey-instance-credentials-reset.md) * [Patch a Valkey Managed Database](https://techdocs.akamai.com/linode-api/reference/post-databases-valkey-instance-patch.md) * [Resume a Valkey Managed Database](https://techdocs.akamai.com/linode-api/reference/resume-databases-valkey-instance.md) * [Get a Valkey Managed Database SSL certificate](https://techdocs.akamai.com/linode-api/reference/get-databases-valkey-instance-ssl.md) * [Suspend a Valkey Managed Database](https://techdocs.akamai.com/linode-api/reference/suspend-databases-valkey-instance.md)