DescribeTopHotKeys - : Central de Documentação do Alibaba Cloud

Uma chave é considerada hot key quando seu número de consultas por segundo (QPS) ultrapassa 3.000.

Se você usar um SDK da Alibaba Cloud, verifique se a versão do aliyun-sdk-core é superior à V4.3.3. Recomendamos o uso da versão mais recente.
A versão do SDK do Database Autonomy Service (DAS) deve ser V1.0.2 ou posterior.
Para chamar o DAS via SDK, defina a região como cn-shanghai.
A operação DescribeTopHotKeys está disponível apenas para instâncias do ApsaraDB for Redis nas seguintes versões:
- Instância Community Edition com versão principal 5.0 ou posterior, ou instância de desempenho aprimorado da Enhanced Edition (Tair).
- Instância atualizada para a versão secundária mais recente.

Nota

Para obter informações sobre como consultar e atualize a versão secundária de uma instância de banco de dados, consulte

DescribeEngineVersion

e

ModifyInstanceMinorVersion

.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeTopHotKeys	Operação a ser executada. Defina o valor como DescribeTopHotKeys.
ConsoleContext	String	Não	Nenhum	Parâmetro reservado.
InstanceId	String	Sim	r-bp18ff4a195d****	ID da instância do ApsaraDB for Redis. Chame a operação DescribeInstances para consultar o ID.
NodeId	String	Não	r-****-db-0	ID do shard de dados na instância do ApsaraDB for Redis. Chame a operação DescribeRoleZoneInfo para consultar o ID.
StartTime	String	Sim	1596177993000	Início do intervalo de tempo a ser consultado. Defina este parâmetro como um timestamp UNIX. Unidade: milissegundos.
EndTime	String	Sim	1596177993001	Fim do intervalo de tempo a ser consultado. Defina este parâmetro como um timestamp UNIX. Unidade: milissegundos. Nota O horário final deve ser posterior ao horário inicial. Somente dados dos últimos quatro dias podem ser consultados. O intervalo máximo entre o horário especificado por StartTime e aquele especificado por EndTime é de três horas.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Message	String	Successful	Mensagem retornada pela solicitação.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID da solicitação.
Data	Array of HotKey		Detalhes das hot keys.
HotKey
Db	Integer	0	Banco de dados onde a chave está armazenada.
Key	String	abc:def:eng	Nome da chave.
Hot	String	5500~6000	Frequência de acesso à chave, que indica o QPS da chave.
KeyType	String	zset	Tipo da chave.
Lfu	Integer	253	Valor estatístico calculado com base no algoritmo de cache LFU (Least Frequently Used).
NodeId	String	r-x****-db-0	ID do shard de dados na instância do ApsaraDB for Redis.
Code	String	200	Código de status HTTP retornado.
Success	String	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.

Exemplos

Exemplos de solicitações

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeTopHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-****-db-0
&StartTime=1596177993000
&EndTime=1596177993001
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeTopHotKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Db>0</Db>
        <Key>abc:def:eng</Key>
        <Hot>5500~6000</Hot>
        <KeyType>zset</KeyType>
        <Lfu>253</Lfu>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeTopHotKeysResponse>

Formato JSON

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : [ {
    "Db" : 0,
    "Key" : "abc:def:eng",
    "Hot" : "5500~6000",
    "KeyType" : "zset",
    "Lfu" : 253,
    "NodeId" : "r-x****-db-0"
  } ],
  "Code" : "200",
  "Success" : "true"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParams	The request parameters are invalid.	Mensagem de erro retornada porque os parâmetros de solicitação especificados são inválidos.

Para obter uma lista de códigos de erro, visite o API Error Center.