You need to enable JavaScript to run this app.
导航
DescribeBinlogFiles
最近更新时间:2024.05.10 10:39:25首次发布时间:2023.05.23 18:46:16

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

请求参数

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

返回参数

名称类型示例值描述
TotalInteger9备份文件个数。
ContextStringrds/mysql-603e30e6****/mysql-603e30e6****-0/binlog/binlog-1683547416864283247-binlog.000081索引信息。以最后一个备份文件作为索引进行返回。可作为下一次请求的参数,加载更多时选择。
BinlogFilesArray of BinlogFilesObject请参见返回示例备份列表。 更多关于 BinlogFiles 的详细信息,请参见数据结构

请求示例

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=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZjMzY/20211202/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645aff88

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

错误码

更多详情,请参见错误码