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

Updated on 2025-09-04 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.

URI

PUT https://{Endpoint}/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" : "_" 
}