DescribeBinlogFiles - - Centre de documentation Alibaba Cloud

Consulte les fichiers de sauvegarde des journaux pour une instance ApsaraDB for MongoDB.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Non	L'identifiant de la région.	cn-zhangjiakou
DBInstanceId	string	Oui	L'identifiant de l'instance. Si l'instance est un cluster fragmenté, vous devez également spécifier le paramètre NodeId.	dds-wz9ca592fc637a54
NodeId	string	Non	L'identifiant du nœud mongos ou du nœud de fragment dans l'instance de cluster fragmenté.\n\n> Ce paramètre s'applique uniquement aux instances de cluster fragmenté.	d-uf696817a1b5d9f4
StartTime	string	Oui	L'heure de début de la requête. L'heure est au format yyyy-MM-ddTHH:mm:ss.xxxZ. L'heure est affichée en UTC.	2021-03-23T06:24:21.425Z
EndTime	string	Oui	L'heure de fin de la requête. L'heure doit être postérieure à l'heure de début. L'heure est au format yyyy-MM-ddTHH:mm:ss.xxxZ. L'heure est affichée en UTC.	2023-04-17T05:50:28.914Z
PageSize	integer	Non	Le nombre d'entrées à renvoyer sur chaque page.	10
PageNumber	integer	Non	Le numéro de page.	1
SrcRegion	string	Non	La région de l'instance source pour une sauvegarde interrégionale.\n\n> - Ce paramètre est requis lorsque vous interrogez des sauvegardes interrégionales.	ap-southeast-1
DestRegion	string	Non	La région où la sauvegarde interrégionale est stockée.\n\n> Ce paramètre est requis lorsque vous interrogez des sauvegardes interrégionales.	cn-beijing
BinlogId	string	Non	L'identifiant du binlog. Ce paramètre n'est actuellement pas pris en charge.	null
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-xxxx

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	F8CA8312-530A-413A-9129-F2BB32A8D404
PageNumber	integer	Le numéro de page des résultats renvoyés.	3
MaxRecordsPerPage	integer	Le nombre d'entrées à renvoyer sur chaque page.	30
TotalRecordCount	integer	Le nombre total de fichiers binlog trouvés.	240
Items	object
LogFile	array<object>	Les détails des fichiers binlog.
	object	Les détails d'un fichier binlog.
LogFileName	string	The name of the binlog file.	1709846151
DumpDownloadURL	string	The OSS download link for the binlog file. (Currently not supported.)	null
LogBeginTime	string	The start time of the data in the binlog file. Format: yyyy-MM-ddTHH:mm:ssZ (UTC)	2024-03-08T09:31:29Z
DumpBucket	string	The storage location of the binlog file. (Currently not supported.)	null
LinkExpiredTime	string	The URL expiration time. (Currently not supported.)	null
DownloadLink	string	The download link for the binlog file.	https://rdslog-shanghai.xxxxxxxxx
OSSEndpoint	string	The OSS endpoint where the binlog file is stored. (Currently not supported.)	null
LogEndTime	string	The end time of the data in the binlog file. Format: yyyy-MM-ddTHH:mm:ssZ (UTC).	2024-03-09T02:55:00Z
DumpState	integer	The dump status. (Currently not supported.)	null
FileSize	string	The size of the binlog file, in bytes.	603127135
FileId	string	The unique identifier for the binlog file.	5098
BinLogId	string	The binlog ID. (Currently not supported.)	null
LogStatus	string	The log backup status. Valid values: Uploading: The file is being uploaded. Completed: The file has been successfully uploaded. Valeurs valides : Completed : Uploading :	Completed

Exemples

JSON format

{
  "RequestId": "F8CA8312-530A-413A-9129-F2BB32A8D404",
  "PageNumber": 3,
  "MaxRecordsPerPage": 30,
  "TotalRecordCount": 240,
  "Items": {
    "LogFile": [
      {
        "LogFileName": "1709846151",
        "DumpDownloadURL": "null",
        "LogBeginTime": "2024-03-08T09:31:29Z",
        "DumpBucket": "null",
        "LinkExpiredTime": "null",
        "DownloadLink": "https://rdslog-shanghai.xxxxxxxxx",
        "OSSEndpoint": "null",
        "LogEndTime": "2024-03-09T02:55:00Z",
        "DumpState": 0,
        "FileSize": "603127135",
        "FileId": "5098",
        "BinLogId": "null",
        "LogStatus": "Completed"
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidDBInstance.Malformed	Too many instance ids or instance id format is invalid.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.