Todos os produtos
Search
Central de documentação

:DescribeCacheAnalysisJobs

Última atualização: Jun 27, 2026

Consulta tarefas de análise de cache.

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

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

  • 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 DescribeCacheAnalysisJobs

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

InstanceId String Sim r-bp18ff4a195d****

O ID da instância de banco de dados.

StartTime String Sim 1596177993000

Início do intervalo de tempo da consulta. Especifique o horário no formato de timestamp UNIX. Unidade: milissegundos.

EndTime String Sim 1596177993001

Fim do intervalo de tempo da consulta. Especifique o horário no formato de timestamp UNIX. Unidade: milissegundos.

Nota O horário final deve ser posterior ao inicial.
PageNo String Não 1

Número da página a retornar. O valor deve ser um inteiro maior que 0. Valor padrão: 1.

PageSize String Não 10

Número máximo de entradas a retornar por página. Valor padrão: 10.

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, Successful será retornado. Em caso de falha, uma mensagem de erro com informações como o código de erro será retornada.
RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

ID da solicitação.

Data Object

Detalhes da instância.

List Array of CacheAnalysisJob

Detalhes das tarefas de análise de cache.

CacheAnalysisJob
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, Successful será retornado. Em caso de falha, uma mensagem de erro com informações como o código de erro será retornada.
BigKeys Array of KeyInfo

Detalhes sobre as big keys.

Importante Os subparâmetros e valores correspondentes não são retornados. Para consultar detalhes das tarefas de análise de cache, chame a operação DescribeCacheAnalysisJob.
KeyInfo
Type String hash

Tipo de dados da instância.

Db Integer 0

Nome do banco de dados.

ExpirationTimeMillis Long 1596256542547

Horário de expiração da chave. Unidade: milissegundos. O valor 0 indica que a chave não expira.

Key String task_*****

Nome da chave.

Encoding String hashtable

Tipo de dados da chave.

Bytes Long 12345

Número de bytes ocupados pela chave.

NodeId String r-****-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.

PageNo Long 1

Número da página retornada. O valor deve ser um inteiro maior que 0. Valor padrão: 1.

PageSize Long 10

Número máximo de entradas retornadas por página. Valor padrão: 10.

Extra String None

Parâmetro reservado.

Total Long 4

Número total de tarefas de análise de cache.

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=DescribeCacheAnalysisJobs
&InstanceId=r-bp18ff4a195d****
&StartTime=1596177993000
&EndTime=1596177993001
&PageNo=1
&PageSize=10
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<DescribeCacheAnalysisJobsResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <List>
            <TaskState>BACKUP</TaskState>
            <JobId>sf79-sd99-sa37-****</JobId>
            <Message>Successful</Message>
            <BigKeys>
                <Type>hash</Type>
                <Db>0</Db>
                <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
                <Key>task_*****</Key>
                <Encoding>hashtable</Encoding>
                <Bytes>12345</Bytes>
                <NodeId>r-****-db-0</NodeId>
                <Count>127</Count>
            </BigKeys>
            <InstanceId>r-bp18ff4a195d****</InstanceId>
            <NodeId>r-x****-db-0</NodeId>
        </List>
        <PageNo>1</PageNo>
        <PageSize>10</PageSize>
        <Extra>None</Extra>
        <Total>4</Total>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeCacheAnalysisJobsResponse>

Formato JSON

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "List" : [ {
      "TaskState" : "BACKUP",
      "JobId" : "sf79-sd99-sa37-****",
      "Message" : "Successful",
      "BigKeys" : [ {
        "Type" : "hash",
        "Db" : 0,
        "ExpirationTimeMillis" : 1596256542547,
        "Key" : "task_*****",
        "Encoding" : "hashtable",
        "Bytes" : 12345,
        "NodeId" : "r-****-db-0",
        "Count" : 127
      } ],
      "InstanceId" : "r-bp18ff4a195d****",
      "NodeId" : "r-x****-db-0"
    } ],
    "PageNo" : 1,
    "PageSize" : 10,
    "Extra" : "None",
    "Total" : 4
  },
  "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 de solicitação especificados são inválidos.

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