Todos os produtos
Search
Central de documentação

:DescribeCacheAnalysisJob

Última atualização: Jun 27, 2026

Consulta os detalhes de uma tarefa de análise de cache.

Antes de chamar esta operação, observe os seguintes pontos:

  • Se você utilizar um SDK da Alibaba Cloud ou do Database Autonomy Service (DAS) para chamar esta operação, use a versão mais recente do SDK.

  • Ao usar um SDK para chamar operações do DAS, defina a região como cn-shanghai.

  • Esta operação aplica-se exclusivamente ao ApsaraDB for Redis.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeCacheAnalysisJob

A operação a ser executada. Defina o valor como DescribeCacheAnalysisJob.

InstanceId

String

Sim

r-bp18ff4a195d****

O ID da instância.

JobId

String

Sim

sf79-sd99-sa37-****

O ID da tarefa de análise de cache. Obtenha o ID da tarefa nos parâmetros de resposta da operação CreateCacheAnalysisJob.

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, o sistema retornará Successful. Caso contrário, retornará 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 Object

Detalhes da tarefa.

TaskState String BACKUP

Estado da tarefa de análise de cache. Valores válidos:

  • BACKUP: Backup dos dados em andamento.
  • ANALYZING: Análise dos dados em andamento.
  • FINISHED: Análise dos dados concluída.
  • FAILED: Ocorreu um erro.
JobId String sf79-sd99-sa37-****

ID da tarefa de análise de cache.

Message String Successful

Mensagem retornada pela solicitação.

Nota Se a solicitação for bem-sucedida, o sistema retornará Successful. Caso contrário, retornará uma mensagem de erro com informações como o código de erro.
BigKeys Array of KeyInfo

Detalhes das chaves grandes. As chaves retornadas estão classificadas em ordem decrescente pelo número de bytes ocupados.

KeyInfo
Type String hash

Tipo de dados da instância.

Db Integer 0

Nome do banco de dados.

ExpirationTimeMillis Long 1596256542547

Período de expiração da chave. Unidade: milissegundos. O valor 0 indica que a chave não expira.

Key String task_x****

Nome da chave.

Encoding String hashtable

Tipo de codificação da chave.

Bytes Long 12345

Número de bytes ocupados pela chave.

NodeId String r-x****-db-0

ID do nó de dados na instância.

Count Long 127

Número de elementos na chave.

KeyPrefixes Array of Prefix

Prefixos das chaves.

Prefix
KeyNum Long 123

Número de chaves que contêm o prefixo.

Type String hash

Tipo de dados da instância.

Bytes Long 12345

Número de bytes ocupados pelas chaves com este prefixo.

Prefix String task_

Prefixo da chave.

Count Long 127

Número total de elementos nas chaves com este prefixo.

BigKeysOfNum Array of KeyInfo

Detalhes das chaves grandes. As chaves retornadas estão classificadas em ordem decrescente pela quantidade de elementos.

KeyInfo
Type String hash

Tipo de dados da instância.

Db Integer 0

Nome do banco de dados.

ExpirationTimeMillis Long 1596256542547

Período de expiração da chave. Unidade: milissegundos. O valor 0 indica que a chave não expira.

Key String task_x****

Nome da chave.

Encoding String hashtable

Tipo de codificação da chave.

Bytes Long 12345

Número de bytes ocupados pela chave.

NodeId String r-x****-db-0

ID do nó de dados na instância.

Count Long 127

Número de elementos na chave.

UnexBigKeysOfBytes Array of KeyInfo

Detalhes das chaves permanentes. As chaves retornadas estão classificadas em ordem decrescente pelo número de bytes ocupados.

KeyInfo
Type String hash

Tipo de dados da instância.

Db Integer 0

Nome do banco de dados.

ExpirationTimeMillis Long 1596256542547

Período de expiração da chave. Unidade: milissegundos. O valor 0 indica que a chave não expira.

Key String task_x****

Nome da chave.

Encoding String hashtable

Tipo de codificação da chave.

Bytes Long 12345

Número de bytes ocupados pela chave.

NodeId String r-x****-db-0

ID do nó de dados na instância.

Count Long 127

Número de elementos na chave.

UnexBigKeysOfNum Array of KeyInfo

Detalhes das chaves permanentes. As chaves retornadas estão classificadas em ordem decrescente pela quantidade de elementos.

KeyInfo
Type String hash

Tipo de dados da instância.

Db Integer 0

Nome do banco de dados.

ExpirationTimeMillis Long 1596256542547

Período de expiração da chave. Unidade: milissegundos. O valor 0 indica que a chave não expira.

Key String task_x****

Nome da chave.

Encoding String hashtable

Tipo de codificação da chave.

Bytes Long 12345

Número de bytes ocupados pela chave.

NodeId String r-x****-db-0

ID do nó de dados na instância.

Count Long 127

Número de elementos na chave.

InstanceId String r-bp18ff4a195d****

ID da instância de banco de dados.

NodeId String r-x****-db-0

ID do nó de dados na instância.

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

Solicitações de exemplo

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeCacheAnalysisJob
&InstanceId=r-bp18ff4a195d****
&JobId=sf79-sd99-sa37-****
&Common request parameters

Respostas de sucesso de exemplo

Formato XML

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

<DescribeCacheAnalysisJobResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <TaskState>BACKUP</TaskState>
        <JobId>sf79-sd99-sa37-****</JobId>
        <Message>Successful</Message>
        <BigKeys>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </BigKeys>
        <KeyPrefixes>
            <KeyNum>123</KeyNum>
            <Type>hash</Type>
            <Bytes>12345</Bytes>
            <Prefix>task_</Prefix>
            <Count>127</Count>
        </KeyPrefixes>
        <BigKeysOfNum>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </BigKeysOfNum>
        <UnexBigKeysOfBytes>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </UnexBigKeysOfBytes>
        <UnexBigKeysOfNum>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </UnexBigKeysOfNum>
        <InstanceId>r-bp18ff4a195d****</InstanceId>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeCacheAnalysisJobResponse>

Formato JSON

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "TaskState" : "BACKUP",
    "JobId" : "sf79-sd99-sa37-****",
    "Message" : "Successful",
    "BigKeys" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "KeyPrefixes" : [ {
      "KeyNum" : 123,
      "Type" : "hash",
      "Bytes" : 12345,
      "Prefix" : "task_",
      "Count" : 127
    } ],
    "BigKeysOfNum" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "UnexBigKeysOfBytes" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "UnexBigKeysOfNum" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "InstanceId" : "r-bp18ff4a195d****",
    "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.