DescribeBinlogFiles--云数据库 MySQL 版-火山引擎

文档中心

立即注册

导航

DescribeBinlogFiles

最近更新时间：2024.11.05 16:00:07首次发布时间：2023.05.23 18:46:16

调用 DescribeBinlogFiles 接口查询 Binlog 备份文件。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-ce48081d****	实例 ID。
StartTime	String	是	2022-06-01T15:00:00Z	查询开始时间。格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。
EndTime	String	是	2022-06-20T15:00:00Z	查询结束时间。格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。查询结束时间应晚于查询开始时间，且时间范围不大于 15 天。
Context	String	是	rds/mysql-603e30e6bd95/mysql-603e30e6bd95-0/binlog/binlog-1683409831637741726-binlog.000041	索引信息，用于指定此次返回的备份信息的起始位置。指定后，会从 Context 指定的备份文件的下一个开始返回备份信息。
BackupFileNumber	Integer	否	10	备份文件数量，默认值为 10，最大值为 250。

返回参数

参数	类型	示例值	描述
Total	Integer	9	备份文件个数。
Context	String	rds/mysql-603e30e6**/mysql-603e30e6**-0/binlog/binlog-1683547416864283247-binlog.000081	索引信息。以最后一个备份文件作为索引进行返回。可作为下一次请求的参数，加载更多时选择。
BinlogFiles	Object[]	请参见返回示例。	备份列表。

示例

请求示例

POST /?Action=DescribeBinlogFiles&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "InstanceId": "mysql-603e30e6****",
    "StartTime": "2023-05-05T10:49:59Z",
    "EndTime": "2023-05-17T10:49:59Z",
    "BackupFileNumber": 5
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202305082058412F29109E3B606793D1F7",
        "Action": "DescribeBinlogFiles",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "BinlogFiles": [
            {
                "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683269409494461068-binlog.000001",
                "FileSize": 169,
                "NodeId": "mysql-f4091b4a****-mda8b-0",
                "UpdateTime": "2023-05-05T07:13:33.000Z"
            },
            {
                "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683269413387493959-binlog.000002",
                "FileSize": 3011622,
                "NodeId": "mysql-f4091b4a****-mda8b-0",
                "UpdateTime": "2023-05-05T07:13:33.000Z"
            },
            {
                "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683273026662514347-binlog.000003",
                "FileSize": 1123725,
                "NodeId": "mysql-f4091b4a****-seed3-0",
                "UpdateTime": "2023-05-05T07:50:28.000Z"
            },
            {
                "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683276626773091536-binlog.000004",
                "FileSize": 1140025,
                "NodeId": "mysql-f4091b4a****-seed3-0",
                "UpdateTime": "2023-05-05T08:50:29.000Z"
            },
            {
                "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683280226892626614-binlog.000005",
                "FileSize": 1140087,
                "NodeId": "mysql-f4091b4a****-mda8b-0",
                "UpdateTime": "2023-05-05T09:50:27.000Z"
            }
        ],
        "Context": "rds/mysql-f4091b4a****/mysql-f4091b4a****-0/binlog/binlog-1683280226892626614-binlog.000005",
        "Total": 5
    }
}

错误码

更多详情，请参见错误码。