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> Criação de uma tarefa de análise de hot key

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

Ver PDF

Criação de uma tarefa de análise de hot key

Função

Essa API é usada para criar uma tarefa de análise de hot key. O Redis 3.0 não oferece suporte à análise de teclas de atalho.

Para executar a análise de hot key, o parâmetro maxmemory-policy da instância deve ser definido como allkeys-lfu ou volatile-lfu.

URI

POST /v2/{project_id}/instances/{instance_id}/hotkey-task

**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.

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

POST https://dcs.cn-south-1.myhuaweicloud.com/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/hotkey-task

Exemplo de respostas

Código de estado: 200

Tarefa de análise de tecla de atalho criada com sucesso.

{
  "id" : "aa735b6f-3d70-44e3-9771-66c6fae7459a",
  "instance_id" : "5560df16-cebf-4473-95c4-d1b573c16e79",
  "status" : "waiting",
  "scan_type" : "manual",
  "created_at" : "2020-06-15T02:21:18.669Z",
  "num" : 0
}

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	Tarefa de análise de tecla de atalho criada 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.