Interroger les fichiers de sauvegarde des journaux - - Centre de documentation Alibaba Cloud

Si la valeur de retour du paramètre DownloadLink est NULL pour un fichier de sauvegarde de journal, ApsaraDB RDS ne fournit aucune URL de téléchargement.
Si la valeur de retour du paramètre DownloadLink n'est pas NULL, ApsaraDB RDS fournit une URL de téléchargement. La date d'expiration de cette URL est indiquée par le paramètre LinkExpiredTime ; téléchargez le fichier avant cette échéance.
Cette opération renvoie les entrées de journal SQL générées sur une plage horaire donnée. Le début de la plage doit être postérieur ou égal à l'heure spécifiée par le paramètre LogEndTime, tandis que la fin de la plage doit être antérieure ou égale à l'heure spécifiée par le paramètre LogBeginTime.

Remarque

Cette opération n'est pas prise en charge pour les instances exécutant SQL Server.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeBinlogFiles	Opération à effectuer. Définissez la valeur sur DescribeBinlogFiles.
DBInstanceId	String	Oui	rm-uf6wjk5xxxxxxx	ID de l'instance.
EndTime	String	Oui	2011-06-20T15:00:00Z	Fin de la plage horaire à interroger. L'heure de fin doit être postérieure à l'heure de début. Spécifiez l'heure au format ISO 8601 : yyyy-MM-dd T HH:mm:ss Z. L'heure doit être exprimée en UTC.
StartTime	String	Oui	2011-06-01T15:00:00Z	Début de la plage horaire à interroger. Spécifiez l'heure au format ISO 8601 : yyyy-MM-dd T HH:mm:ss Z. L'heure doit être exprimée en UTC.
PageSize	Integer	Non	30	Nombre d'entrées à renvoyer par page. Valeurs valides : de 1 à 100. Valeur par défaut : 30.
PageNumber	Integer	Non	1	Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.

Paramètres de réponse

Paramètre	Type	Exemple	Description
TotalRecordCount	Integer	100	Nombre total de fichiers de sauvegarde de journaux renvoyés.
PageNumber	Integer	1	Numéro de la page renvoyée.
PageRecordCount	Integer	30	Nombre de fichiers de sauvegarde de journaux renvoyés sur la page actuelle.
Items	Array of BinLogFile		Tableau composé de fichiers de sauvegarde de journaux.
BinLogFile
FileSize	Long	2269410	Taille du fichier de sauvegarde de journal. Unité : octets.
LogBeginTime	String	2019-02-09T17:45:21Z	Heure de début des données de journal enregistrées dans le fichier de sauvegarde de journal. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
LogEndTime	String	2019-02-15T13:10:28Z	Heure de fin des données de journal enregistrées dans le fichier de journal binaire. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
DownloadLink	String	http://rdsxxxxx.oss.aliyuncs.com/xxxxxx	URL permettant de télécharger le fichier de sauvegarde de journal via HTTP. Si ce paramètre est défini sur NULL, aucune URL n'est disponible.
HostInstanceID	String	5841973	ID de l'instance qui génère le fichier de sauvegarde de journal. Utilisez ce paramètre pour distinguer les fichiers de sauvegarde générés par une instance principale de ceux générés par l'instance secondaire de l'instance principale.
LinkExpiredTime	String	2013-06-09T18:00:00Z	Date d'expiration de l'URL. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
Checksum	String	18358304393468701857	Somme de contrôle. La valeur de ce paramètre est calculée par l'algorithme CRC64.
IntranetDownloadLink	String	http://rdslog-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxxx	URL permettant de télécharger le fichier de sauvegarde de journal via un réseau interne.
LogFileName	String	000000040000000000000019	Nom du fichier de sauvegarde de journal.
RemoteStatus	String	Completed	Statut du fichier de sauvegarde de journal dans le compartiment Object Storage Service (OSS) où il est stocké. Valeurs valides : Uploading : Le fichier de sauvegarde de journal est en cours de téléversement vers le compartiment OSS. Completed : Le fichier de sauvegarde de journal a été téléversé vers le compartiment OSS.
RequestId	String	ED169A3E-1657-4104-82AB-24EA8CD0DB75	ID de la requête.
TotalFileSize	Long	2269410	Taille totale des fichiers de sauvegarde de journaux renvoyés.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=DescribeBinlogFiles
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2011-06-01T15:00:00Z
&EndTime=2011-06-20T15:00:00Z
&<Common request parameters>

Exemple de réponse réussie

Format XML

<DescribeBinlogFilesResponse>
<?xml version="1.0" encoding="UTF-8" ?>
<TotalRecordCount>1</TotalRecordCount>
<PageRecordCount>1</PageRecordCount>
<RequestId>C91A2FEA-DDBE-5BE1-9944-9C8DA6E45334</RequestId>
<PageNumber>1</PageNumber>
<TotalFileSize>439562</TotalFileSize>
<Items>
    <BinLogFile>
        <DownloadLink>http://rdslog********.aliyuncs.com/mysql-bin.000071</DownloadLink>
        <LogBeginTime>2021-10-13T07:44:37Z</LogBeginTime>
        <LinkExpiredTime>2021-10-17T03:16:50Z</LinkExpiredTime>
        <Checksum>261972378**********</Checksum>
        <LogEndTime>2021-10-13T13:44:39Z</LogEndTime>
        <IntranetDownloadLink>http://rdslog********.aliyuncs.com/mysql-bin.000071</IntranetDownloadLink>
        <RemoteStatus>Completed</RemoteStatus>
        <HostInstanceID>1947****</HostInstanceID>
        <LogFileName>mysql-bin.000071</LogFileName>
        <FileSize>439562</FileSize>
    </BinLogFile>
</Items>
</DescribeBinlogFilesResponse>

Format JSON

{
    "TotalRecordCount": 1,
    "PageRecordCount": 1,
    "RequestId": "C91A2FEA-DDBE-5BE1-9944-9C8DA6E45334",
    "PageNumber": 1,
    "TotalFileSize": "439562",
    "Items": {
        "BinLogFile": [
            {
                "DownloadLink": "http://rdslog********.aliyuncs.com/mysql-bin.000071",
                "LogBeginTime": "2021-10-13T07:44:37Z",
                "LinkExpiredTime": "2021-10-17T03:16:50Z",
                "Checksum": "261972378**********",
                "LogEndTime": "2021-10-13T13:44:39Z",
                "IntranetDownloadLink": "http://rdslog********.aliyuncs.com/mysql-bin.000071",
                "RemoteStatus": "Completed",
                "HostInstanceID": 1947****,
                "LogFileName": "mysql-bin.000071",
                "FileSize": 439562
            }
        ]
    }
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	ParameterLeastAssociate	Must input at least one optional parameter.	Les paramètres restoreTime et BackupId de l'instance ne peuvent pas être vides simultanément. Spécifiez au moins l'un de ces paramètres et réessayez.
404	InvalidDBInstance.NotFound	Specified instance does not exist or not support.	L'instance est introuvable, supprimée ou ne prend pas en charge l'opération.
400	ParameterAbsence	Necessary parameter is absence.	Les paramètres requis ne sont pas spécifiés.
403	IncorrectDBInstanceEngine	Current DB Instance engine does not support this operation.	Le moteur de base de données de l'instance ne prend pas en charge cette opération.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	L'état de l'instance ne prend pas en charge cette opération.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	L'instance est verrouillée.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.