CreateDataCronClearOrder - - Centre de documentation Alibaba Cloud

Pour plus d'informations sur la purge des données historiques, consultez la rubrique Purge des données historiques.

Cette opération est uniquement disponible pour les bases de données MySQL.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateDataCronClearOrder	L'action à effectuer. Définissez la valeur sur CreateDataCronClearOrder.
Comment	String	Oui	test	Le but ou l'objectif de la modification des données. Cela permet de réduire les communications inutiles.
RelatedUserList	Array of Long	Non	243253	Les parties prenantes de cette opération. Elles peuvent consulter les détails du ticket et participer au processus d'approbation. Les utilisateurs non concernés, autres que les administrateurs Data Management (DMS) et les administrateurs de base de données (DBA), ne sont pas autorisés à afficher les détails du ticket.
Param	Object	Oui		Les paramètres du ticket.
Classify	String	Non	test	La raison de la modification des données.
DbItemList	Array	Oui		Les bases de données dont vous souhaitez purger les données historiques.
DbId	Long	Oui	10****	L'ID de la base de données. Appelez l'opération SearchDatabases pour récupérer l'ID de la base de données.
Logic	Boolean	Oui	false	Indique si la base de données est une base de données logique. Valeurs valides : true : la base de données est une base de données logique. false : la base de données n'est pas une base de données logique.
CronFormat	String	Oui	0 0 2 * * ?	L'expression crontab permettant d'exécuter la tâche à une heure spécifiée. Pour plus d'informations, consultez la rubrique Expression Crontab.
CronClearItemList	Array	Oui		Les tables dont vous souhaitez purger les données historiques.
TableName	String	Oui	t1	Le nom de la table. Appelez l'opération ListTables pour récupérer le nom de la table.
ColumnName	String	Oui	gmt_create	Le nom du champ.
RemainDays	Long	Oui	7	La période de conservation des données historiques. Unité : jours. Par exemple, si vous définissez ce paramètre sur 7, DMS supprime les données conservées depuis plus de sept jours.
TimeUnit	String	Non	MILLISECONDS	Le type de granularité temporelle. Ce paramètre est requis si le paramètre ColumnName spécifie un champ de type temporel. Valeurs valides : MILLISECONDS : millisecondes SECONDS : secondes
FilterSQL	String	Non	where 1 = 1	Les conditions de filtre.
specifyDuration	Boolean	Oui	true	Indique s'il faut spécifier une heure de fin pour la tâche. Valeurs valides : true : spécifie une heure de fin pour la tâche. La tâche est automatiquement suspendue après cette heure de fin. false : ne spécifie pas d'heure de fin pour la tâche. La tâche s'arrête après la purge des données historiques.
DurationHour	Long	Non	4	La durée d'exécution de la tâche. Unité : heures. Remarque Si le paramètre specifyDuration est défini sur true, ce paramètre est obligatoire.
AttachmentKey	String	Non	order_attachement.txt	La clé de la pièce jointe du ticket. La pièce jointe fournit des instructions supplémentaires pour cette opération. Appelez l'opération GetUserUploadFileJob pour récupérer la clé de la pièce jointe.
Tid	Long	Non	123454324	L'ID du locataire. Remarque L'ID du locataire s'affiche lorsque vous placez le pointeur sur la photo de profil dans le coin supérieur droit de la console DMS. Pour plus d'informations, consultez la section Affichage des informations sur le locataire actuel de la rubrique Gestion des locataires DMS.
RegionId	String	Non	cn-hangzhou	L'ID de la région dans laquelle DMS est activé. Pour plus d'informations sur les valeurs valides de ce paramètre, consultez la rubrique Paramètre RegionID. Remarque Définissez ce paramètre sur l'ID de la région proche de vos applications.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931	L'ID de la requête.
Success	Boolean	true	Indique si la requête a abouti.
ErrorMessage	String	UnknownError	Le message d'erreur.
ErrorCode	String	UnknownError	Le code d'erreur.
CreateOrderResult	Array of Long	1341532	L'ID du ticket.

Exemples

Exemple de requête

http(s)://dms-enterprise.aliyuncs.com/?Action=CreateDataCronClearOrder
&Comment=test
&RelatedUserList=[243253]
&Param={"Classify":"test","DbItemList":[{"DbId":10****,"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
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<CreateDataCronClearOrderResponse>
    <RequestId>0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931</RequestId>
    <Success>true</Success>
    <CreateOrderResult>1341532</CreateOrderResult>
</CreateDataCronClearOrderResponse>

JSON format

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

{
  "RequestId" : "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
  "Success" : true,
  "CreateOrderResult" : [ 1341532 ]
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.