CreateCacheAnalysisJob - : Central de Documentação do Alibaba Cloud

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

Se você usar um SDK da Alibaba Cloud ou do Database Autonomy Service (DAS) para chamar esta operação, use a versão mais recente do SDK.
Se você usar um SDK para chamar o DAS, defina o ID da região como cn-shanghai.
Esta operação aplica-se apenas a instâncias do ApsaraDB for Redis Community Edition e a instâncias de desempenho aprimorado do ApsaraDB for Redis Enhanced Edition (Tair).

Nota

O ApsaraDB for Redis 7.0 e módulos personalizados não são suportados.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateCacheAnalysisJob	A operação a ser executada. Defina o valor como CreateCacheAnalysisJob.
InstanceId	String	Sim	r-bp18ff4a195d****	O ID da instância do ApsaraDB for Redis.
NodeId	String	Não	r-x****-db-0	O ID do nó de dados na instância. Especifique este parâmetro para consultar as informações de monitoramento do nó especificado. Nota Se você especificar BackupSetId, o sistema ignora o valor de NodeId. Chame a operação DescribeLogicInstanceTopology para obter o ID do nó.
BackupSetId	String	Não	12345	O ID do arquivo de backup. Chame a operação DescribeBackups para consultar o ID do arquivo de backup. Para especificar vários IDs de arquivos de backup, separe-os por vírgulas (,). Por exemplo, defina este parâmetro como `12345,67890`. Se você não especificar este parâmetro, o sistema fará o backup dos dados automaticamente e executará a análise de cache no arquivo de backup.
Separators	String	Não	&	Os delimitadores usados para identificar os prefixos das chaves. Não é necessário especificar este parâmetro se você usar um ou mais dos seguintes delimitadores padrão: `: ; , _ - + @ = \| #`

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Message	String	Successful	A mensagem retornada. Nota Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro contendo informações como o código de erro será retornada.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	O ID da solicitação.
Data	Object		Os detalhes da tarefa.
TaskState	String	BACKUP	O estado da tarefa de análise de cache. Valores válidos: BACKUP: Os dados estavam em backup. ANALYZING: Os dados estavam em análise. FINISHED: A análise dos dados foi concluída. FAILED: Ocorreu um erro.
JobId	String	sf79-sd99-sa37-****	O ID da tarefa de análise de cache. Nota Use este parâmetro para consultar uma tarefa específica de análise de cache. Ao chamar a operação CreateCacheAnalysisJob, o sistema precisa de tempo para criar a tarefa, portanto os resultados não são retornados imediatamente. Especifique este parâmetro ao chamar a operação DescribeCacheAnalysisJob para consultar os resultados da tarefa de análise de cache especificada.
Message	String	Successful	A mensagem retornada. Nota Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro contendo informações como o código de erro será retornada.
BigKeys	Array of KeyInfo		Os detalhes das chaves grandes. As chaves retornadas são classificadas em ordem decrescente com base no número de bytes ocupados.
KeyInfo
Type	String	hash	O tipo de dados da instância do ApsaraDB for Redis.
Db	Integer	0	O nome do banco de dados.
ExpirationTimeMillis	Long	1596256542547	O tempo de expiração da chave. Unidade: milissegundo. Um valor igual a 0 indica que a chave não expira.
Key	String	task_x****	O nome da chave.
Encoding	String	hashtable	O tipo de codificação da chave.
Bytes	Long	12345	O número de bytes ocupados pela chave.
NodeId	String	r-x****-db-0	O ID do nó de dados na instância.
Count	Long	127	O número de elementos na chave.
InstanceId	String	r-bp18ff4a195d****	O ID da instância de banco de dados.
NodeId	String	r-x****-db-0	O ID do nó de dados na instância.
Code	String	200	O código de resposta.
Success	String	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true false

Exemplos

Exemplos de solicitações

http(s)://das.cn-shanghai.aliyuncs.com/?Action=CreateCacheAnalysisJob
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&BackupSetId=12345
&Separators=&
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateCacheAnalysisJobResponse>
    <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>
        <InstanceId>r-bp18ff4a195d****</InstanceId>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</CreateCacheAnalysisJobResponse>

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
    } ],
    "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.	Os parâmetros da solicitação são inválidos.
403	NoPermission	You are not authorized to do this action.	Você não tem autorização para executar esta operação.

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