DescribeParameters - API And SDK Reference| Alibaba Cloud Documentation Center

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeParameters	The operation that you want to perform. Set the value to DescribeParameters.
RegionId	String	No	cn-hangzhou	The region ID of the instance. You can call the DescribeRegions operation to query the region ID of the instance.
DBInstanceId	String	Yes	r-bp1zxszhcgatnx****	The ID of the instance.
NodeId	String	No	r-bp1xxxxxxxxxxxxx-db-0	The ID of the node. Note You can set this parameter to query the parameter configurations of the specified node in a cluster instance.

Response parameters


Parameter	Type	Example	Description
RequestId	String	9C1338BE-8DE8-4890-A900-E1BC06BF****	The ID of the request.
Engine	String	redis	The database engine of the instance.
EngineVersion	String	4.0	The database engine version of the instance.
ConfigParameters	Array of Parameter		Details about the configuration parameters.
Parameter
CheckingCode	String	[0\|1]	The check code that indicates the valid values of the parameter.
ParameterName	String	script_check_enable	The name of the parameter.
ParameterValue	String	1	The value of the parameter.
ForceRestart	Boolean	true	Indicates whether the instance must be restarted for the modifications to take effect. Valid values: True: The instance must be restarted for the modifications to take effect. False: The instance does not need to be restarted for the modifications to take effect. Modifications immediately take effect.
ParameterDescription	String	Check all keys passed in the KEYS array map to the same slot.	The description of the parameter.
ModifiableStatus	Boolean	true	Indicates whether the parameter can be reconfigured. Valid values: False: The parameter cannot be reconfigured. True: The parameter can be reconfigured.
RunningParameters	Array of Parameter		Details about the operational parameters.
Parameter
CheckingCode	String	[0\|1]	The check code that indicates the valid values of the parameter.
ParameterName	String	#no_loose_disabled-commands	The name of the parameter.
ParameterValue	String	keys,flushall,flushdb	The value of the parameter.
ForceRestart	String	true	Indicates whether the instance must be restarted for the modifications to take effect. Valid values: True: The instance must be restarted for the modifications to take effect. False: The instance does not need to be restarted for the modifications to take effect. Modifications immediately take effect.
ParameterDescription	String	You can disable some dangerous commands, for example \"keys,flushdb,flushall\", the commands must be in [flushall,flushdb,keys,hgetall,eval,evalsha,script].	The description of the parameter.
ModifiableStatus	String	true	Indicates whether the parameter can be reconfigured. Valid values: False: The parameter cannot be reconfigured. True: The parameter can be reconfigured.

Examples

Sample requests

