Help Center/ GeminiDB/ API Reference/ APIs v3 (Recommended)/ Instances/ Modifying a Memory Acceleration Rule

Updated on 2025-11-17 GMT+08:00

View PDF

Modifying a Memory Acceleration Rule

Function

This API is used to modify a memory acceleration rule.

Constraints

This API can be used only on primary/standby GeminiDB Redis instances.

Authorization

Each account is authorized to call all APIs, but its IAM users must be granted necessary permissions. For details, see Permission Policies and Supported Actions.

URI

PUT /v3/{project_id}/dbcache/rule

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Explanation: Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. Constraints: N/A Values: N/A Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Explanation: User token You can obtain the token by calling the IAM API by following Obtaining a User Token Through Password Authentication. Constraints: N/A Values: N/A Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
dbcache_rule_id	Yes	String	Explanation: ID of a memory acceleration rule Constraints: N/A Values: N/A Default value: N/A
value_columns	Yes	Array of strings	Explanation: Columns used by mapped values Constraints: N/A Values: N/A Default value: N/A
ttl	No	String	Explanation: Lifetime of a key (unit: ms) Constraints: N/A Values: N/A Default value: 2592000000: 30 days
value_separator	No	String	Explanation: Value separator of a mapping Constraints: Only one character is allowed. Values: N/A Default value: N/A

Response Parameters

None

Example Request

Updating a memory acceleration rule

PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/dbcache/rule 
 
{ 
  "dbcache_rule_id" : "0231e002-d278-4df8-815c-8284164168e5", 
  "value_columns" : [ "sno", "sname", "age" ], 
  "ttl" : 3000, 
  "value_separator" : "_" 
}