Updated on 2025-07-02 GMT+08:00

Modifying High-Risk Commands

Function

This API is used to modify high-risk commands supported by a GeminiDB Redis instance in batches.

Constraints

This API supports only proxy-based general-purpose GeminiDB Redis instances.

URI

PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/high-risk-commands

Table 1 Path 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

instance_id

Yes

String

Explanation:

Instance 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

Constraints:

N/A

Values:

N/A

Default value:

N/A

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

commands

Yes

Array of objects

Explanation:

High-risk commands and their corresponding renamed commands. For details, see Table 4.

Constraints:

N/A

Values:

N/A

Default value:

N/A

Table 4 CommandInfo

Parameter

Mandatory

Type

Description

origin_name

Yes

String

Explanation:

Original high-risk commands

Constraints:

N/A

Values:

keys, flushdb, flushall, hgetall, hkeys, hvals, and smembers

Default value:

N/A

name

Yes

String

Explanation:

Name of an enabled command.

Constraints:

If the value is empty, the command is disabled. The value can be a string of no more than 30 characters, including digits, letters, and underscores (_).

Minimum length: 0 character

Maximum length: 30 characters

Values:

N/A

Default value:

N/A

Response Parameters

Status code: 200

No response parameters

Example Requests

  • URI example
    PUT
    https://{Endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/41409e5a49ee467287d738b9b6d0adcbin12/high-risk-commands
  • Modifying high-risk commands
    { 
      "commands" : [ { 
        "origin_name" : "keys", 
        "name" : "newKeys" 
      }, { 
        "origin_name" : "flushdb", 
        "name" : "newFlushdb" 
      }, { 
        "origin_name" : "flushall", 
        "name" : "newFlushall" 
      }, { 
        "origin_name" : "hgetall", 
        "name" : "newHgetall" 
      }, { 
        "origin_name" : "hkeys", 
        "name" : "newHkeys" 
      }, { 
        "origin_name" : "hvals", 
        "name" : "newHvals" 
      }, { 
        "origin_name" : "smembers", 
        "name" : "newSmembers" 
      } ] 
    }

Example Responses

Status code: 200

Success

Status Codes

For details, see Status Codes.

Error Codes

For details, see Error Codes.