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
Compartilhar

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.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Análise de cache