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

As chaves dos tipos list, hash, set e zset são classificadas com base na quantidade de elementos. As três chaves com mais elementos são consideradas chaves grandes.

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

Nota

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

ModifyInstanceMinorVersion

e

DescribeEngineVersion

.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeTopBigKeys	Operação a ser executada. Defina o valor como DescribeTopBigKeys.
ConsoleContext	String	Não	None	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-x****-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. O valor deste parâmetro é um timestamp UNIX. Unidade: milissegundos.
EndTime	String	Sim	1596177993001	Fim do intervalo de tempo a ser consultado. O valor deste parâmetro é um timestamp UNIX. Unidade: milissegundos. Nota O horário de término deve ser posterior ao horário de início. É possível consultar apenas dados dos últimos 4 dias. O intervalo máximo entre o horário de início e o horário de término é de 3 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 BigKey		Detalhes das chaves grandes. Nota Se nenhuma chave grande for encontrada no período consultado, nenhum resultado será retornado.
BigKey
Key	String	abc:def:eng	Nome da chave.
Db	Integer	0	Banco de dados onde a chave está armazenada.
KeyType	String	zset	Tipo da chave.
Size	Long	2	Número de elementos na chave.
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=DescribeTopBigKeys
&ConsoleContext=6c2e064b-a45f-4bd0-8a80-*********
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-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

<DescribeTopBigKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Key>abc:def:eng</Key>
        <Db>0</Db>
        <KeyType>zset</KeyType>
        <Size>2</Size>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeTopBigKeysResponse>

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,
    "KeyType" : "zset",
    "Size" : 2,
    "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 da solicitação especificados são inválidos.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.