Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda> Distributed Cache Service> Referência de API> API V2> Análise de cache> Consulta de detalhes da análise de hot key

Atualizado em 2022-11-09 GMT+08:00

Ver PDF

Consulta de detalhes da análise de hot key

Função

Essa API é usada para consultar os detalhes da análise de hot key.

URI

GET /v2/{project_id}/instances/{instance_id}/hotkey-task/{hotkey_id}

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto.
instance_id	Sim	String	ID da instância.
hotkey_id	Sim	String	ID da tarefa de análise da tecla de atalho.

Parâmetros de solicitação

Nenhum

Parâmetros de resposta

Código de estado: 200

**Tabela 2** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
id	String	ID do registro de análise de tecla quente.
instance_id	String	ID da instância.
status	String	Status da tarefa de análise. Valores de enumeração: waiting running success failed
scan_type	String	Modo de análise. Valores de enumeração: manual auto
created_at	String	Hora em que uma tarefa de análise é criada. O formato é "2020-06-15T02:21:18.669Z".
started_at	String	Hora em que uma tarefa de análise foi iniciada. O formato é "2020-06-15T02:21:18.669Z". (O valor é nulo e não é retornado quando a tarefa de análise está sendo criada.)
finished_at	String	Hora em que uma tarefa de análise terminou. O formato é "2020-06-15T02:21:18.669Z". (O valor é nulo e não é retornado quando a tarefa de análise está sendo criada.)
num	Integer	Número de teclas de atalho.
keys	Array of HotkeysBody objects	Gravação de tecla quente. (O valor é nulo e não é retornado quando a tarefa de análise está sendo criada.)

**Tabela 3** HotkeysBody
Parâmetro	Tipo	Descrição
name	String	Nome da chave
type	String	Tipo de chave. Valores de enumeração: string list set zset hash
shard	String	Partição onde a tecla de atalho está localizada. Este parâmetro é suportado apenas quando o tipo de instância é cluster. O formato é ip:port.
db	Integer	Banco de dados onde a tecla de atalho está localizada.
size	Integer	Tamanho do valor da chave.
unit	String	Unidade do tamanho da chave. Quando o tipo de chave é string, a unidade é byte. Quando o tipo de chave é lista, conjunto, zset ou hash, a unidade é contagem.
freq	Integer	Frequência de acesso de uma chave dentro de um período de tempo específico. O valor é o contador de frequência de acesso logarítmico. O valor máximo é 255, o que indica 1 milhão de solicitações de acesso. Depois que a frequência atingir 255, o valor não aumentará mais, mesmo que as solicitações de acesso continuem aumentando. O valor diminuirá em 1 para cada minuto durante o qual a chave não é acessada.

Código de estado: 400

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 401

**Tabela 5** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 403

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 404

**Tabela 7** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Código de estado: 500

**Tabela 8** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_msg	String	Mensagem de erro. Máximo: 1024
error_code	String	Código de erro. Máximo: 9
error_ext_msg	String	Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo. Máximo: 1024

Exemplos de solicitações

GET https://dcs.cn-south-1.myhuaweicloud.com/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/hotkey-task/0ccb25d5-27cf-4188-b5ea-987730a85371

Exemplo de respostas

Código de estado: 200

Detalhes da análise da chave quente consultados com sucesso.

{
  "id" : "858ee14c-2271-4489-8b82-7bda7459ae3e",
  "instance_id" : "5f9057b5-c330-4ee2-8138-7e69896eeec3",
  "status" : "success",
  "scan_type" : "manual",
  "created_at" : "2020-06-15T02:21:18.669Z",
  "started_at" : "2020-06-15T02:21:23.534Z",
  "finished_at" : "2020-06-15T02:21:25.588Z",
  "keys" : [ {
    "name" : "dcs-hotkey-test",
    "type" : "string",
    "shard" : "192.168.1.134:6379",
    "db" : 0,
    "size" : 3000,
    "unit" : "byte",
    "freq" : 4
  } ]
}

Código de estado: 400

Pedido inválido.

{
  "error_code" : "DCS.4922",
  "error_msg" : "Does not support hotkey analyze."
}

Códigos de status

Código de status	Descrição
200	Detalhes da análise da chave quente consultados com sucesso.
400	Pedido inválido.
401	Informações de autenticação inválidas.
403	O pedido é rejeitado.
404	O recurso solicitado não foi encontrado.
500	Erro de serviço interno.