https://r-kvstore.aliyuncs.com/?Action=DescribeParameters
&DBInstanceId=r-bp1zxszhcgatnx****
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeParametersResponse>
    <ConfigParameters></ConfigParameters>
    <RequestId>9C1338BE-8DE8-4890-A900-E1BC06BF****</RequestId>
    <RunningParameters>
        <Parameter>
            <ParameterDescription>check whitelist always</ParameterDescription>
            <ParameterValue>no</ParameterValue>
            <CheckingCode>[yes|no]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>#no_loose_check-whitelist-always</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>You can disable some dangerous commands, for example &quot;keys,flushdb,flushall&quot;, the commands must be in [flushall,flushdb,keys,hgetall,eval,evalsha,script].</ParameterDescription>
            <ParameterValue>keys,flushall,flushdb</ParameterValue>
            <CheckingCode>.*</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>#no_loose_disabled-commands</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>Enable or disable SSL</ParameterDescription>
            <ParameterValue>yes</ParameterValue>
            <CheckingCode>[yes|no]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>#no_loose_ssl-enabled</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>Be compatible with cluster mode.</ParameterDescription>
            <ParameterValue>0</ParameterValue>
            <CheckingCode>[0|1]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>cluster_compat_enable</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>Check all keys passed in the KEYS array map to the same slot.</ParameterDescription>
            <ParameterValue>1</ParameterValue>
            <CheckingCode>[0|1]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>script_check_enable</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>If hash fields are less than this value and hash value sizes are less than hash-max-ziplist-value, the ziplist will be used.</ParameterDescription>
            <ParameterValue>512</ParameterValue>
            <CheckingCode>[0-999999999999999]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>hash-max-ziplist-entries</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>If hash value sizes are than less this value and hash fields are less than hash-max-ziplist-entries, the ziplist will be used.</ParameterDescription>
            <ParameterValue>64</ParameterValue>
            <CheckingCode>[0-999999999999999]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>hash-max-ziplist-value</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>lazyfree switch on eviction.</ParameterDescription>
            <ParameterValue>yes</ParameterValue>
            <CheckingCode>[yes|no]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>lazyfree-lazy-eviction</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>lazyfree switch on expire.</ParameterDescription>
            <ParameterValue>yes</ParameterValue>
            <CheckingCode>[yes|no]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>lazyfree-lazy-expire</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>lazyfree switch on server implicit deletion.</ParameterDescription>
            <ParameterValue>yes</ParameterValue>
            <CheckingCode>[yes|no]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>lazyfree-lazy-server-del</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>The number of entries on the list that are not compressed at both ends.</ParameterDescription>
            <ParameterValue>0</ParameterValue>
            <CheckingCode>[0-65535]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>list-compress-depth</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>Threadhold of ziplist size on quicklist.</ParameterDescription>
            <ParameterValue>-2</ParameterValue>
            <CheckingCode>[-5-99999999]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>list-max-ziplist-size</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>To config how Redis will select what to remove when maxmemory is reached. There are eight behaviors that can be chose : volatile-lru,allkeys-lru,volatile-lfu,allkeys-lfu,volatile-random,allkeys-random,volatile-ttl,noeviction</ParameterDescription>
            <ParameterValue>volatile-lfu</ParameterValue>
            <CheckingCode>[volatile-lru|allkeys-lru|volatile-random|allkeys-random|volatile-ttl|volatile-lfu|allkeys-lfu|noeviction]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>maxmemory-policy</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>
                Sets have a special encoding in just one case: when a set is composed
                of just strings that happen to be integers in radix 10 in the range
                of 64 bit signed integers.
                The following configuration setting sets the limit in the size of the
            set in order to use this special memory saving encoding.</ParameterDescription>
            <ParameterValue>512</ParameterValue>
            <CheckingCode>[0-999999999999999]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>set-max-intset-entries</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>
                The time is expressed in microseconds, so 1000000 is equivalent
                to one second. Note that a negative number disables the slow log,
            while a value of zero forces the logging of every command.</ParameterDescription>
            <ParameterValue>10000</ParameterValue>
            <CheckingCode>[0-10000000]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>slowlog-log-slower-than</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>The max slowlog count.</ParameterDescription>
            <ParameterValue>1024</ParameterValue>
            <CheckingCode>[100-10000]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>slowlog-max-len</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>
                Similarly to hashes and lists, sorted sets are also specially encoded in
            order to save a lot of space.</ParameterDescription>
            <ParameterValue>128</ParameterValue>
            <CheckingCode>[0-999999999999999]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>zset-max-ziplist-entries</ParameterName>
        </Parameter>
        <Parameter>
            <ParameterDescription>
                Similarly to hashes and lists, sorted sets are also specially encoded in
            order to save a lot of space.</ParameterDescription>
            <ParameterValue>64</ParameterValue>
            <CheckingCode>[0-999999999999999]</CheckingCode>
            <ForceRestart>false</ForceRestart>
            <ModifiableStatus>true</ModifiableStatus>
            <ParameterName>zset-max-ziplist-value</ParameterName>
        </Parameter>
    </RunningParameters>
    <EngineVersion>4.0</EngineVersion>
    <Engine>redis</Engine>
</DescribeParametersResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ConfigParameters" : {
    "Parameter" : [ ]
  },
  "RequestId" : "9C1338BE-8DE8-4890-A900-E1BC06BF****",
  "RunningParameters" : {
    "Parameter" : [ {
      "ParameterDescription" : "check whitelist always",
      "ParameterValue" : "no",
      "CheckingCode" : "[yes|no]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "#no_loose_check-whitelist-always"
    }, {
      "ParameterDescription" : "You can disable some dangerous commands, for example \"keys,flushdb,flushall\", the commands must be in [flushall,flushdb,keys,hgetall,eval,evalsha,script].",
      "ParameterValue" : "keys,flushall,flushdb",
      "CheckingCode" : ".*",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "#no_loose_disabled-commands"
    }, {
      "ParameterDescription": "Enable or disable SSL",
      "ParameterValue" : "yes",
      "CheckingCode" : "[yes|no]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "#no_loose_ssl-enabled"
    }, {
      "ParameterDescription" : "Be compatible with cluster mode.",
      "ParameterValue" : "0",
      "CheckingCode" : "[0|1]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "cluster_compat_enable"
    }, {
      "ParameterDescription" : "Check all keys passed in the KEYS array map to the same slot.",
      "ParameterValue" : "1",
      "CheckingCode" : "[0|1]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "script_check_enable"
    }, {
      "ParameterDescription" : "If hash fields are less than this value and hash value sizes are less than hash-max-ziplist-value, the ziplist will be used.",
      "ParameterValue" : "512",
      "CheckingCode" : "[0-999999999999999]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "hash-max-ziplist-entries"
    }, {
      "ParameterDescription" : "If hash value sizes are than less this value and hash fields are less than hash-max-ziplist-entries, the ziplist will be used.",
      "ParameterValue" : "64",
      "CheckingCode" : "[0-999999999999999]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "hash-max-ziplist-value"
    }, {
      "ParameterDescription" : "lazyfree switch on eviction.",
      "ParameterValue" : "yes",
      "CheckingCode" : "[yes|no]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "lazyfree-lazy-eviction"
    }, {
      "ParameterDescription" : "lazyfree switch on expire.",
      "ParameterValue" : "yes",
      "CheckingCode" : "[yes|no]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "lazyfree-lazy-expire"
    }, {
      "ParameterDescription" : "lazyfree switch on server implicit deletion.",
      "ParameterValue" : "yes",
      "CheckingCode" : "[yes|no]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "lazyfree-lazy-server-del"
    }, {
      "ParameterDescription" : "The number of entries on the list that are not compressed at both ends.",
      "ParameterValue" : "0",
      "CheckingCode" : "[0-65535]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "list-compress-depth"
    }, {
      "ParameterDescription" : "Threadhold of ziplist size on quicklist.",
      "ParameterValue" : "-2",
      "CheckingCode" : "[-5-99999999]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "list-max-ziplist-size"
    }, {
      "ParameterDescription" : "To config how Redis will select what to remove when maxmemory is reached. There are eight behaviors that can be chose : volatile-lru,allkeys-lru,volatile-lfu,allkeys-lfu,volatile-random,allkeys-random,volatile-ttl,noeviction",
      "ParameterValue" : "volatile-lfu",
      "CheckingCode" : "[volatile-lru|allkeys-lru|volatile-random|allkeys-random|volatile-ttl|volatile-lfu|allkeys-lfu|noeviction]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "maxmemory-policy"
    }, {
      "ParameterDescription" : "Sets have a special encoding in just one case: when a set is composed\nof just strings that happen to be integers in radix 10 in the range\nof 64 bit signed integers.\nThe following configuration setting sets the limit in the size of the\nset in order to use this special memory saving encoding.",
      "ParameterValue" : "512",
      "CheckingCode" : "[0-999999999999999]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "set-max-intset-entries"
    }, {
      "ParameterDescription" : "The time is expressed in microseconds, so 1000000 is equivalent\nto one second. Note that a negative number disables the slow log,\nwhile a value of zero forces the logging of every command.",
      "ParameterValue" : "10000",
      "CheckingCode" : "[0-10000000]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "slowlog-log-slower-than"
    }, {
      "ParameterDescription" : "The max slowlog count.",
      "ParameterValue" : "1024",
      "CheckingCode" : "[100-10000]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "slowlog-max-len"
    }, {
      "ParameterDescription" : "Similarly to hashes and lists, sorted sets are also specially encoded in\norder to save a lot of space.",
      "ParameterValue" : "128",
      "CheckingCode" : "[0-999999999999999]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "zset-max-ziplist-entries"
    }, {
      "ParameterDescription" : "Similarly to hashes and lists, sorted sets are also specially encoded in\norder to save a lot of space.",
      "ParameterValue" : "64",
      "CheckingCode" : "[0-999999999999999]",
      "ForceRestart" : "false",
      "ModifiableStatus" : "true",
      "ParameterName" : "zset-max-ziplist-value"
    } ]
  },
  "EngineVersion" : "4.0",
  "Engine" : "redis"
}

Error codes


HTTP status code	Error code	Error message	Description
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	The error message returned because the current type of the instance does not support this operation. You can clone or back up only read replicas.
404	InvalidDBInstanceClass.NotFound	Specified DB instance class is not found.	The error message returned because the specified instance type is invalid. Check the specified instance type.

For a list of error codes, visit the API Error Center.