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

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

Se você utilizar um SDK da Alibaba Cloud, a versão do aliyun-sdk-core deve ser 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.
Ao usar um SDK para chamar o DAS, defina a região como cn-shanghai.
A operação DescribeHotKeys está disponível apenas para instâncias do ApsaraDB for Redis que atendem aos seguintes requisitos:
- A instância é uma Community Edition com versão principal 5,0 ou posterior, ou uma instância de desempenho aprimorado da Enhanced Edition (Tair).
- A instância está atualizada para a versão secundária mais recente.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeHotKeys	Operação a ser executada. Defina o valor como DescribeHotKeys.
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-x****-db-0	ID do shard de dados na instância do ApsaraDB for Redis. Chame a operação DescribeRoleZoneInfo para consultar o ID.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Message	String	Successful	Mensagem retornada pela solicitação. Nota Se a solicitação for bem-sucedida, Successful será retornado. Em caso de falha, o sistema retorna uma mensagem de erro com informações como o código de erro.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID da solicitação.
Data	Array of HotKey		Detalhes sobre as hot keys.
HotKey
Key	String	abc:def:eng	Nome da chave.
Db	Integer	0	Banco de dados onde a chave está armazenada.
Hot	String	5500~6000	Frequência de acesso à chave, que indica as consultas por segundo (QPS).
KeyType	String	zset	Tipo da chave.
Size	Long	2	Número de elementos na chave.
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=DescribeHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeHotKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Key>abc:def:eng</Key>
        <Db>0</Db>
        <Hot>5500~6000</Hot>
        <KeyType>zset</KeyType>
        <Size>2</Size>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeHotKeysResponse>

Formato JSON

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : [ {
    "Key" : "abc:def:eng",
    "Db" : 0,
    "Hot" : "5500~6000",
    "KeyType" : "zset",
    "Size" : 2
  } ],
  "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.