Todos os produtos
Search
Central de documentação

:CreateDataCronClearOrder

Última atualização: Jul 09, 2026

Cria um ticket para exclusão de dados históricos.

Para obter mais instruções sobre este recurso, consulte Limpeza de dados históricos .

Esta operação é compatível apenas com bancos de dados MySQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim test

A finalidade ou objetivo da alteração de dados. Isso reduz a comunicação desnecessária.

Comment String Sim test

A finalidade ou objetivo da alteração de dados. Isso reduz a comunicação desnecessária.

RelatedUserList Array of Long Não 243253

As partes interessadas nesta operação. Todas as partes interessadas podem visualizar os detalhes do ticket e auxiliar no processo de aprovação. Usuários não relacionados, exceto administradores do Data Management (DMS) e administradores de banco de dados (DBAs), não têm permissão para visualizar os detalhes do ticket.

Param Object Sim

Os parâmetros do ticket.

Classify String Não test

O motivo da alteração de dados.

DbItemList Array Sim

Os bancos de dados nos quais você deseja alterar dados.

DbId Long Sim 1234

ID do banco de dados, obtido pela interface SearchDatabases .

Logic Boolean Sim false

Especifique se o banco de dados é um banco de dados lógico. Valores válidos:

  • true : Sim
  • false : Não
CronFormat String Sim 0 0 2 * * ?

Expressão Crontab para executar tarefas regularmente. Para obter mais informações, consulte Expressão Crontab .

CronClearItemList Array Sim

As tabelas das quais você deseja excluir dados.

TableName String Sim t1

Nome da tabela. É possível chamar a interface ListTables para obter este parâmetro.

ColumnName String Sim gmt_create

O nome do campo.

RemainDays Long Sim 7

Duração da retenção, ou seja, a regra de limpeza de dados históricos, em dias. Por exemplo, se você configurar como 7 dias, o DMS excluirá dados de 7 dias atrás durante a execução.

TimeUnit String Não MILLISECONDS

O tipo de granularidade de tempo. Se o parâmetro ColumnName especificar um campo de tipo temporal, este parâmetro será obrigatório. Valores válidos:

  • MILLISECONDS : ms.
  • SECONDS : segundos
FilterSQL String Não where 1 = 1

As condições de filtro.

specifyDuration Boolean Sim true

Especifique se deve definir a duração da tarefa. Valores válidos:

  • true : especifique a duração da execução e interrompe a execução após o tempo especificado ser atingido.
  • false : não especifique a duração da execução, continuando até que a limpeza seja concluída.
DurationHour Long Não 4

A duração da tarefa. Unidade: horas.

Nota Quando o parâmetro specifyDuration for true , este parâmetro é obrigatório.
AttachmentKey String Não order_attachement.txt

A chave do anexo do ticket. O anexo fornece mais instruções para esta operação.

É possível chamar a interface GetUserUploadFileJob para obter este parâmetro.

Tid Long Não 123454324

O ID do locatário.

Nota Utilize as informações de ID do locatário exibidas no canto superior direito do sistema. Para obter detalhes, consulte Visualizar informações do locatário .
RegionId String Não cn-hangzhou

Selecione a região de serviço do DMS para chamar a interface. Para obter o valor, consulte Descrição do parâmetro RegionID .

Nota Defina este parâmetro como o ID da região mais próxima dos seus serviços.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931

O ID da solicitação.

Success

Boolean

true

Indica se a chamada foi bem-sucedida.

ErrorMessage

String

UnknownError

A mensagem de erro retornada.

ErrorCode

String

UnknownError

O código de erro retornado.

CreateOrderResult

Array of Long

1341532

O ID do ticket.

Exemplos

Exemplos de solicitações


     http(s)://dms-enterprise.aliyuncs.com/?Comment=test &RelatedUserList=[243253] &Param={"Classify":"test","DbItemList":[{"DbId":1234,"Logic":false}],"CronFormat":"0 0 2 * *? "," CronClearItemList ":[{" TableName ":" t1 "," ColumnName ":" gmt_create "," RemainDays ":7," TimeUnit ":" MILLISECONDS "," FilterSQL ":" where 1 = 1 "}]," specifyDuration ":true," DurationHour ":4} &AttachmentKey=order_attachement.txt &Tid=123454324&Public request parameters 
   

Exemplos de respostas de sucesso

Formato XML


     HTTP/1.1 200 OK Content-Type:application/xml <CreateDataCronClearOrderResponse> <RequestId>0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931</RequestId> <Success>true</Success> <CreateOrderResult>1341532</CreateOrderResult> </CreateDataCronClearOrderResponse> 
   

Formato JSON


     HTTP/1.1 200 OK Content-Type:application/json { "RequestId" : "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931", "Success" : true, "CreateOrderResult" : [ 1341532 ] } 
   

Códigos de erro

Visite o Error Center para visualizar mais códigos de erro.