Kueri file cadangan log - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi DescribeBinlogFiles untuk mengkueri file cadangan log dari instans ApsaraDB RDS.

Jika nilai kembali parameter DownloadLink adalah NULL untuk suatu file cadangan log, ApsaraDB RDS tidak menyediakan URL untuk mengunduh file tersebut.
Jika nilai kembali parameter DownloadLink bukan NULL untuk suatu file cadangan log, ApsaraDB RDS menyediakan URL unduhan. Masa berlaku URL tersebut ditentukan oleh parameter LinkExpiredTime. Anda harus mengunduh file sebelum masa berlaku habis.
Operasi ini mengembalikan entri log SQL yang dihasilkan dalam rentang waktu tertentu. Awal rentang waktu harus lebih besar daripada atau sama dengan waktu yang ditentukan oleh parameter LogEndTime, sedangkan akhir rentang waktu harus lebih kecil daripada atau sama dengan waktu yang ditentukan oleh parameter LogBeginTime.

Catatan Operasi ini tidak didukung untuk instans yang menjalankan SQL Server.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeBinlogFiles	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeBinlogFiles.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID instans.
EndTime	String	Yes	2011-06-20T15:00:00Z	Akhir rentang waktu untuk dikueri. Waktu akhir harus lebih baru daripada waktu mulai. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
StartTime	String	Yes	2011-06-01T15:00:00Z	Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
PageSize	Integer	No	30	Jumlah entri yang dikembalikan per halaman. Nilai valid: 1 hingga 100. Nilai default: 30.
PageNumber	Integer	No	1	Nomor halaman yang dikembalikan. Nilai valid: bilangan bulat positif selain nol. Nilai default: 1.

Parameter respons

Parameter	Type	Example	Description
TotalRecordCount	Integer	100	Total jumlah file cadangan log yang dikembalikan.
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
PageRecordCount	Integer	30	Jumlah file cadangan log yang dikembalikan pada halaman saat ini.
Items	Array of BinLogFile		Array yang berisi file cadangan log.
BinLogFile
FileSize	Long	2269410	Ukuran file cadangan log. Satuan: byte.
LogBeginTime	String	2019-02-09T17:45:21Z	Waktu mulai data log yang direkam dalam file cadangan log. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
LogEndTime	String	2019-02-15T13:10:28Z	Waktu akhir data log yang direkam dalam file log biner. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
DownloadLink	String	http://rdsxxxxx.oss.aliyuncs.com/xxxxxx	URL tempat Anda dapat mengunduh file cadangan log melalui HTTP. Jika parameter ini diatur ke NULL, berarti tidak tersedia URL.
HostInstanceID	String	5841973	ID instans yang menghasilkan file cadangan log. Anda dapat menggunakan parameter ini untuk membedakan antara file cadangan log yang dihasilkan oleh instans primary dan file cadangan log yang dihasilkan oleh instans secondary dari instans primary tersebut.
LinkExpiredTime	String	2013-06-09T18:00:00Z	Waktu kedaluwarsa URL. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
Checksum	String	18358304393468701857	Checksum. Nilai parameter ini dihitung menggunakan algoritma CRC64.
IntranetDownloadLink	String	http://rdslog-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxxx	URL tempat Anda dapat mengunduh file cadangan log melalui jaringan internal.
LogFileName	String	000000040000000000000019	Nama file cadangan log.
RemoteStatus	String	Completed	Status file cadangan log di bucket object storage service (OSS) tempat file tersebut disimpan. Nilai valid: Uploading: File cadangan log sedang diunggah ke bucket OSS. Completed: File cadangan log telah diunggah ke bucket OSS.
RequestId	String	ED169A3E-1657-4104-82AB-24EA8CD0DB75	ID permintaan.
TotalFileSize	Long	2269410	Total ukuran file cadangan log yang dikembalikan.

Contoh

Contoh permintaan

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>

Contoh respons sukses

XML format

<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>

JSON format

{
    "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
            }
        ]
    }
}

Kode kesalahan

Kode status Http	Kode kesalahan	Pesan kesalahan	Deskripsi
400	ParameterLeastAssociate	Must input at least one optional parameter.	Pesan kesalahan yang dikembalikan karena parameter restoreTime dan parameter BackupId dari instans tidak boleh kosong secara bersamaan. Tentukan setidaknya salah satu parameter dan coba lagi.
404	InvalidDBInstance.NotFound	Specified instance does not exist or not support.	Pesan kesalahan yang dikembalikan karena instans tidak ditemukan, telah dihapus, atau tidak mendukung operasi ini.
400	ParameterAbsence	Necessary parameter is absence.	Pesan kesalahan yang dikembalikan karena parameter yang diperlukan tidak ditentukan.
403	IncorrectDBInstanceEngine	Current DB Instance engine does not support this operation.	Pesan kesalahan yang dikembalikan karena mesin database instans tidak mendukung operasi ini.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Pesan kesalahan yang dikembalikan karena status instans tidak mendukung operasi ini.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Pesan kesalahan yang dikembalikan karena instans terkunci.

Untuk daftar kode kesalahan, kunjungi API Error Center.